Verbindung zu externen Bewertungsplattformen

Integration der externen Bewertungsplattform

Verbinden Sie Ihre bestehende Drittanbieter-Bewertungsplattform mit LoyaltyTree, um Bewertungen zu synchronisieren und automatisch Samen an Kunden zu vergeben.

Überblick

Wenn Sie bereits eine Bewertungsplattform wie Judge.me, Loox oder Yotpo verwenden, können Sie diese mit LoyaltyTree integrieren, anstatt zu unserem nativen Bewertungssystem zu wechseln. Dies ermöglicht Ihnen:

• Ihre bestehenden Bewertungen beizubehalten: Keine Notwendigkeit zur Migration oder einen Neuanfang
• Samen für Bewertungen zu vergeben: Kunden verdienen Treuebelohnungen, wenn sie Bewertungen abgeben
• Einheitliches Kundenerlebnis: Bewertungen tragen zu ihrer gesamten Treue-Reise bei
• Automatische Synchronisierung: Bewertungen fließen über Webhooks in LoyaltyTree ein

Schritt 1: Zugriff auf die Bewertungseinstellungen

1. Navigieren Sie zu Stores in Ihrem LoyaltyTree-Admin
2. Finden Sie Ihre Store-Karte und klicken Sie auf die Schaltfläche Bewertungseinstellungen 
3. Gehen Sie zum Tab Einstellungen

Schritt 2: Wählen Sie den externen Plattformmodus

In den Bewertungssystemeinstellungen:

1. Finden Sie das Dropdown Bewertungssystem
2. Ändern Sie es von "LoyaltyTree Native" zu Externe Plattform
3. Stellen Sie sicher, dass Bewertungssystem aktivieren angekreuzt ist

Schritt 3: Wählen Sie Ihre Bewertungsplattform

Wählen Sie Ihren Bewertungsanbieter aus dem Dropdown Bewertungsplattform:

Schritt 4: Aktivieren Sie die Webhook-Verarbeitung

Aktivieren Sie die Option Webhook-Verarbeitung aktivieren. Dadurch kann LoyaltyTree Bewertungsdaten von Ihrer externen Plattform empfangen und verarbeiten.

Schritt 5: Konfigurieren Sie die Webhook-URL

Sobald Sie eine Plattform ausgewählt haben, generiert LoyaltyTree eine eindeutige Webhook-URL für Ihren Store.

Kopieren Sie Ihre Webhook-URL:

1. Finden Sie das Feld Webhook-URL im Integrationspanel
2. Klicken Sie auf die Schaltfläche Kopieren, um die vollständige URL zu kopieren
3. Bewahren Sie diese URL sicher auf - sie ist einzigartig für Ihren Store

Fügen Sie den Webhook zu Ihrer Bewertungsplattform hinzu:

Die genauen Schritte variieren je nach Plattform, aber im Allgemeinen:

1. Gehen Sie zu den Admin-Einstellungen Ihrer Bewertungsplattform
2. Finden Sie den Abschnitt Webhooks oder Integrationen
3. Fügen Sie einen neuen Webhook mit der kopierten URL hinzu
4. Wählen Sie das Ereignis Bewertung erstellt oder Neue Bewertung
5. Speichern Sie Ihre Webhook-Konfiguration

Schritt 6: Webhook-Geheimnis (Optional)

Zur zusätzlichen Sicherheit können Sie ein Webhook-Geheimnis konfigurieren, um zu überprüfen, ob eingehende Webhooks authentisch sind.

So funktioniert es:

1. Geben Sie einen geheimen Schlüssel im Feld Webhook-Geheimnis ein
2. Konfigurieren Sie Ihre Bewertungsplattform so, dass sie Anfragen mit diesem Geheimnis signiert
3. LoyaltyTree überprüft die Signatur mit dem x-webhook-signature oder x-signature Header

Hinweis: Nicht alle Plattformen unterstützen Webhook-Signaturen. Wenn Ihre dies nicht tut, können Sie dieses Feld leer lassen.

Schritt 7: Generisch/Benutzerdefinierte Option - Erwartetes JSON-Format

Wenn Ihre Bewertungsplattform einen Webhook sendet, erwartet LoyaltyTree das folgende Datenformat:

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "Tolles Produkt!",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "Produktname"
}

Erforderliche Felder:

Unterstützung von verschachtelten Formaten:

LoyaltyTree unterstützt auch verschachtelte Datenformate, die häufig von Bewertungsplattformen verwendet werden:

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "Tolles Produkt!"
  }
}

Samenbelohnungen für externe Bewertungen

Hinweis: Die Samenzuteilungen für Bewertungen werden auf der Ebene der Treuegruppe verwaltet. Gehen Sie zu den Treueeinstellungen → Sameneinstellungen Ihres Stores, um zu konfigurieren, wie viele Samen Kunden für Bewertungen, Fotoboni und Boni für die erste Bewertung verdienen.

Wenn ein Bewertungs-Webhook empfangen wird:

1. LoyaltyTree vergleicht die customer_email mit einem bestehenden Kunden
2. Wenn gefunden, werden Samen basierend auf Ihrer Konfiguration der Sameneinstellungen vergeben
3. Foto-Bewertungen können zusätzliche Samen verdienen, wenn dies konfiguriert ist
4. Erstbewertende können zusätzliche Bonus-Samen verdienen

Fehlerbehebung

Bewertungen synchronisieren nicht?

• Überprüfen Sie die Webhook-URL: Stellen Sie sicher, dass Sie die vollständige URL einschließlich aller Abfrageparameter kopiert haben
• Überprüfen Sie, ob der Webhook aktiviert ist: Bestätigen Sie, dass "Webhook-Verarbeitung aktivieren" in LoyaltyTree angekreuzt ist
• Überprüfen Sie Ihre Bewertungsplattform: Stellen Sie sicher, dass der Webhook aktiv ist und auf die richtige URL verweist
• Testen Sie mit einer neuen Bewertung: Reichen Sie eine Testbewertung ein, um den Webhook auszulösen

Kunde erhält keine Samen?

• E-Mail muss übereinstimmen: Die customer_email im Webhook muss mit einem Kunden in Ihrer LoyaltyTree-Datenbank übereinstimmen
• Überprüfen Sie die Sameneinstellungen: Stellen Sie sicher, dass die Bewertungsbelohnungen in Ihrer Treuegruppe konfiguriert sind
• Kunde muss registriert sein: Anonyme oder Gastkunden erhalten möglicherweise keine Samenbelohnungen

Webhook-Signaturfehler?

• Geheimnis muss übereinstimmen: Das Geheimnis in LoyaltyTree muss genau mit dem in Ihrer Bewertungsplattform konfigurierten übereinstimmen
• Header-Format: LoyaltyTree sucht nach x-webhook-signature oder x-signature Headern

Brauchen Sie Hilfe?

Kontaktieren Sie unser Support-Team unter support@loyaltytree.eco für Unterstützung bei der Integration der externen Bewertungsplattform.