使用案例:使用自訂動作在Experience Platform中寫入歷程事件 custom-action-aep
此使用案例說明如何使用自訂動作和已驗證的呼叫,將自訂事件從歷程寫入Adobe Experience Platform。
設定IO專案 custom-action-aep-IO
-
在Adobe Developer Console中,按一下 專案 並開啟您的IO專案。
-
在 認證 區段中,按一下 OAuth伺服器對伺服器。
-
按一下 檢視cURL命令。
-
複製cURL命令並儲存client_id、client_secret、grant_type和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'
使用HTTP API入口設定Source
-
在Adobe Experience Platform中建立端點,從歷程寫入資料。
-
在Adobe Experience Platform中,按一下左側功能表中 連線 底下的 來源。 在 HTTP API 下,按一下 新增資料。
-
選取 新帳戶 並啟用驗證。 按一下 連線至Source。
-
按一下 下一步,然後選取您要寫入資料的資料集。 按一下 下一步 和 完成。
-
開啟新建立的資料流。 複製結構描述承載並將其儲存在記事本中。
{
"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"
}
}
}
設定自訂動作 custom-action-config
自訂動作設定在此頁面中有詳細說明。
在此範例中,請遵循下列步驟:
-
開啟Adobe Journey Optimizer,然後按一下左側功能表中 管理 下的 組態。 在 動作 下,按一下 管理,然後按一下 建立動作。
-
設定URL並選取Post方法。
https://dcs.adobedc.net/collection/<collection_id>?syncValidation=false
-
請確定已設定標題(Content-Type、Charset、sandbox-name)。
設定驗證 custom-action-aep-authentication
-
選取 Type 做為 Custom,並包含下列承載。
-
貼上client_secret、client_id、scope和grant_type (來自以前使用的IO專案裝載)。
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" } }
-
使用 按一下以測試驗證 按鈕以測試連線。
設定裝載 custom-action-aep-payload
-
在 Request 與 Response 欄位中,貼上先前使用之來源連線的裝載。
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" } }
-
將欄位組態從 常數 變更為 變數,以動態方式填入欄位。
-
儲存自訂動作。
歷程
-
最後,在歷程中使用此自訂動作來撰寫自訂歷程事件。
-
根據您的使用案例填入歷程版本ID、節點ID、節點名稱和其他屬性。