Caso d’uso: utilizzare azioni personalizzate per scrivere eventi di Percorso in Experience Platform custom-action-aep
Questo caso d’uso spiega come scrivere eventi personalizzati in Adobe Experience Platform da Percorsi utilizzando Azioni personalizzate e chiamate autenticate.
Configurare un progetto I/O custom-action-aep-IO
-
Da Adobe Developer Console, fai clic su Progetto e apri il progetto di I/O.
-
Nella sezione Credenziali, fai clic su OAuth Server-to-Server.
-
Fare clic su Visualizza comando cURL.
-
Copiare il comando cURL e archiviare client_id, client_secret, grant_type e 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'
Configurare Source utilizzando l’ingresso API HTTP
-
Crea un endpoint in Adobe Experience Platform per scrivere i dati dai percorsi.
-
In Adobe Experience Platform, fai clic su Origini, in Connessioni nel menu a sinistra. In API HTTP, fare clic su Aggiungi dati.
-
Seleziona Nuovo account e abilita l'autenticazione. Fai clic su Connetti a Source.
-
Fai clic su Avanti e seleziona il set di dati in cui desideri scrivere i dati. Fai clic su Avanti e Fine.
-
Apri il flusso di dati appena creato. Copia il payload dello schema e salvalo nel blocco note.
{
"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"
}
}
}
Configurare l’azione personalizzata custom-action-config
La configurazione dell'azione personalizzata è descritta in questa pagina.
Per questo esempio, segui questi passaggi:
-
Apri Adobe Journey Optimizer e fai clic su Configurazioni, in Amministrazione nel menu a sinistra. In Azioni, fai clic su Gestisci e poi su Crea azione.
-
Imposta l’URL e seleziona il metodo Post.
https://dcs.adobedc.net/collection/<collection_id>?syncValidation=false -
Assicurati che le intestazioni (Content-Type, Charset, sandbox-name) siano configurate.
Impostare l’autenticazione custom-action-aep-authentication
-
Seleziona Tipo come Personalizzato con il seguente payload.
-
Incollare client_secret, client_id, scope e grant_type dal payload del progetto IO utilizzato in precedenza.
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" } } -
Utilizza Fare clic per verificare l'autenticazione per verificare la connessione.
Impostare il payload custom-action-aep-payload
-
Nei campi Richiesta e Risposta, incolla il payload dalla connessione di origine utilizzata in precedenza.
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" } } -
Modifica la configurazione del campo da Costante a Variabile per i campi che verranno compilati in modo dinamico.
-
Salva l'azione personalizzata.
Percorso
-
Infine, utilizza questa azione personalizzata in un percorso per scrivere gli eventi di percorso personalizzati.
-
Popola l’ID versione del Percorso, l’ID nodo, il nome del nodo e altri attributi in base al tuo caso d’uso.
