Konfiguration externer Aktionen

Mit externen Aktionen können Account-Journey in Journey Optimizer B2B edition eine Verbindung zu externen Systemen direkt über die Journey-Arbeitsfläche herstellen. Wenn eine Konto-Zielgruppe einen externen Aktionsknoten erreicht, führt das System einen asynchronen ausgehenden Aufruf an einen konfigurierten externen Service durch und übergibt Zielgruppenattributdaten für Konten, Personen oder beides. Der externe Service verarbeitet die Daten und antwortet mithilfe eines Callbacks, wobei Zielgruppendaten und Metadaten zurückgegeben werden, die zur Anleitung der Journey-Ausführung verwendet werden können.

Diese Funktion unterstützt zwei Journey-Knotentypen:

  • Externe Aktion - Ruft einen externen Service auf und fährt über einen einzelnen ausgehenden Pfad fort. Ideal für "-and-Forget-Integrationen, z. B. das Aktualisieren eines CRM-Eintrags oder das Auslösen einer nachgelagerten Benachrichtigung.
  • Externe Aufspaltungspfade - Ruft einen externen Service auf und bewertet die Antwort auf Routing-Konten entlang eines von mehreren definierten Pfaden.
NOTE
Externe Aktionsdienste werden nur für Account-Journey unterstützt. Diese Knotentypen stehen Personen-Journey nicht zur Verfügung.

Implementierungsübersicht

Die Einrichtung von Maßnahmen im Außenbereich erfordert eine Koordinierung der drei folgenden Rollen:

Implementieren des externen Services implement-service

Der Entwickler muss einen öffentlich zugänglichen Webservice erstellen und veröffentlichen, der der Adobe Journey Optimizer B2B edition External Actions Service Provider Interface entspricht.

NOTE
Die Rückruffunktion erfordert ein Bearer-Token. Rufen Sie dies ab, indem Sie OAuth-Server-zu-Server-Anmeldedaten in Adobe Developer Console für Ihre IMS-Organisation einrichten.

Nachdem der Service live ist, geben Sie die URL für die OpenAPI-Spezifikation und die Authentifizierungsdaten an den Produktadministrator weiter, der für die Konfiguration der Aktion verantwortlich ist.

Konfigurieren der Aktion configure-action

Eine Aktion muss konfiguriert und aktiviert werden, bevor sie von Marketing-Experten auf einer Journey verwendet werden kann. Aktionen werden im Status Entwurf erstellt und Ihre Änderungen werden automatisch gespeichert. Er bleibt als Entwurf erhalten, bis Sie ihn aktivieren.

PREREQUISITES
Rufen Sie die URL zur OpenAPI-Spezifikation und die Authentifizierungsberechtigungen vom Entwickler ab, bevor Sie die Konfiguration hinzufügen.
Um eine externe Aktion zu definieren und zu aktivieren, benötigen Sie die B2B-Admin-Konfigurationen verwalten Produktberechtigung.
  1. Navigieren Sie Administration > Konfigurationen.

  2. Klicken Sie Zwischenbereich auf Externe Aktionen“.

    Zugriff auf den Konfigurationsbereich für externe Aktionen {width="800" modal="regular"}

  3. Klicken oben auf „Aktion erstellen“.

  4. Geben Sie die URL zur OpenAPI-Spezifikation für Ihren externen Service ein und klicken Sie auf Erstellen.

    Service-URL eingeben {width="500"}

    note note
    NOTE
    Ihr externer Dienst muss live und erreichbar sein, damit dieser Schritt erfolgreich ist.
  5. Wenn die URL erfolgreich aufgelöst wird, überprüfen Sie die Service-Details.

    Die Service-Details werden direkt aus der OpenAPI-Spezifikation gelesen, wenn die Aktion erstellt wird. Sie können diese Eigenschaften nach der Erstellung in der Konfiguration nicht mehr ändern.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Eigenschaft Beschreibung OpenAPI-Spezifikations-Eigenschaft
    Name Name der Aktion info.title
    Beschreibung Beschreibung der Aktion info.description
    URL URL zur OpenAPI-Spezifikation, die den externen Service definiert servers.url
  6. Geben Sie die Authentifizierung-Anmeldeinformationen für den externen Dienst (components.securitySchemes) ein.

    note note
    NOTE
    Die angezeigten Felder für die Berechtigung hängen vom Authentifizierungsmechanismus ab, der im externen Service definiert wurde. Unterstützte Typen sind API-Schlüssel, OAuth2 und HTTP-Standardauthentifizierung.

    Authentifizierungsdaten hinzufügen {width="600" modal="regular"}

    Sie können die Anmeldeinformationen nach Bedarf ändern, wenn sich die konfigurierte Aktion im Status Entwurf oder Aktiv befindet.

  7. Klicken Sie auf Weiter.

  8. Legen Sie die Konfigurationen-Eigenschaften fest, um festzulegen, wie die Aktion Daten mit dem externen Service austauscht.

    note note
    NOTE
    Eigenschaften, die als statisch gekennzeichnet sind, können zum Zeitpunkt der Konfiguration nicht aktualisiert werden und basieren auf der Service-Definition.
    • Action type (static) - Der unterstützte Journey-Knotentyp:

      • Externe Maßnahmen (enableSplitPath = false)
      • Aufspaltungspfad für externe Aktionen (enableSplitPath = true)

      Sie können den Aktionstyp nach der Erstellung der Aktionskonfiguration nicht ändern.

    • Accessors (static) - (Nur Pfad für aufgeteilte externe Aktionen) Die Variablen, die vom externen Service zurückgegeben werden, sind als Pfadbedingungen in einem externen aufgeteilten Pfadknoten verfügbar. (invocationPayloadDef.accessorsMetadata)

    • Journey-Kontext (static) - Der Umfang der Zielgruppendaten, die in der Anfrage gesendet werden (supportedEntityType):

      • Konto - Sendet nur Konten

      • Personen - Sendet nur Personen

      • Personen im Konto - Sendet Konten und kontobezogene Personen

    • Ausgehende Felder - Ordnen Sie jedes Feld in der Tabelle einem XDM-Feld“ ​. Diese Felder werden im Anfragetext an den externen Service gesendet. Eigenschaften der Dienstdefinition: invocationPayloadDef.accountFields, invocationPayloadDef.fields.

    Ausgehende Felder für externe Aktionen zuordnen {width="600" modal="regular"}

    • Eingehende Felder - Ordnen Sie jedes Feld in der Tabelle einem (​ XDM-Feld) ​. Diese Felder werden aus der Antwort des externen Services ausgefüllt. Eigenschaften der Dienstdefinition: callbackPayloadDef.accountFields, callbackPayloadDef.fields. Nach der Erstellung aktualisierbar.

    • Kopfzeilenparameter - Geben Sie einen Wert für jede Zeile ein, die als HTTP-Kopfzeile in der Anfrage übergeben werden soll. Service-Definitionseigenschaft: invocationPayloadDef.headers.

    • Zeitüberschreitung - Geben Sie die Anzahl der Minuten ein, die gewartet werden soll, bis der externe Service den Callback aufruft, bevor die Anfrage als fehlgeschlagen betrachtet wird. Service-Definitionseigenschaft: timeout.

    • Globale Attribute - Geben Sie einen Wert für jede Zeile ein, die als statisches Feld in den Anfragetext aufgenommen werden soll. Service-Definitionseigenschaft: invocationPayloadDef.globalAttributes.

    Header-Parameter für externe Aktionen, Zeitüberschreitung und globale Attribute {width="600" modal="regular"}

  9. Klicken Sie auf Rückwärtspfeil, um zur Liste zurückzukehren und die Aktion in einem Entwurf zu belassen.

    Oder klicken Sie auf Aktivieren, um die Aktionskonfiguration in den Status Aktiv zu ändern. Die konfigurierte externe Aktion muss aktiv sein, um sie für die Verwendung in Account Journey verfügbar zu machen.

Hinzufügen eines externen Knotens zu einer Journey add-journey-node

Nachdem eine Aktion aktiviert wurde, können Marketing-Fachleute einen Externe Aktion oder Externer Aufspaltungspfad-Knoten zu jeder Konto-Journey hinzufügen. Informationen zum Hinzufügen und Verwenden dieser Knoten auf der Arbeitsfläche der Konto-Journey finden Sie unter Externe Knoten.

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0