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

Adobe Analytics과 상호 작용

Last update: Tue Mar 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Server API

작성 대상:

Developer

개요 overview

Adobe Analytics 데이터 수집은 XDM 데이터를 Adobe Analytics이 이해할 수 있는 형식으로 변환하여 작동합니다. 여러 XDM 필드는 다음과 같습니다 자동으로 매핑됨 Analytics 변수에 XDM 값을 이전 Analytics 변수에 수동으로 매핑할 수도 있습니다.

Adobe Analytics이 서버 API에서 데이터를 수신하도록 하려면 다음을 수행해야 합니다 데이터스트림 구성 이벤트를 Adobe Analytics에 전달하려면 데이터 스트림 구성 페이지에 보고서 세트 ID를 입력합니다.

Adobe Analytics 데이터 스트림 구성

Adobe Analytics과 상호 작용 interacting-analytics

API 형식 format

POST /ee/v2/interact?dataStreamId={DATASTREAM_ID}

요청 request

아래 샘플에는 _experience.analytics 필드 그룹입니다. JSON 기반 데이터 계층도 포함됩니다. 이러한 데이터 계층은 자동으로 매핑될 수 없지만 데이터 수집을 위한 데이터 준비 위에서 참조한 필드 그룹을 포함하는 스키마에 이러한 값을 매핑합니다.

사용자가 해당 필드에 매핑하는 모든 값은 API 요청에 포함된 것처럼 적절한 Analytics 값에 자동으로 매핑됩니다.

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": {
         "eventType": "web.webpagedetails.pageViews",
         "web": {
            "webPageDetails": {
               "URL": "https://alloystore.dev",
               "name": "Home Page"
            },
            "webReferrer": {
               "URL": ""
            }
         },
         "device": {
            "screenHeight": 1440,
            "screenWidth": 3440,
            "screenOrientation": "landscape"
         },
         "environment": {
            "type": "browser",
            "browserDetails": {
               "viewportWidth": 3440,
               "viewportHeight": 1440
            }
         },
         "placeContext": {
            "localTime": "2022-03-22T22:45:21.193-06:00",
            "localTimezoneOffset": 360
         },
         "timestamp": "2022-03-23T04:45:21.193Z",
         "implementationDetails": {
            "name": "https://ns.adobe.com/experience/alloy/reactor",
            "version": "2.8.0+2.9.0",
            "environment": "browser"
         },
         "_experience": {
            "analytics": {
               "customDimensions": {
                  "eVars": {
                     "eVar14": "eVar14"
                  }
               },
               "event1to100": {
                  "event13": {
                     "value": 1
                  },
                  "event14": {
                     "value": 2
                  }
               }
            }
         }
      }
   },
   "data": {
      "page": {
         "pageInfo": {
            "pageName": "Promotions",
            "siteSection": "Home"
         },
         "promos": {
            "heroPromos": "purse,shoes,sunglasses"
         },
         "customVariables": {
            "testGroup": "orange/black theme"
         },
         "events": {
            "homePage": true
         },
         "products": [
            {
               "productSKU": "abc123",
               "productName": "shirt"
            }
         ]
      }
   }
}'

응답 response

{
   "requestId": "d2ad6364-5675-4a86-ba41-50e7a4c4a299",
   "handle": []
}

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b