Arbeiten mit Standardintegrationen external-sources

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.

{modal="regular"}

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.

Geben Sie die URL des API-Endpunkts ein.

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 Pfadparameter fest.

Wählen Sie Browsen aktivieren aus, um eine aktive Browserintegration zu verknüpfen, damit ihre Antwortfelder Variablen in Kopfzeilen, Abfrage- und Pfadparametern und in der Payload zugeordnet werden können.

➡️ Siehe Erstellen von Browserintegrationen

{modal="regular"}

Konfigurieren Sie den Pfadparameter mit Name und Standardwert für jeden Platzhalter, den Sie 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.

{modal="regular"}

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.

{modal="regular"}

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 , um die Payload zu konfigurieren oder zu aktualisieren.

{modal="regular"}

Legen Sie die Richtlinienkonfiguration fest, z. B. den Timeout für API-Anfragen und die Möglichkeit, Drosselung, Cache und/oder Wiederholungsversuche zu aktivieren.

Für eine POST-Methode konfigurieren Sie die Payload durch Auswahl eines Body-Typs:

• JSON: Klicken Sie auf das Symbol und fügen Sie die Payload Ihrer JSON-Anfrage ein. Ordnen Sie die Variablen zu, die Sie in der Payload erfüllen müssen.

• GraphQL: Fügen Sie Ihre GraphQL-Abfrage ein. Journey Optimizer generiert automatisch Vorgangsnamen und ermöglicht die Zuordnung der entsprechenden Abfragevariablen.

  {modal="regular"}

Wählen Sie den Antworttyp zwischen JSON und HTML.

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 und fügen Sie eine beispielhafte JSON-Antwort-Payload ein, um Datentypen automatisch zu erkennen.

Wählen Sie die Felder aus, die für die Personalisierung bereitgestellt werden sollen, und geben Sie die entsprechenden Datentypen an.

{modal="regular"}

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.

{modal="regular"}

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.

{modal="regular"}

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.

{modal="regular"}

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.

  {modal="regular"}

Klicken Sie nach der Aktivierung auf das Symbol , um auf das Menü Verweise durchsuchen zuzugreifen und die Verwendung für diese Konfiguration zu überprüfen, einschließlich der davon abhängigen Journeys und Kampagnen.

{modal="regular"}