설명서 Experience Platform Edge Network Server API 설명서

대화형 데이터 수집

Last update: Tue Sep 19 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Server API

작성 대상:

Developer

개요 overview

대화형 데이터 수집 엔드포인트는 단일 이벤트를 수신하며, 클라이언트가 Adobe Experience Platform Edge Network 서버에서 응답이 반환될 것으로 예상할 때 사용됩니다. 이러한 엔드포인트는 데이터 수집을 수행하는 동안 다른 Edge Network 서비스에서 콘텐츠를 반환할 수도 있습니다.

서버 응답에는 하나 이상이 포함됩니다 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, 하나 이상 포함 Handle 객체(데이터 스트림 구성에서 활성화된 실시간 에지 서비스에 따라 다름)

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

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b