Die verschiedenen in Klaviyo verfügbaren Webhooks verstehen
Übersicht
Erfahre mehr über die Unterschiede zwischen den in Klaviyo verfügbaren Webhook-Lösungen und wann du welche verwenden solltest.
Bevor du anfängst
Um Webhooks in Advanced Klaviyo Data Platform oder Code zu verwenden, benötigt dein Konto Zugriff auf Advanced Klaviyo Data Platform. Advanced Klaviyo Data Platform ist von Klaviyos Standard-Marketinganwendung getrennt. Sieh dir unsere Abrechnungsanleitung an, um zu erfahren, wie du diesen Tarif hinzufügst.
Was sind Webhooks?
Webhooks ermöglichen es Klaviyo, Informationen weiterzugeben oder andere Anwendungen, Tools und Server über HTTP-Anfragen „aufzurufen“. Sie können Informationen zu einem Ereignis senden, das stattgefunden hat (z. B. eine aufgegebene Bestellung, ein*e neue*r Kund*in, die*der abonniert hat usw.), oder deine externen Systeme darüber benachrichtigen, dass das Ereignis eingetreten ist.
Webhooks bestehen aus einigen wichtigen Komponenten:
- Thema
Das Ereignis, das dazu führt, dass ein Webhook ausgelöst wird. - Textkörper (oder „die Payload“)
Die Daten, die der Webhook sendet. - Header
Ein Ort, um zusätzliche Informationen (z. B. zur Authentifizierung) zu übergeben. - Ziel-URL
Der Endpunkt, der die Webhook-Anfrage empfängt.
Flow-Webhooks
Du kannst Webhooks in Flows als Aktion hinzufügen. Wenn ein Profil eine konfigurierte Webhook-Aktion erreicht, die auf Live gesetzt ist, sendet Klaviyo eine POST-Anfrage an deine Ziel-URL mit den Daten, die du in die Payload aufnimmst. Dazu können Profildetails gehören und, in einem durch eine Metrik ausgelösten Flow, Daten aus dem Ereignis, das den Flow ausgelöst hat.
Du kannst Flow-Webhooks zu Flows hinzufügen, die durch eine Metrik, eine Liste, ein Segment oder eine Datumseigenschaft ausgelöst werden. Nachrichtenbezogene Ereignisse wie E-Mail empfangen, Auf E-Mail geklickt oder E-Mail als Spam markiert können nicht als Flow-Trigger verwendet werden.
Abmelden von E-Mail-Marketing kann einen Flow und seine Webhook-Aktion auslösen. Dieses Ereignis erfasst einen Verlust der Einwilligung in E-Mail-Marketing und ist getrennt von einem Klick auf einen E-Mail-Abmeldelink.
Beispiel-Anwendungsfälle für Flow-Webhooks
Einige Beispiel-Anwendungsfälle, in denen Flow-Webhooks am effektivsten wären, sind:
- Sende eine Nachricht oder eine POST-Anfrage, die ausgelöst wird, wenn ein*e Abonnent*in zu einem Segment oder einer Liste hinzugefügt wird.
- Unterdrückungen automatisieren, wenn ein Profil ein Segment ohne Engagement betritt.
- Sende eine personalisierte Dankesnachricht über einen Dienst wie WhatsApp oder Facebook Messenger, wenn Kund*innen etwas kaufen.
Webhooks in der Advanced Klaviyo Data Platform
Du benötigst Zugriff auf Advanced Klaviyo Data Platform, um diese Webhooks zu verwenden. Sieh dir unseren Abrechnungsleitfaden an, um zu erfahren, wie du dieses Abo hinzufügen kannst, oder um als Neukund*in zu starten.
Webhook in Advanced Klaviyo Data Platform benachrichtigen externe Systeme als Reaktion auf Ereignisse, unabhängig von Flow-Schritten. Klaviyo erstellt den Request-Body für dich. Verwende diese Webhook, wenn du eine vorgefertigte Event-Payload an ein externes System senden möchtest. Dieses System muss über einen Endpunkt verfügen, der die Requests empfangen und verarbeiten kann.
Advanced Klaviyo Data Platform-Webhooks unterstützen eine größere Bandbreite an Themen als Flow-Webhooks, einschließlich nachrichtenbezogener Ereignisse, die über die API „Ereignisse abrufen“ verfügbar sind. Wähle beim Konfigurieren deines Webhooks einzelne Metriken als Themen aus.
Hier einige Beispiele:
- E-Mail-Ereignisse (z. B. E-Mail erhalten, auf E-Mail geklickt, E-Mail als Spam markiert)
- SMS-Ereignisse (z. B. SMS gesendet, SMS empfangen)
- Push-Benachrichtigungsereignisse (z. B. Push erhalten, Push zurückgewiesen)
- Ereignisse aus Integrationen (d. h. Ereignisse aus Erstanbieter-Integrationen, die von Klaviyo erstellt wurden)
- API-Events (z. B. Events, die über Klaviyo’s APIs synchronisiert werden)
Dazu gehören nachrichtenbezogene Events wie das ältere Unsubscribed -Event (ein E-Mail-Abmeldelink-Klick), E-Mail erhalten oder E-Mail geklickt, die nicht als Flow-Trigger verwendet werden können. „Unsubscribed from Email Marketing“ ist ein separates Event, das einen Flow auslösen kann.
Außerdem kannst du mit Advanced Klaviyo Data Platform-Webhooks mehrere Trigger gleichzeitig abonnieren – im Gegensatz zu Flow-Webhooks, die von Flows mit einem einzelnen Trigger abhängen.
Ziel-URLs für Webhooks der Advanced Klaviyo Data Platform müssen öffentlich zugängliche HTTPS-Endpunkte sein, die Klaviyos Webhook-Anfragen empfangen können.
Beispielanwendungsfälle für Webhooks der Advanced Klaviyo Data Platform
- Synchronisiere Kund*innenereignisse vom Typ Vom E-Mail-Marketing abmelden mit externen Systemen.
- Melde Empfangene E-Mail -Ereignisse an Helpdesk-Software, damit Agent*innen den E-Mail-Verlauf sehen und Kund*innen besser betreuen können.
- Synchronisiere alle E-Mail-Sendungen, Öffnungen und Klicks in ein Data Warehouse, das nicht von der Data-Warehouse-Synchronisierung von Klaviyo unterstützt wird.
Code
Code ist in Advanced Klaviyo Data Platform enthalten. Dein Konto benötigt Zugriff auf Advanced Klaviyo Data Platform, um diese ereignisgesteuerten Funktionen zu verwenden. In unserem Abrechnungsleitfaden erfährst du, wie du dieses Abonnement hinzufügst, oder wie du als Neukund*in loslegst.
Code verwendet Webhooks, um benutzerdefinierte Funktionen als Reaktion auf einen Ereignisauslöser auszuführen. Du kannst Python oder JavaScript direkt im Editor von Klaviyo schreiben, und Klaviyo übernimmt die Codeausführung, die Überwachung und die Protokollierung.
Verwende Code, wenn du über die Entwicklungsressourcen verfügst, um benutzerdefinierte Funktionen zu schreiben, die als Reaktion auf Ereignisse ausgeführt werden. Klaviyo hostet die Funktionen, sodass du keinen eigenen Endpunkt hosten musst, um den auslösenden Webhook zu empfangen. Um Daten an ein anderes System zu senden, muss dein Code eine Verbindung zur API oder zum Dienst dieses Systems herstellen.
Sowohl Code- als auch Advanced Klaviyo Data Platform-Webhook ermöglichen es dir, einzelne Metriken als Trigger auszuwählen.
Beachte, dass Code die folgenden Ereignisse nicht als Themen unterstützt:
- E-Mail geöffnet
- E-Mail erhalten
Beispiel-Anwendungsfälle für Code
- Verwende Python-Bibliotheken, um Ereignisdaten zu lesen und Werte wie eine Buchungsstadt zu extrahieren, damit du sie in benutzerdefinierter Logik verwenden kannst.
- Lege benutzerdefinierte Profileigenschaften basierend auf Ereignis-Metadaten fest – mit Klaviyos APIs.
- Rufe einen KI-Service auf, um für jeden Warenkorbabbruch basierend auf dem Profil und den Artikeln im Warenkorb eine benutzerdefinierte Nachricht zu erstellen.
Weitere Ressourcen
- Webhooks in Flows verstehen
Erfahre mehr über Webhooks in Flows und darüber, wie sie Informationen von Klaviyo an deine Drittanbieter-Tools und -Anwendungen senden. Wichtig ist, dass das Einrichten von Webhooks komplex sein kann. Es ist ratsam, über Entwicklungskenntnisse oder Entwicklungsressourcen zu verfügen, um dieses Setup korrekt abzuschließen. Wenn du diese Entwicklungsanleitungen suchst, erfahre, wie du eine Webhook-Aktion zu einem Flow hinzufügst.
- Webhooks in der Advanced Klaviyo Data Platform verstehen
Erfahre mehr über Webhooks und wie du sie nutzen kannst, um als Reaktion auf in Klaviyo erfasste Ereignisse Informationen an deine Drittanbieter-Apps zu senden. Wenn du detailliertere Informationen dazu brauchst, wie du System-Webhook empfängst, sieh dir unsere Developer-Ressource zum Arbeiten mit System-Webhooks an.
- Erste Schritte mit Code
Erfahre mehr über Code und wie du benutzerdefinierte Funktionen erstellst, die direkt von Klaviyo ausgeführt werden.