ドキュメント Experience Platform Edge Network Server API ドキュメント

インタラクティブなデータ収集

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

概要 overview

インタラクティブデータ収集エンドポイントは、1 つのイベントを受け取り、クライアントがAdobe Experience Platform Edge Networkサーバーから返される応答を必要とする場合に使用されます。また、これらのエンドポイントは、データ収集を実行しながら、他のEdge Networkサービスからコンテンツを返すこともできます。

IMPORTANT

/interact エンドポイントは、主にExperience Platform SDK で使用するように設計されています。このエンドポイントは追加的な変更が行われる可能性があり、その動作は予告なく進化する可能性があります。例えば、今後、新しい項目が応答ペイロードに追加される可能性があります。

次に示すように、サーバー応答には 1 つ以上の Handle オブジェクトが含まれます。

API 呼び出しの例

API 形式 format

POST /ee/v2/interact

リクエスト request

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "web.webpagedetails.pageViews",
         "web": {
            "webPageDetails": {
               "URL": "https://alloystore.dev/",
               "name": "home-demo-Home Page"
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      },
      "data": {
         "prop1": "custom value"
      }
   }
}'

パラメーター

タイプ

必須

説明

dataStreamId

String

はい。

データストリーム ID。

requestId

String

内部サーバーリクエストを関連付けるためのクライアントランダム ID を指定します。何も指定されない場合、Edge Network によって生成され、応答で返されます。

応答 response

応答が成功すると、データストリーム設定で有効になっているリアルタイムエッジサービスに応じて、HTTP ステータス 200 OK と 1 つ以上の Handle オブジェクトが返されます。

{
   "requestId": "c85402f5-83a1-4fb3-abdd-f4c17bf6dd49",
   "handle": []
}

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b