Auslösen von Kampagnen mit APIs trigger-campaigns
Über von einer API ausgelöste Kampagnen about
Mit Journey Optimizer können Sie Kampagnen erstellen und diese dann in einem externen System über eine Interactive Message Execution REST-API auslösen. Auf diese Weise können Sie diversen Bedarf an Marketing- und Transaktionsnachrichten abdecken, wie z. B. das Zurücksetzen von Passwörtern, OTP-Token usw.
Dazu müssen Sie zunächst in Journey Optimizer eine von einer API ausgelöste Kampagne erstellen und deren Ausführung dann über einen API-Aufruf starten.
Für von einer API ausgelöste Kampagnen stehen die Kanäle E-Mail, SMS und Push-Benachrichtigungen zur Verfügung.
➡️ Entdecken Sie diese Funktion im Video
Erstellen einer API-ausgelösten Kampagne create
Konfigurieren und Aktivieren der Kampagne create-activate
Um eine API-ausgelöste Kampagne zu erstellen, gehen Sie wie folgt vor. Detaillierte Informationen zum Erstellen einer Kampagne finden Sie in diesem Abschnitt.
-
Erstellen Sie eine neue Kampagne vom Typ API-ausgelöst.
-
Wählen Sie die Kategorie Marketing oder Transaktion je nach dem Typ der Kommunikation aus, die Sie versenden möchten.
-
Wählen Sie einen der unterstützten Kanäle und die zugehörige Kanalkonfiguration aus, die zum Senden Ihrer Nachricht verwendet werden soll, und klicken Sie auf Erstellen.
-
Geben Sie einen Titel und eine Beschreibung für die Kampagne an und klicken Sie dann auf Inhalt bearbeiten, um die zu sendende Nachricht zu konfigurieren.
note note NOTE Sie können an die API-Payload zusätzliche Daten zur Nachrichtenpersonalisierung übergeben. Weitere Informationen Die Verwendung einer großen Zahl oder umfangreicher kontextuelle Daten in Ihren Inhalten kann die Performance beeinträchtigen. -
Geben Sie im Abschnitt Zielgruppe den Namespace an, der zur Identifizierung der Kontakte verwendet werden soll.
-
Wenn Sie eine Kampagne des Typs Transaktion erstellen, müssen die Zielgruppenprofile im API-Aufruf definiert werden. Die Option Erstellen neuer Profile ermöglicht es Ihnen, automatisch Profile zu erstellen, die nicht in der Datenbank vorhanden sind. Erfahren Sie mehr über die Erstellung von Profilen bei der Kampagnenausführung
note note NOTE Ein einzelner API-Aufruf unterstützt bis zu 20 eindeutige Empfängerinnen und Empfänger. Jede Empfängerin und jeder Empfänger muss über eine eindeutige Benutzer-ID verfügen. Doppelte Benutzer-IDs sind nicht zulässig. Weitere Informationen finden Sie in der Dokumentation zur API für die Ausführung interaktiver Nachrichten. -
Klicken Sie bei Kampagnen des Typs Marketing auf die Schaltfläche Zielgruppe, um die Zielgruppe auszuwählen, die angesprochen werden soll.
-
-
Konfigurieren Sie das Start- und Enddatum der Kampagne.
Wenn Sie ein bestimmtes Start- und/oder Enddatum für eine Kampagne konfigurieren, wird diese nicht außerhalb dieses Zeitraums ausgeführt und API-Aufrufe schlagen fehl, wenn eine Kampagne durch APIs ausgelöst wird.
-
Klicken Sie auf Zum Aktivieren überprüfen, um sicherzustellen, dass Ihre Kampagne korrekt konfiguriert ist, und aktivieren Sie sie.
Sie können die Kampagne jetzt über die APIs ausführen. Weitere Informationen
Ausführen der Kampagne execute
Nachdem Ihre Kampagne aktiviert wurde, müssen Sie die generierte Beispiel-cURL-Anfrage abrufen und in der API verwenden, um Ihre Payload zu erstellen und die Kampagne auszulösen.
-
Öffnen Sie die Kampagne, kopieren Sie dann die Payload-Anfrage aus dem Abschnitt cURL-Anfrage und fügen Sie diese ein. Diese Payload enthält nun alle Personalisierungsvariablen (Profil und Kontext), die in der Nachricht verwendet werden. Sie ist verfügbar, sobald die Kampagne aktiv ist.
-
Verwenden Sie diese cURL-Anfrage in den APIs, um Ihre Payload zu erstellen und die Kampagne auszulösen. Weitere Informationen finden Sie in der Dokumentation zur API für die Ausführung interaktiver Nachrichten.
Beispiele für API-Aufrufe finden Sie auch auf dieser Seite.
note note NOTE Beachten Sie, dass, wenn Sie bei der Erstellung der Kampagne ein bestimmtes Start- und/oder Enddatum konfiguriert haben, die Kampagne außerhalb dieses Zeitraums nicht ausgeführt wird und API-Aufrufe fehlschlagen.
Verwenden von kontextuellen Attributen in von einer API ausgelösten Kampagnen contextual
Bei von einer API ausgelösten Kampagnen können Sie zusätzliche Daten in die API-Payload übertragen und innerhalb der Kampagne nutzen, um Ihre Nachricht zu personalisieren.
In diesem Beispiel möchten Kunden ihr Kennwort zurücksetzen. Sie senden ihnen deshalb zum Zurücksetzen des Kennworts eine URL, die in einem Drittanbieter-Tool generiert wird. Bei von einer API ausgelösten Kampagnen können Sie diese generierte URL in die API-Payload übergeben und in der Kampagne in die Nachricht einfügen.
Um diese Daten in Ihren Kampagnen verwenden zu können, müssen Sie sie an die API-Payload übergeben und mithilfe des Personalisierungseditors zu Ihrer Nachricht hinzufügen. Verwenden Sie dazu die Syntax {{context.<contextualAttribute>}}, wobei <contextualAttribute> mit dem Namen der Variablen in Ihrer API-Payload, die die zu übergebenden Daten enthält, übereinstimmen muss.
Die Syntax {{context.<contextualAttribute>}} ist nur einem Zeichenfolgen-Datentyp zugeordnet.
context.system ist auf die interne Nutzung bei Adobe beschränkt und sollte nicht zur Weitergabe von kontextuellen Attributen verwendet werden.Beachten Sie, dass im Menü in der linken Leiste derzeit kein kontextuelles Attribut verfügbar ist. Attribute müssen direkt in Ihren Personalisierungsausdruck eingegeben werden, ohne dass eine Überprüfung durch Journey Optimizer durchgeführt wird.
Profilerstellung bei der Kampagnenausführung profile-creation
In einigen Fällen müssen Sie möglicherweise Transaktionsnachrichten an Profile senden, die nicht im System sind. Wenn zum Beispiel ein unbekannter Benutzer versucht, sein Kennwort auf Ihrer Website zurückzusetzen.
Wenn ein Profil nicht in der Datenbank vorhanden ist, erlaubt Journey Optimizer Ihnen, es automatisch bei der Ausführung der Kampagne zu erstellen, um das Senden der Nachricht an dieses Profil zu ermöglichen.
Um die Profilerstellung bei der Kampagnenausführung zu aktivieren, schalten Sie die Option Neue Profile erstellen im Abschnitt Zielgruppe ein. Wenn diese Option deaktiviert ist, werden unbekannte Profile für jeden Versand zurückgewiesen und der API-Aufruf schlägt fehl.
Anleitungsvideo video
Erfahren Sie, wie Sie eine Kampagne erstellen und sie von einem externen System aus basierend auf Benutzerinteraktionen auslösen, indem Sie die REST-API zur Ausführung interaktiver Nachrichten verwenden.