Auf dieser Seite: Erfahren Sie, wie Admins externe Integrationen konfigurieren, testen und aktivieren, die Adobe Journey Optimizer mit APIs von Drittanbietern verbinden, um personalisierte, dynamische Inhalte in ausgehenden Kanälen bereitzustellen.
Überblick
Die Funktion Integrationen verknüpft Adobe Journey Optimizer mit Systemen von Drittanbietern, deren Daten und zusammenstellbare Inhalte Sie bereits an anderer Stelle verwalten. Sie können dieses Material während des Authorings und zur Versandzeit einbinden. Dies unterstützt responsivere, personalisierte Erlebnisse über alle in Journey Optimizer verwendeten Kanäle hinweg.
Sie können diese Funktion verwenden, um externe Daten und Inhalte aus Drittanbieter-Tools abzurufen, z. B.:
- Prämienpunkte aus Treueprogrammsystemen.
- Preisinformationen für Produkte.
- Produktempfehlungen aus Empfehlungs-Engines.
- Logistische Updates wie Versandstatus.
Um Integrationen verwenden zu können, müssen Benutzenden die Berechtigungen AJO-Integrationskonfiguration verwalten und AJO-Integrationskonfiguration anzeigen erteilt werden. Weitere Informationen zu Berechtigungen
-
Gehen Sie im Produkt Berechtigungen zur Registerkarte Rollen und wählen Sie die gewünschte Rolle aus.
-
Klicken Sie auf Bearbeiten, um die Berechtigungen zu ändern.
-
Fügen Sie die Ressource AJO-Integrationskonfiguration hinzu und wählen Sie dann aus dem Dropdown-Menü die entsprechenden Integrationsberechtigungen aus.
-
Klicken Sie auf Speichern, um die Änderungen anzuwenden.
Die Berechtigungen aller Benutzenden, die dieser Rolle bereits zugewiesen sind, werden automatisch aktualisiert.
-
Um diese Rolle neuen Benutzenden zuzuweisen, navigieren Sie im Dashboard Rollen zur Registerkarte Benutzer und klicken Sie auf Benutzer hinzufügen.
-
Geben Sie den Namen und die E-Mail-Adresse der Benutzerin oder des Benutzers ein oder wählen Sie aus der Liste aus und klicken Sie dann auf Speichern.
Wenn die Benutzerin bzw. der Benutzer vorher noch nicht erstellt wurde, lesen Sie diese Dokumentation.
Konfigurieren Ihrer Integration configure
Als Admin können Sie externe Integrationen einrichten, indem Sie die folgenden Schritte ausführen:
-
Navigieren Sie im linken Menü zum Abschnitt Konfigurationen und klicken Sie auf der Karte Integrationen auf Verwalten.
Klicken Sie dann auf Integration erstellen, um eine neue Konfiguration zu starten.
-
Fügen Sie optional einen cURL-Befehl ein, um die URL, die HTTP-Methode, die Kopfzeilen und die Abfrageparameter automatisch auszufüllen.
-
Es müssen ein Name und eine Beschreibung für die Integration angegeben werden.
note NOTE Das Feld Name darf keine Leerzeichen enthalten. -
Geben Sie die URL des API-Endpunkts ein.
Umschließen Sie Label für Pfadvariablen in der URL mit doppelten geschweiften Klammern (z. B.
https://api.example.com/v1/products/{{productId}}) und legen Sie dann jeden Platzhalter unter Pfadvorlage fest. -
Konfigurieren Sie die Pfadvorlage mit Name und Standardwert für jeden Platzhalter, den Sie in der URL hinzugefügt haben.
Beachten Sie, dass der Name nur ein Marketing-Label im Editor ist, das nicht mit der API-Anfrage gesendet wird.
-
Wählen Sie die HTTP-Methode zwischen GET und POST aus.
-
Klicken Sie je nach Bedarf für Ihre Integration auf Header hinzufügen und/oder Abfrageparameter hinzufügen. Geben Sie für jeden Parameter die folgenden Details an:
-
Parameter: Der tatsächliche Name des Headers oder Abfrageparameters, wie von der API erwartet.
-
Name: Ein Marketing-freundliches Label für diesen Parameter; Autorinnen und Autoren wählen ihn beim Zuordnen von Werten in Kampagnen aus.
-
Typ: Wählen Sie Konstante für einen festen Wert oder Variable für eine dynamische Eingabe.
-
Wert: Geben Sie für Konstanten den Wert direkt ein oder wählen Sie eine Variablenzuordnung aus.
-
Obligatorisch: Geben Sie an, ob dieser Parameter obligatorisch ist. Wenn bei obligatorischen Parametern für Variablen zur Laufzeit kein Wert aufgelöst werden kann und kein Standardwert angegeben ist, schlägt die Generierung der Anfrage mit einem Fehler fehl und der ausgehende API-Aufruf wird nicht ausgeführt.
-
-
Wählen Sie einen Authentifizierungstyp:
-
Keine Authentifizierung: Bei offenen APIs, für die keine Anmeldedaten erforderlich sind.
-
API-Schlüssel: Authentifizieren von Anfragen mithilfe eines statischen API-Schlüssels. Geben Sie den API-Schlüsselnamen, den API-Schlüsselwert und den Speicherort an.
-
Einfache Authentifizierung: Verwenden der einfachen HTTP-Standardauthentifizierung. Geben Sie Benutzername und Kennwort ein.
-
OAuth 2.0: Authentifizieren mit dem OAuth 2.0-Protokoll. Klicken Sie auf das Symbol
-
-
Legen Sie die Richtlinienkonfiguration fest, z. B. den Timeout für API-Anfragen und die Möglichkeit, Drosselung, Cache und/oder Wiederholungsversuche zu aktivieren.
note NOTE Bei aktivierter Drosselung liegen die unterstützten Raten bei 50 bis 5.000 TPS. Die Beschränkungen gelten für die Integration, nicht für jeden API-Endpunkt. Wenn der Wiederholungsvorgang aktiviert ist, wird bei anderen Fehlern standardmäßig drei Mal wiederholt. Die Zeit zwischen Neuversuchen liegt bei 200 ms, 400 ms und 800 ms. -
Mit dem Feld Antwort-Payload können Sie festlegen, welche Felder der Beispielausgabe für die Personalisierung von Nachrichten verwendet werden sollen.
Klicken Sie auf das Symbol
-
Wählen Sie die Felder aus, die für die Personalisierung bereitgestellt werden sollen, und geben Sie die entsprechenden Datentypen an.
note NOTE Die Antwort-Payload-Konfiguration definiert die erwartete Antwort für das Authoring, einschließlich aller in diesem Schritt angewendeten Schemata. Marketing-Fachleute dürfen nur auf offen gelegte Felder verweisen. Die Validierung von Token für andere Pfade schlägt im Editor fehl. -
Verwenden Sie Testverbindung senden, um die Integration zu validieren. Erfahren Sie, wie Sie Ihre Verbindung testen
Klicken Sie nach dem Validieren auf Aktivieren.
-
Greifen Sie auf Ihre neu erstellte Integration für folgende Aktionen zu:
- Aktualisieren: Ändern Sie nur Details zur Authentifizierung und zur Richtlinienkonfiguration. Aktualisierungen gelten für Live-Journeys und -Kampagnen. Bevor Sie Änderungen speichern, verwenden Sie das Menü Verweise durchsuchen, um zu bestätigen, wo die Integration verwendet wird.
- Archivieren: Archivieren Sie eine Integrationskonfiguration.
Klicken Sie nach der Aktivierung auf das Symbol
Sendezeitbeschränkungen und Verhalten configure-send-time
Zum Zeitpunkt des Versands können Antworten von der externen API standardmäßig bis zu 4 MB groß sein. Größere Antworten werden als Integrationsfehler behandelt und Wiederholungen werden nicht versucht, wenn der Fehler durch die Antwortgröße verursacht wird.
Aufrufe berücksichtigen die von Ihnen konfigurierte Drosselungsrate: Journey Optimizer plant Versuche bis zu diesem Limit, selbst wenn das externe System ausfällt oder Fehler zurückgibt. Wenn Cache aktiviert ist, werden nur erfolgreiche Antworten gespeichert und wiederverwendet, bis der definierte TTL-Cache abläuft. Fehlgeschlagene Antworten werden nie zwischengespeichert.
Jede Nachricht in der Warteschlange verfügt außerdem über ein Gültigkeitsfenster (TTL). Wenn die Verarbeitung fehlschlägt und eine Nachricht über dieses Fenster hinausgeht, wird sie vom System verworfen und ein MessageValidityExclusion-Ereignis wird ausgegeben, sodass veraltete Arbeit aus der Warteschlange entfernt wird und Ressourcen verfügbar bleiben.
Testen der Verbindung connection
Testverbindung senden validiert vor der Aktivierung die Endpunkt-URL, Authentifizierung und Anfragestruktur gegen die Ziel-API, was das Risiko von Laufzeitfehlern während der Nachrichtenverarbeitung reduziert.
-
Wenn die URL, die HTTP-Methode, die Header und die Abfrageparameter definiert sind, klicken Sie auf Testverbindung senden, um einen Konnektivitätstest durchzuführen und die Konfiguration zu bestätigen.
-
Geben Sie im Dialogfeld Testverbindung senden Standardwerte für alle Variable-Platzhalter im URL-Pfad, in den Kopfzeilen und in den Abfrageparametern ein.
Diese Werte sind in der Testanfrage enthalten. Journey Optimizer ruft den Endpunkt auf und meldet, ob die Verbindung erfolgreich hergestellt wurde oder fehlgeschlagen ist.
-
Wenn der Test eine erfolgreiche Antwort zurückgibt, wählen Sie Als Antwort-Payload verwenden aus, um den Antworttext in das Feld Antwort-Payload zu kopieren. Weitere Informationen finden Sie unter Konfigurieren der Integration in Schritt 10, wo Datentypen erkannt und Felder für die Personalisierung ausgewählt werden können.
-
Wenn der Test nicht erfolgreich ist, erweitern Sie die Dropdown-Liste Fehler, um die Fehlerdetails zu prüfen und die Integrationskonfiguration nach Bedarf zu aktualisieren, und führen Sie Testverbindung senden erneut aus.
Wählen Sie nach erfolgreichem Test Aktivieren in der Integrationskonfiguration aus. Siehe Konfigurieren der Integration.
Siehe auch