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

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

Last update: Wed Dec 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Server API

作成対象：

Developer

概要 overview

非インタラクティブなイベントデータ収集エンドポイントは、複数のイベントをExperience Platformデータセットや他のアウトレットに送信するために使用されます。

エンドユーザーのイベントが短時間ローカルのキューに入れられる場合（ネットワークに接続されていない場合など）は、イベントをバッチで送信することをお勧めします。

バッチイベントは、必ずしも同じエンドユーザーに属しているわけではありません。つまり、イベントは、イベント内で異なる ID を保持できます identityMap オブジェクト。

非インタラクティブ API 呼び出しの例 example

API 形式 api-format

POST /ee/v2/collect

リクエスト request

curl -X POST "https://server.adobedc.net/ee/v2/collect?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 '{
   "events": [
      {
         "xdm": {
            "identityMap": {
               "FPID": [
                  {
                     "id": "79bf8e83-f708-414b-b1ed-5789ff33bf0b",
                     "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"
         }
      },
      {
         "xdm": {
            "identityMap": {
               "FPID": [
                  {
                     "id": "871e8460-a329-4e96-a5b6-ff359fb0afb9",
                     "primary": "true"
                  }
               ]
            },
            "eventType": "web.webinteraction.linkClicks",
            "web": {
               "webInteraction": {
                  "linkClicks": {
                     "value": 1
                  }
               },
               "name": "My Custom Link",
               "URL": "https://myurl.com"
            },
            "timestamp": "2021-08-09T14:09:20.859Z"
         }
      }
   ]
}'

パラメーター

タイプ

必須

説明

dataStreamId

String

○

データ収集エンドポイントで使用されるデータストリームの ID。

requestId

String

外部リクエストトレース ID を指定します。何も指定されない場合、Edge ネットワークはユーザーに代わって 1 つを生成し、応答の本文/ヘッダーに返します。

silent

Boolean

Edge ネットワークが 204 No Content 空のペイロードを含む応答、または含まない応答。重大なエラーは、対応する HTTP ステータスコードとペイロードを使用して報告されます。

応答 response

正常な応答は、次のステータスのいずれかと、 requestID リクエストで何も指定されていない場合。

202 Accepted リクエストが正常に処理されたとき。
204 No Content リクエストが正常に処理され、 silent パラメータがに設定されました： true;
400 Bad Request リクエストの形式が正しくなかった場合（必須のプライマリ id が見つからなかった場合など）。

{
  "requestId": "f567a988-4b3c-45a6-9ed8-f283188a445e"
}

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b