文件 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資料集或其他插座。

當一般使用者事件在本地排入短時間佇列（例如沒有網路連線時）時，建議批次傳送事件。

批次事件不一定要屬於相同的一般使用者，這表示事件可以在其內包含不同的身分 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 Network會為您產生回應，並將其傳回至回應內文/標頭。

silent

Boolean

無

選用的布林值引數，指出Edge Network是否應傳回 204 No Content 是否以空白承載回應。使用對應的HTTP狀態代碼和承載來報告嚴重錯誤。

回應 response

成功的回應會傳回下列其中一種狀態，以及 requestID 若請求中未提供任何專案。

202 Accepted 成功處理要求時；
204 No Content 成功處理要求時，且 silent 引數已設為 true；
400 Bad Request 要求格式不正確時（例如，找不到必要的主要身分）。

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

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b