Verwenden von benutzerdefinierten Aktionen zum Schreiben von Journey-Ereignissen in Experience Platform custom-action-aep
In diesem Anwendungsbeispiel wird erläutert, wie benutzerspezifische Ereignisse mithilfe von benutzerdefinierten Aktionen und authentifizierten Aufrufen von Journey in Adobe Experience Platform geschrieben werden.
Konfigurieren eines Entwicklerprojekts custom-action-aep-IO
-
Klicken Sie in der Adobe Developer Console auf Projekt und öffnen Sie Ihr IO-Projekt.
-
Klicken Sie im Abschnitt Anmeldedaten auf OAuth Server-to-Server.
-
Klicken Sie auf cURL-Befehl anzeigen.
-
Kopieren Sie den cURL-Befehl und speichern Sie client_id, client_secret, grant_type und scope.
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' -H 'Content-Type: application/x-www-form-urlencoded' -d 'grant_type=client_credentials&client_id=1234&client_secret=5678&scope=openid,AdobeID,read_organizations,additional_info.projectedProductContext,session'
Konfigurieren der Quelle mit dem HTTP-API-Inlet
-
Erstellen Sie einen Endpunkt in Adobe Experience Platform, um die Daten aus Journey zu schreiben.
-
Klicken Sie Adobe Experience Platform im linken Menü Quellen unter Verbindungen. Klicken Sie unter HTTP API auf Daten hinzufügen.
-
Wählen Sie Neues Konto aus und aktivieren Sie die Authentifizierung. Wählen Sie Mit der Quelle verbinden aus.
-
Wählen Sie Weiter und den Datensatz aus, in den Sie die Daten schreiben möchten. Klicken Sie auf Weiter und Beenden.
-
Öffnen Sie den neu erstellten Datenfluss. Kopieren Sie die Schema-Payload und speichern Sie sie in Ihrem Notepad.
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/<your_org>/schemas/<schema_id>",
"contentType": "application/vnd.adobe.xed-full+json;version=1.0"
},
"imsOrgId": "<org_id>",
"datasetId": "<dataset_id>",
"source": {
"name": "Custom Journey Events"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/<your_org>/schemas/<schema_id>",
"contentType": "application/vnd.adobe.xed-full+json;version=1.0"
}
},
"xdmEntity": {
"_id": "test1",
"<your_org>": {
"journeyVersionId": "",
"nodeId": "", "customer_Id":""
},
"eventMergeId": "",
"eventType": "",
"producedBy": "self",
"timestamp": "2018-11-12T20:20:39+00:00"
}
}
}
Konfigurieren der benutzerdefinierten Aktion custom-action-config
Die Konfiguration der benutzerdefinierten Aktion wird auf dieser Seite beschrieben.
Für dieses Beispiel gehen Sie wie folgt vor:
-
Öffnen Sie Adobe Journey Optimizer und klicken Sie Konfigurationen unter Administration im linken Menü. Klicken Sie unter Aktionen auf Verwalten und dann auf Aktion erstellen.
-
Legen Sie die URL fest und wählen Sie die POST-Methode.
https://dcs.adobedc.net/collection/<collection_id>?syncValidation=false -
Stellen Sie sicher, dass die Kopfzeilen (Content-Type, Charset, sandbox-name) konfiguriert sind.
Einrichten der Authentifizierung custom-action-aep-authentication
-
Wählen Sie den Typ als Benutzerdefiniert mit der folgenden Payload.
-
Fügen Sie client_secret, client_id, scope und grant_type (aus der zuvor verwendeten IO-Projekt-Payload) ein.
code language-none { "type": "customAuthorization", "authorizationType": "Bearer", "endpoint": "https://ims-na1.adobelogin.com/ims/token/v3", "method": "POST", "headers": {}, "body": { "bodyType": "form", "bodyParams": { "grant_type": "client_credentials", "client_secret": "********", "client_id": "<client_id>", "scope": "openid,AdobeID,read_organizations,additional_info.projectedProductContext,session" } }, "tokenInResponse": "json://access_token", "cacheDuration": { "duration": 28000, "timeUnit": "seconds" } } -
Verwenden Sie die Schaltfläche Zum Testen der Authentifizierung hier klicken, um die Verbindung zu testen.
Einrichten der Payload custom-action-aep-payload
-
Fügen Sie die Payload aus der zuvor verwendeten Quellverbindung in die Felder Anfrage und Antwort ein.
code language-none { "xdmMeta": { "schemaRef": { "id": "https://ns.adobe.com/<your_org>/schemas/<schema_id>", "contentType": "application/vnd.adobe.xed-full+json;version=1.0" } }, "xdmEntity": { "_id": "/uri-reference", "<your_org>": { "journeyVersionId": "Sample value", "nodeId": "Sample value", "customer_Id":"" }, "eventMergeId": "Sample value", "eventType": "advertising.completes, "producedBy": "self", "timestamp": "2018-11-12T20:20:39+00:00" } } -
Ändern Sie die Feldkonfiguration von Konstant in Variabel für Felder, die dynamisch befüllt werden sollen.
-
Speichern Sie die benutzerdefinierte Aktion.
Journey
-
Verwenden Sie schließlich diese benutzerdefinierte Aktion in einer Journey, um die benutzerdefinierten Journey-Ereignisse zu schreiben.
-
Füllen Sie Attribute wie Journey Version Id, Node Id, Node Name und andere entsprechend Ihrem Anwendungsfall aus.
