イベントを送信するための追加手順 additional-steps-to-send-events
イベントを ストリーミング取り込み API に送信し、Journey Optimizer で使用するように設定するには、次の手順に従う必要があります。
- Adobe Experience Platform API からインレット URL を取得します。詳しくは、treaming Ingestion API の概要を参照してください。
- イベント メニューのペイロードプレビューから、ペイロードをコピーします。詳しくは、このページを参照してください。
次に、コピーしたペイロードを使用してイベントをストリーミング取得 API にプッシュするデータシステムを設定する必要があります。
- ストリーミング取得 API URL(インレットと呼びます) に対する POST API 呼び出しを設定します。
- ストリーミング取得 API への API 呼び出しの本文("data section")で、Journey Optimizer からコピーしたペイロードを使用します。以下に例を示します
- ペイロードに存在するすべての変数を取得する場所を決定します。例:イベントがアドレスを伝えることになっている場合、貼り付けられたペイロードには "address": "string" と表示されます。"string" は、正しい値(メッセージを送信する相手のメール)を自動的に入力する変数に置き換える必要があります。ペイロードプレビューの ヘッダー セクションでは、作業を容易にするために多くの値が自動的に入力されます。
- 本文タイプとして "application/json" を選択します。
- 「x-gw-ims-org-id」キーを使用して、ヘッダーに組織 ID を渡します。値には、組織 ID(「XXX@AdobeOrg」)を使用します。
以下にストリーミング取得 API イベントの例を示します。
{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "c25585b9-252e-431d-b562-e73da70c04e7",
"msgVersion": "1.0",
"xactionId": "f5995abe-c49d-4848-9577-a7a4fc2996fb",
"datasetId": "string - required if you want the data to land in a specific dataset - not mandatory",
"imsOrgId": "XXX@AdobeOrg",
"schemaRef": {
"id": "XXX",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"source": {
"name": "Journeys"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "XXX",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_instance_name": {
"person": {
"firstName": "string",
"lastName": "string",
"gender": "string",
"birthYear": 10,
"emailAddress": "string"
}
},
"identityMap": {
"Email": [
{
"id": "string"
}
]
},
"_id": "string",
"timestamp": "2023-05-29T00:00:00.000Z",
"_experience": {
"campaign": {
"orchestration": {
"eventID": "XXX"
}
}
}
}
}
}
「data」 部分をどこに貼り付けるかを特定しやすくするために、JSONフォーマッターなどの JSON ビジュアライゼーションツールを使用できます。
ストリーミング取得 API のトラブルシューティングについては、Experience Platform のドキュメントを参照してください。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76