Outbound-Integrationen

🔗 Ausgehende Integrationen

Verbinden Sie Ihre LoyaltyTree-Ereignisse mit externen Marketing-, Automatisierungs- und Analyseplattformen. Senden Sie Echtzeitdaten über Kundenaktivitäten, um E-Mail-Kampagnen, Kundensegmente, Automatisierungen und mehr zu steuern.

---

Unterstützte Plattformen

LoyaltyTree unterstützt das Senden von Ereignissen an die folgenden Plattformen:

Plattform	Typ	Was Sie benötigen
Klaviyo	E-Mail/SMS-Marketing	Ihr Klaviyo Private API Key
Omnisend	E-Mail/SMS-Marketing	Ihr Omnisend API Key
Shopify Flow	Shopify-Automatisierung	Ein Flow-Trigger-Handle (erstellt in Shopify Flow)
Allgemeiner Webhook	Jeder HTTP-Endpunkt	Eine Webhook-URL, die POST-Anfragen akzeptiert

---

Erste Schritte

---

Unterstützte Ereignisse (insgesamt 19)

Sie können jede Integration für jede Kombination dieser Ereignisse abonnieren. Nur die Ereignisse, die Sie auswählen, werden an diese Plattform gesendet.

🌱 Verdiente Samenereignisse

Wird ausgelöst, wenn ein Kunde durch verschiedene Aktivitäten Samen verdient.

Ereignis	Ereignisschlüssel	Ausgelöst, wenn
Samen – Verdient – Bestellung	seeds.earned.order	Kunde verdient Samen durch einen Kauf
Samen – Verdient – Besuch	seeds.earned.visit	Kunde verdient Samen durch den Besuch des Geschäfts
Samen – Verdient – Bewertung	seeds.earned.review	Kunde verdient Samen durch das Schreiben einer Bewertung
Samen – Verdient – Empfehlung	seeds.earned.referral	Kunde verdient Samen durch eine erfolgreiche Empfehlung
Samen – Verdient – Soziale Teilung	seeds.earned.social_share	Kunde verdient Samen durch das Teilen in sozialen Medien
Samen – Verdient – Bonus	seeds.earned.bonus	Kunde erhält Bonus-Samen (Geburtstag, manuelle Vergabe usw.)

⭐ Tier- & Bewertungsereignisse

Ereignis	Ereignisschlüssel	Ausgelöst, wenn
Tier – Geändert	tier.changed	Kunde wechselt zu einem anderen Treue-Tier
Bewertung – Eingereicht	review.submitted	Kunde reicht eine neue Produktbewertung ein
Bewertung – Genehmigt	review.approved	Eine Produktbewertung wird genehmigt (durch KI oder manuell)
Bewertung – Abgelehnt	review.rejected	Eine Produktbewertung wird abgelehnt

🎁 Belohnungsereignisse

Ereignis	Ereignisschlüssel	Ausgelöst, wenn
Geschenkkarte – Verdient	gift_card.earned	Kunde qualifiziert sich für eine Geschenkkartenbelohnung
Geschenkkarte – Eingelöst	gift_card.claimed	Kunde löst seine Geschenkkarte ein
Store Credit – Verdient	store_credit.earned	Kunde qualifiziert sich für Store Credit
Store Credit – Eingelöst	store_credit.claimed	Kunde löst sein Store Credit ein

🌳 Öko- & Empfehlungsereignisse

Ereignis	Ereignisschlüssel	Ausgelöst, wenn
Öko-Produkt – Verliehen	eco_product.awarded	Kunde löst Samen für ein Öko-Produkt ein
Öko- – Baum gepflanzt	eco.tree_planted	Ein Baum wird für den Kunden gepflanzt
Empfehlung – Generiert	referral.generated	Kunde generiert einen Empfehlungslink
Empfehlung – Besuch	referral.visit	Jemand besucht das Geschäft über einen Empfehlungslink
Empfehlung – Erfolgreich	referral.successful	Ein empfohlener Besucher tätigt einen Kauf

---

Plattform-Einrichtungsanleitungen

📧 Klaviyo

Klaviyo ist eine E-Mail- und SMS-Marketingplattform, die bei Shopify-Geschäften beliebt ist. LoyaltyTree sendet Ereignisse an Klaviyo über deren Events API (v3), sodass Sie Segmente, Flows und Kampagnen basierend auf Treueaktivitäten erstellen können.

Wie es funktioniert: LoyaltyTree erstellt Klaviyo-Ereignisse mit der E-Mail des Kunden als Profilidentifikator. Ereignisse erscheinen als benutzerdefinierte Metriken (z. B. "Verdiente Samenbestellung", "Tier geändert"), die Sie in Klaviyo-Flows und -Segmenten verwenden können. Die Samenbeträge werden als Ereigniswert gesendet, sodass Sie sie in bedingten Splits verwenden können.

📨 Omnisend

Omnisend ist eine weitere beliebte E-Mail- und SMS-Marketingplattform. LoyaltyTree sendet Ereignisse über die Omnisend Events API (v5).

Wie es funktioniert: Ereignisse werden mit der E-Mail, dem Namen und der Shopify-Kunden-ID des Kunden gesendet. Jedes Ereignis enthält alle relevanten Eigenschaften (Samenbeträge, Bestelldetails, Tierinformationen usw.), sodass Sie sie in Omnisend-Automatisierungs-Workflows und Segmentierungen verwenden können.

⚡ Shopify Flow

Shopify Flow ist das integrierte Automatisierungstool von Shopify. LoyaltyTree sendet Ereignisse direkt an Shopify Flow über die GraphQL flowTriggerReceive-Mutation, was bedeutet, dass Ereignisse als Trigger innerhalb Ihrer Flow-Workflows erscheinen – keine Drittanbieter-Apps erforderlich.

Wie es funktioniert: Wenn ein abonniertes Ereignis auftritt, verwendet LoyaltyTree die Shopify-API-Verbindung Ihres Geschäfts, um die Ereignisdaten direkt über GraphQL an Shopify Flow zu senden. Die Nutzlast wird in menschenlesbare Schlüssel wie "Kunden-E-Mail", "Ereignistyp", "Betrag" usw. umgewandelt. Sie können diese Werte dann als Bedingungen in Ihrem Flow verwenden, um Aktionen wie das Senden von E-Mails, das Taggen von Kunden oder das Erstellen von Aufgaben auszulösen.

Beispiel für Shopify Flow-Automatisierungen:

• Kunden taggen, wenn sie das Gold-Tier erreichen
• Eine interne Slack-Benachrichtigung senden, wenn ein Baum gepflanzt wird
• Eine Aufgabe erstellen, wenn eine Bewertung eingereicht wird
• Eine Notiz im Kundenprofil hinzufügen, wenn sie eine Geschenkkarte verdienen

 

🌐 Allgemeiner Webhook

Senden Sie LoyaltyTree-Ereignisse an jeden HTTP-Endpunkt. Dies ist perfekt, um sich mit benutzerdefinierten Systemen, Zapier, Make (Integromat), n8n oder jeder anderen Plattform zu verbinden, die Webhook-POSTs akzeptiert.

Authentifizierungsoptionen:

Methode	Header gesendet	Beschreibung
HMAC-Signatur	X-LoyaltyTree-Signature	SHA-256 HMAC des Payloads, signiert mit Ihrem Webhook-Geheimnis
Bearer-Token	Authorization: Bearer <token>	Standard-OAuth-ähnliche Bearer-Token-Authentifizierung
X-Token	X-Token: <token>	Einfaches Token in einem benutzerdefinierten Header
Benutzerdefinierter Header	<your-header>: <token>	Geben Sie Ihren eigenen Header-Namen und Token-Wert an

Benutzerdefinierte Payload-Vorlagen: Für allgemeine Webhooks können Sie das Payload-Format für jedes Ereignis mit Template-Variablen anpassen. Dies ermöglicht es Ihnen, das genaue Format zu erreichen, das Ihr empfangendes System erwartet.

Standard-Header, die mit jeder Anfrage gesendet werden:

• Content-Type: application/json
• User-Agent: LoyaltyTree/1.0
• X-LoyaltyTree-Event: <event_type>
• X-LoyaltyTree-Timestamp: <ISO timestamp>

---

Beispiel-Webhooks-Payload

So sieht ein typisches seeds.earned.order-Ereignis aus, wenn es an einen allgemeinen Webhook geliefert wird:

{
  "event": "seeds.earned.order",
  "timestamp": "2026-02-06T14:30:00.000Z",
  "customer": {
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "display_name": "Jane Smith",
    "shopify_customer_id": "7891234567890"
  },
  "amount": 50,
  "order_id": "6012345678901",
  "order_number": "1042",
  "order_total": "89.99",
  "order_currency": "USD",
  "balance": 350,
  "tier": "Silver"
}

Jede Ereignis-Payload enthält das Kunden-Objekt mit ihrer E-Mail, ihrem Namen und ihrer Shopify-Kunden-ID sowie ereignisspezifischen Datenfeldern.

---

Ereignisdatenreferenz

Nachfolgend finden Sie eine detaillierte Liste der Datenfelder, die mit jedem Ereignistyp enthalten sind.

---

Zuverlässigkeit & Wiederholungslogik

LoyaltyTree verwendet eine asynchrone Warteschlange, um eine zuverlässige Ereignislieferung sicherzustellen. Ereignisse gehen niemals verloren – wenn die Lieferung fehlschlägt, versucht das System automatisch mit exponentiellem Backoff erneut.

Wiederholungsversuch	Wartezeit
1. Wiederholung	1 Minute
2. Wiederholung	5 Minuten
3. Wiederholung	30 Minuten
4. Wiederholung	2 Stunden
5. Wiederholung (final)	24 Stunden

Nachdem alle Wiederholungen erschöpft sind, wird das Ereignis als "erschöpft" markiert und erscheint in Ihren Ereignisprotokollen mit einer Wiederholen-Schaltfläche, sodass Sie es jederzeit manuell erneut versuchen können.

Ereignisprotokolle

Jede Ereignislieferung wird protokolliert und ist im Abschnitt Ereignisprotokolle auf der Integrationsseite sichtbar. Sie können Protokolle filtern nach:

• Verbindung – Ereignisse für eine bestimmte Integration anzeigen
• Ereignis – Nach Ereignistyp filtern
• Kunde – Nach Kunden-E-Mail oder -Namen suchen
• Datumsbereich – Ereignisse aus einem bestimmten Zeitraum anzeigen

Jeder Protok Eintrag zeigt die Uhrzeit, Plattform, Ereignistyp, Status und etwaige Fehlermeldungen an. Fehlgeschlagene Ereignisse enthalten eine Wiederholen-Schaltfläche, um sie sofort erneut in die Warteschlange zu stellen.

 

---

Fehlerbehebung

---

Sicherheit

• Alle API-Schlüssel und Tokens sind verschlüsselt im Ruhezustand mit AES-256-CBC-Verschlüsselung
• Webhook-Geheimnisse ermöglichen die HMAC-Signaturüberprüfung, sodass Ihr Endpunkt überprüfen kann, ob die Anfragen tatsächlich von LoyaltyTree stammen
• Ereignisse werden über eine asynchrone Warteschlange verarbeitet – die Leistung Ihres Geschäfts wird niemals durch die Integrationslieferung beeinträchtigt
• Ältere gelieferte Ereignisse und Protokolle werden automatisch nach 30 Tagen bereinigt