API-basierter Einstieg
Der API-basierte Einstieg ermöglicht es Ihnen, eine Customer Journey in dem Moment zu starten, in dem ein bestimmtes Geschäftsereignis eintritt. Um eine Kampagne zu starten, müssen Sie eine spezielle API-Anfrage senden.
Hier sind einige Anwendungsfälle für einen API-basierten Einstieg:
- Kunden informieren, wenn Produkte wieder auf Lager sind
- Benutzer benachrichtigen, wenn der Preis eines beliebten Produkts gesunken ist
- Abonnenten benachrichtigen, wenn eine neue Podcast-Folge veröffentlicht wird
Im Gegensatz zu regulären Events können all diese Geschäftsereignisse außerhalb der App stattfinden. Zum Beispiel kann die Verfügbarkeit eines Produkts nur in einer externen Datenbank überprüft werden. Hier ist ein API-basierter Einstieg nützlich: Sie können das Senden einer Anfrage zum Starten einer Journey einrichten, wann immer bestimmte Änderungen außerhalb der App (zum Beispiel in Ihrer externen Datenbank) auftreten.
Es funktioniert wie folgt:
- Erstellen Sie eine Journey mit einem API-basierten Einstieg. In den Einstiegseinstellungen finden Sie die Vorlage der Anfrage, die die Journey startet.
- Fügen Sie Segmentierungsbedingungen zur Anfrage hinzu, indem Sie die Segmentierungssprache verwenden. Sie können auch Inhaltsplatzhalter zur Anfrage hinzufügen, um den Nachrichteninhalt je nach Kontext zu ändern.
- Automatisieren Sie die Anfrage bei Bedarf. Zum Beispiel können Informationen über eine Preisänderung sofort von der Datenbank an den Webhook gesendet werden. Sobald dies geschieht, sollte der Webhook automatisch die Anfrage zum Starten der Journey senden. Sie können die Anfrage auch manuell senden, wenn Sie keine Automatisierung benötigen.
Sie können die Anfrage unbegrenzt oft senden, um Segmentierungsbedingungen oder den Nachrichteninhalt zu ändern.
Für weitere Details folgen Sie den nachstehenden Anweisungen.
Eine Journey mit API-basiertem Einstieg einrichten
Anchor link to- Erstellen Sie eine Journey mit einem API-basierten Einstieg:
-
Doppelklicken Sie auf den Schritt für den API-basierten Einstieg. Das Konfigurationsfenster für den Einstieg wird geöffnet.
-
Sie können den Inhalt von Push-Benachrichtigungen und E-Mails bei jedem Start der Journey mithilfe von Inhaltsplatzhaltern ändern. Der Wert jedes Platzhalters kann in der Anfrage geändert werden. Wenn Sie diese Option nicht benötigen, können Sie diesen Schritt überspringen.
Zum Beispiel erstellen Sie eine Journey, um Abonnenten zu benachrichtigen, wenn eine neue Podcast-Folge veröffentlicht wird. Mit einem Inhaltsplatzhalter können Sie den Podcast-Titel bei jedem Start der Journey ändern.
Fügen Sie zuerst Platzhalternamen im Einrichtungsfenster für den API-basierten Einstieg hinzu. Sie können beliebige Namen verwenden, die für Sie praktisch sind.
Erstellen Sie nun ein Push-Preset oder einen E-Mail-Inhalt und fügen Sie den Platzhalter anstelle des Textes ein, den Sie ändern möchten. Der Platzhalter muss je nach Bedarf in einem der folgenden Formate vorliegen:
{placeholder_name|format_modifier|}– wenn der Platzhalterwert beim Start der Kampagne nicht angegeben wird, sehen die Benutzer an seiner Stelle einen leeren Bereich.{placeholder_name|format_modifier}– wenn der Platzhalterwert nicht angegeben wird und einem Benutzer noch nicht zugewiesen wurde (falls Sie ein Tag als Platzhalter verwendet haben), wird die Nachricht nicht gesendet.
Formatmodifikatoren
- CapitalizeFirst – schreibt den ersten Buchstaben eines Platzhalterwerts groß
- CapitalizeAllFirst – schreibt die ersten Buchstaben aller Wörter in einem Platzhalterwert groß
- UPPERCASE – wandelt alle Buchstaben in Großbuchstaben um
- lowercase – wandelt alle Buchstaben in Kleinbuchstaben um
- regular – fügt einen Platzhalterwert genau wie in der Anfrage angegeben ein
Wenn Sie das Push- oder E-Mail-Element in Ihrer Journey konfigurieren, wählen Sie das erstellte Preset aus und aktivieren Sie die Option Nachricht mit Event-Attributen personalisieren.
Wählen Sie die Platzhalter aus, die Sie in der Anfrage beim Start der Journey ändern möchten. Wählen Sie den API-basierten Einstieg als Quelle und den Platzhalternamen als dynamisches Attribut:
Klicken Sie auf Anwenden, um die Änderungen zu speichern.
- Kopieren Sie im Konfigurationsfenster für den Einstieg die Anfragevorlage, um sie zu ändern:
- Fügen Sie Zielgruppenfilter zum Parameter
"filter"hinzu, indem Sie die Segmentierungssprache verwenden oder die Segmentierungslogik aus Ihren Segmenten kopieren. Richten Sie die erforderlichen Tags im Voraus ein.
Um beispielsweise Benutzer anzusprechen, die den Artikel Socken zu ihrer Wunschliste hinzugefügt haben, muss der Wert von "filter" wie folgt aussehen:
"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"
In diesem Beispiel müssen Sie ein Wunschliste-Tag in Ihrer App konfiguriert haben.
- Wenn Sie Platzhalter eingerichtet haben, geben Sie den gewünschten Inhalt als deren Werte an:
- Wenn Sie planen, Ihre Kampagne häufig neu zu starten und nicht möchten, dass dieselben Benutzer mehrmals in die Journey eintreten, setzen Sie Eintrittslimits für die Kampagne.
Zum Beispiel haben Sie eine Kampagne erstellt, um Benutzer über eine Preissenkung für ein bestimmtes Produkt zu informieren. Sie möchten die Journey einige Male neu starten, indem Sie mehrere Anfragen mit unterschiedlichen Zielgruppenfiltern senden. In diesem Fall können Sie Eintrittslimits für die Kampagne hinzufügen, damit die Benachrichtigung nicht wiederholt an Benutzer gesendet wird, die auf mehrere Filter passen.
- Wenn Sie möchten, dass eine Journey startet, wann immer ein bestimmtes Geschäftsereignis eintritt, automatisieren Sie die Anfrage mithilfe des Webhooks. Sobald das Ereignis eintritt, sollte der Webhook automatisch die Anfrage zum Starten der Journey senden.
Sie können die Anfrage auch manuell senden, wenn Sie keine Automatisierung benötigen.