カスタムアクションを使用した Experience Platform のジャーニーイベントの書き込み custom-action-aep
このユースケースでは、カスタムアクションと認証済み呼び出しを使用して、ジャーニーから Adobe Experience Platform にカスタムイベントを書き込む方法を説明します。
開発者プロジェクトの設定 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 インレットを使用したソースの設定
-
ジャーニーからデータを書き込む Adobe Experience Platform めに、エンドポイントを作成します。
-
Adobe Experience Platform で、左側のメニューの 接続 の下の ソース をクリックします。 HTTP API で「データを追加」をクリックします。
-
「新規アカウント」を選択し、認証を有効にします。「ソースに接続」を選択します。
-
「次へ」を選択し、データを書き込むデータセットを選択します。「次へ」、「終了」の順にクリックします。
-
新しく作成したデータフローを開きます。スキーマペイロードをコピーして、メモ帳に保存します。
{
"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
-
次のペイロードを持つ カスタム として タイプ を選択します。
-
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
-
「リクエスト」フィールドと「応答」フィールドに、先ほど使用したソース接続からのペイロードを貼り付けます。
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、ノード名およびその他の属性を入力します。
