ドキュメントJourney OptimizerJourney Optimizer ガイド

ユースケース：カスタムアクションを使用して Experience Platform にジャーニーイベントを書き込む custom-action-aep

Last update: Wed Oct 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 経験者
  • 開発者

このユースケースでは、カスタムアクションと認証済みの呼び出しを使用して、ジャーニーから Adobe Experience Platform にカスタムイベントを書き込む方法について説明します。

IO プロジェクトの設定 custom-action-aep-IO

  1. Adobe Developer Console で、「プロジェクト」をクリックし、IO プロジェクトを開きます。

  2. 「資格情報」セクションで、「OAuth サーバー間」をクリックします。

  3. 「cURL コマンドを表示」をクリックします。

  4. 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'
CAUTION
Adobe Developer Console でプロジェクトを作成したら、開発者と API に対し、適切な権限のアクセス制御を付与してください。詳しくは、Adobe Experience Platform ドキュメントを参照してください

HTTP API インレットを使用したソースの設定

  1. ジャーニーからデータを書き込むエンドポイントを Adobe Experience Platform に作成してます。

  2. Adobe Experience Platform で、左メニューの​ 接続 ​の下にある「ソース」をクリックします。HTTP API で「データを追加」をクリックします。

  3. 「新規アカウント」を選択し、認証を有効にします。「ソースに接続」をクリックします。

  4. 「次へ」をクリックし、データを書き込むデータセットを選択します。「次へ」、「終了」の順にクリックします。

  5. 新しく作成したデータフローを開きます。スキーマペイロードをコピーして、メモ帳に保存します。

{
"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

カスタムアクションの設定について詳しくは、このページを参照してください。

この例では、次の手順に従います。

  1. Adobe Journey Optimizer を開き、左メニューの​ 管理 ​の下にある「設定」をクリックします。アクション ​で、「管理」をクリックし、「アクションを作成」をクリックします。

  2. URLを設定し、POST メソッドを選択します。

    https://dcs.adobedc.net/collection/<collection_id>?syncValidation=false

  3. ヘッダー（Content-Type、Charset、sandbox-name）が設定されていることを確認します。

認証の設定 custom-action-aep-authentication

  1. 次のペイロードを持つ​ カスタム ​として​ タイプ ​を選択します。

  2. 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"
}
}

  3. 「クリックして認証をテスト」ボタンを使用して、接続をテストします。

ペイロードの設定 custom-action-aep-payload

  1. 「リクエスト」フィールドと「応答」フィールドに、先ほど使用したソース接続からのペイロードを貼り付けます。

    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"
}
}

  2. 動的に入力されるフィールドのフィールド設定を、定数 ​から​ 変数 ​に変更します。

  3. カスタムアクションを保存します。

ジャーニー

  1. 最後に、ジャーニーでこのカスタムアクションを使用して、カスタムジャーニーイベントを書き込みます。

  2. ユースケースに応じて、ジャーニーバージョン ID、ノード ID、ノード名およびその他の属性を入力します。

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76