Arbeiten mit Integrationen external-sources
Überblick
Die Integrationen-Funktion verknüpft Adobe Journey Optimizer mit Drittanbietersystemen, deren Daten und zusammenstellbaren Inhalt Sie bereits an anderer Stelle verwalten. Sie können dieses Material beim Authoring und beim Versand aufdecken, was responsivere, personalisierte Erlebnisse für alle in Journey Optimizer verwendeten Kanäle unterstützt.
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 mit der Verwendung von Integrationen beginnen zu können, müssen Benutzenden die Berechtigungen AJO-Integrationskonfiguration verwalten und AJO-Integrationskonfiguration anzeigen gewährt 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- hinzu und wählen Sie dann die entsprechenden Integrationsberechtigungen aus dem Dropdown-Menü 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 Abfrageparameter automatisch auszufüllen.
-
Es müssen ein Name und eine Beschreibung für die Integration angegeben werden.
note NOTE Name Feld darf keine Leerzeichen enthalten. -
Geben Sie den API-Endpunkt ().
Umschließen Sie für Pfadvariablen eine Beschriftung in doppelte geschweifte Klammern in der URL, z. B.
https://api.example.com/v1/products/{{productId}}, und legen Sie dann jeden Platzhalter in „Pfadvorlage fest. -
Konfigurieren Sie Pfadvorlage mit Name und Standardwert für jeden Platzhalter, den Sie der URL hinzugefügt haben.
Beachten Sie dass „Name nur im Editor eine dem Marketing zugewandte Beschriftung ist, sie wird nicht in der API-Anfrage gesendet.
-
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 Header- oder Abfrageparametername, wie von der API erwartet.
-
Name: Ein marketerfreundlicher Titel für diesen Parameter, den Autoren beim Zuordnen von Werten in Kampagnen auswählen.
-
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 Variablen-Parametern zur Laufzeit kein Wert aufgelöst und kein Standard angegeben wird, schlägt die Anfragegenerierung 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 Richtlinienkonfiguration wie Timeout für API-Anfragen fest und wählen Sie die Aktivierung von Drosselung, Cache und/oder Wiederholung aus.
note NOTE Bei aktivierter Drosselung liegen die unterstützten Raten bei 50 bis 5.000 TPS. Die Beschränkungen gelten für Integration, nicht für jeden API-Endpunkt. Wenn der Wiederholungsvorgang aktiviert ist, andere Fehler standardmäßig ( Mal), 200 ms, 400 ms und 800 ms zwischen den Versuchen. -
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-Experten dürfen nur auf offen gelegte Felder verweisen. Token für andere Pfade schlagen die Validierung im Editor fehl. -
Verwenden Sie Testverbindung senden, um die Integration zu validieren. Erfahren Sie mehr über das Testen Ihrer Verbindung
Klicken Sie nach dem Validieren auf Aktivieren.
-
Greifen Sie auf Ihre neu erstellte Integration zu:
- Aktualisieren: Ändern Sie nur Authentifizierung Details und Richtlinienkonfiguration. Für Live-Journey und -Kampagnen gelten Aktualisierungen. Bevor Sie Änderungen speichern, verwenden Sie das Menü Verweise erkunden, um zu bestätigen, wo die Integration verwendet wird.
- Archivieren: Archivieren einer Integrationskonfiguration.
Klicken Sie nach der Aktivierung auf
Sendezeitbeschränkungen und -verhalten configure-send-time
Zum Zeitpunkt des Versands können Antworten von der externen API standardmäßig bis zu 4 MB. Alles, was größer ist, wird als Integrationsfehler behandelt und erneute Versuche werden nicht versucht wenn der Fehler durch die Antwortgröße verursacht wird.
Die Aufrufe die von konfigurierte Drosselungsrate ein: 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 TTL definierte 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, das System sie und gibt ein MessageValidityExclusion aus, sodass veraltete Arbeit aus der Warteschlange entfernt wird und Ressourcen verfügbar bleiben.
Testen der Verbindung connection
Testverbindung senden validiert die Endpunkt-URL, Authentifizierung und Anfragestruktur vor der Aktivierung anhand der 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 Verbindung testen, um einen Konnektivitätstest durchzuführen und die Konfiguration zu bestätigen.
-
Geben 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 in Schritt 10 unter Integration konfigurieren, wo Datentypen erkannt und Felder für die Personalisierung ausgewählt werden können.
-
Wenn der Test nicht erfolgreich ist, erweitern Sie die Fehler-Dropdown-Liste, um die Fehlerdetails zu überprüfen, 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.