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.
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.
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.
-
Navigieren Sie Administration > Konfigurationen.
-
Klicken Sie Zwischenbereich auf Externe Aktionen“.
{width="800" modal="regular"}
-
Klicken oben auf „Aktion erstellen“.
-
Geben Sie die URL zur OpenAPI-Spezifikation für Ihren externen Service ein und klicken Sie auf Erstellen.
{width="500"}
note note NOTE Ihr externer Dienst muss live und erreichbar sein, damit dieser Schritt erfolgreich ist. -
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.titleBeschreibung Beschreibung der Aktion info.descriptionURL URL zur OpenAPI-Spezifikation, die den externen Service definiert servers.url -
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. {width="600" modal="regular"}
Sie können die Anmeldeinformationen nach Bedarf ändern, wenn sich die konfigurierte Aktion im Status Entwurf oder Aktiv befindet.
-
Klicken Sie auf Weiter.
-
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.
- Externe Maßnahmen (
-
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.
{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.
{width="600" modal="regular"}
-
-
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.