Analytics 데이터 수집 및 매핑

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

초급
중간
개발자

모바일 데이터를 Adobe Analytics에 매핑하는 방법을 알아봅니다.

이전 단원에서 수집하여 Platform Edge Network으로 전송한 event 데이터는 Adobe Analytics을 포함하여 데이터스트림에 구성된 서비스로 전달됩니다. 데이터를 보고서 세트의 올바른 변수에 매핑합니다.

아키텍쳐

전제 조건

ExperienceEvent 추적에 대한 이해.
샘플 앱에서 XDM 데이터를 성공적으로 보냈습니다.
이 단원에 사용할 수 있는 Adobe Analytics 보고서 세트입니다.

학습 목표

이 단원에서는 다음 작업을 수행합니다.

Adobe Analytics 서비스로 데이터 스트림을 구성합니다.
Analytics 변수의 자동 매핑을 이해합니다.
XDM 데이터를 Analytics 변수에 매핑하는 처리 규칙을 설정합니다.

Adobe Analytics 데이터스트림 서비스 추가

Edge Network에서 Adobe Analytics으로 XDM 데이터를 전송하려면 데이터 스트림 만들기의 일부로 설정한 데이터 스트림에 Adobe Analytics 서비스를 구성합니다.

데이터 수집 UI에서 데이터스트림 및 데이터스트림을 선택합니다.
서비스 추가 를 선택합니다.
서비스 목록에서 Adobe Analytics 추가,
보고서 세트 ID 에서 사용할 Adobe Analytics의 보고서 세트 이름을 입력하십시오.
사용 을(를) 전환하여 서비스를 사용하도록 설정하십시오.
저장 을 선택합니다.

자동 매핑

대부분의 표준 XDM 필드는 Analytics 변수에 자동으로 매핑됩니다. 전체 목록은 여기에서 확인하십시오.

예 #1 - s.products

처리 규칙을 사용하여 채울 수 없는 products 변수이(가) 좋은 예입니다. XDM 구현을 사용하면 productListItems에 필요한 모든 데이터를 전달하고 s.products은(는) Analytics 매핑을 통해 자동으로 채워집니다.

이 개체:

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

결과 위치:

s.products = ";5829;1;49.99,9841;3;30.00"

NOTE

productListItems[].SKU과(와) productListItems[].name이(가) 모두 데이터를 포함하는 경우 productListItems[].SKU의 값이 사용됩니다. 자세한 내용은 Adobe Experience Edge의 Analytics 변수 매핑을 참조하십시오.

예 #2 - scAdd

자세히 살펴보면 모든 이벤트에는 두 개의 필드 value(필수)과 id(선택 사항)이 있습니다. value 필드는 이벤트 수를 늘리는 데 사용됩니다. id 필드는 serialization에 사용됩니다.

이 개체:

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

결과 위치:

s.events = "scAdd"

이 개체:

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

결과 위치:

s.events = "scAdd:321435"

Assurance를 사용한 유효성 검사

Assurance을(를) 사용하여 경험 이벤트를 보내고 있으며 XDM 데이터가 올바르고 Analytics 매핑이 예상대로 발생하고 있는지 확인할 수 있습니다.

설치 지침 섹션을 검토하여 시뮬레이터 또는 장치를 Assurance에 연결하십시오.
productListAdds 이벤트를 보냅니다(장바구니에 제품 추가).
ExperienceEvent 히트를 봅니다.

JSON의 XDM 부분을 검토합니다.

code language-json

code language-json
`"xdm" : { "productListItems" : [ { "SKU" : "LLWS05.1-XS", "name" : "Desiree Fitness Tee", "priceTotal" : 24 } ], "timestamp" : "2023-08-04T12:53:37.662Z", "eventType" : "commerce.productListAdds", "commerce" : { "productListAdds" : { "value" : 1 } } // ...`

"xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

analytics.mapping 이벤트를 검토하십시오.

Analytics 매핑에서 다음을 참고하십시오.

이벤트 은(는) commerce.productListAdds을(를) 기준으로 scAdd(으)로 채워집니다.
pl(products 변수)은 productListItems을(를) 기반으로 연결된 값으로 채워집니다.
모든 컨텍스트 데이터를 포함하여 이 이벤트에는 다른 흥미로운 정보가 있습니다.

컨텍스트 데이터로 매핑

Analytics로 전달된 XDM 데이터는 표준 및 사용자 지정 필드를 모두 포함하는 컨텍스트 데이터(으)로 변환됩니다.

컨텍스트 데이터 키는 다음 구문에 따라 구성됩니다.

a.x.[xdm path]

예:

// Standard Field
a.x.commerce.saveforlaters.value

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname

NOTE

사용자 정의 필드는 Experience Cloud 조직 식별자 아래에 위치합니다.

_techmarketingdemos이(가) 조직의 고유 값으로 대체되었습니다.

이 XDM 컨텍스트 데이터를 보고서 세트의 Analytics 데이터에 매핑하려면 다음을 수행할 수 있습니다.

필드 그룹 사용

Adobe Analytics ExperienceEvent 전체 확장 필드 그룹을 스키마에 추가합니다.
이벤트 데이터 추적 단원에서 수행한 작업과 유사한 Adobe Analytics ExperienceEvent 전체 확장 필드 그룹에 따라 앱에서 XDM 페이로드를 빌드하거나
규칙 작업을 사용하여 Adobe Analytics ExperienceEvent 전체 확장 필드 그룹에 데이터를 첨부하거나 수정하는 규칙을 Tags 속성에 작성합니다. 자세한 내용은 SDK 이벤트에 데이터 첨부 또는 SDK 이벤트에서 데이터 수정을 참조하십시오.

머천다이징 eVar

예를 들어 Analytics 설정에서 머천다이징 eVar을(를) 사용하여 &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60과(와) 같은 제품의 색상을 캡처하는 경우 이벤트 데이터 추적에서 정의한 XDM 페이로드를 확장하여 해당 머천다이징 정보를 캡처해야 합니다.

JSON에서:

code language-json

code language-json
`{ "productListItems": [ { "SKU": "LLWS05.1-XS", "name": "Desiree Fitness Tee", "priceTotal": 24, "_experience": { "analytics": { "events1to100": { "event10": { "value": 50 } }, "customDimensions": { "eVars": { "eVar1": "red", } } } } } ], "eventType": "commerce.productListAdds", "commerce": { "productListAdds": { "value": 1 } } }`

{
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

코드에서:

code language-swift

code language-swift
`var xdmData: [String: Any] = [ "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "_experience" : [ "analytics": [ "events1to100": [ "event10": [ "value:": value ] ], "customDimensions": [ "eVars": [ "eVar1": color ] ] ] ] ] ], "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]`

var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

처리 규칙 사용

다음은 이 데이터를 사용하는 처리 규칙의 모습입니다.

값(1) 앱 화면 이름(eVar2)(2)을 값 a.x._techmarketingdemo.appstatedetails.screenname(3)으로 덮어씁니다(a.x._techmarketingdemo.appinformation.appstatedetails.screenname(4) 이(가) 설정된 경우(5)).
이벤트를 설정 (6) 위시리스트에 추가(이벤트 3) (7)을(를) a.x.commerce.saveForLaters.value(컨텍스트) (8) a.x.commerce.saveForLaters.value(컨텍스트) (9) 이(가) 설정된 경우 (10).

분석 처리 규칙

IMPORTANT

자동으로 매핑된 변수 중 일부는 처리 규칙에서 사용하지 못할 수 있습니다.

처리 규칙에 처음 매핑하면 XDM 객체의 컨텍스트 데이터 변수가 인터페이스에 표시되지 않습니다. 이 문제를 해결하려면 를 저장하고 다시 편집하십시오. 이제 모든 XDM 변수가 표시됩니다.

처리 규칙 및 컨텍스트 데이터에 대한 추가 정보는 여기에서 찾을 수 있습니다.

TIP

이전 모바일 앱 구현과 달리 페이지/화면 보기와 다른 이벤트 사이에는 차이가 없습니다. 대신 처리 규칙에서 페이지 이름 차원을 설정하여 페이지 보기 지표를 증가시킬 수 있습니다. 자습서에서 사용자 지정 screenName 필드를 수집하므로 처리 규칙에서 화면 이름을 페이지 이름 에 매핑하는 것이 좋습니다.

Analytics 모바일 확장에서 마이그레이션

Adobe Analytics 모바일 확장을 사용하여 모바일 애플리케이션을 개발한 경우 MobileCore.trackAction 및 MobileCore.trackState API 호출을 사용했을 가능성이 높습니다.

권장 Edge Network을 사용하도록 마이그레이션하기로 결정하는 경우 다음과 같은 옵션이 있습니다.

Edge Network 데이터 추적 방법에 대한 단원에서 설명한 대로 이벤트 확장을 구현하고 Edge.sendEvent API를 사용합니다. 이 자습서에서는 이 구현에 중점을 둡니다.
Edge Bridge 확장을 구현하고 MobileCore.trackAction 및 MobileCore.trackState API 호출을 계속 사용합니다. 자세한 내용 및 별도의 자습서는 Edge Bridge 확장 구현을 참조하십시오.

SUCCESS

앱을 설정하여 Experience Edge XDM 개체를 Adobe Analytics 변수에 매핑합니다. 이 변수는 데이터스트림에서 Adobe Analytics 서비스를 활성화하고 가능한 경우 처리 규칙을 사용합니다.
Adobe Experience Platform Mobile SDK에 대해 학습하는 데 시간을 투자해 주셔서 감사합니다. 질문이 있거나 일반적인 피드백을 공유하고 싶거나 향후 콘텐츠에 대한 제안이 있는 경우 이 Experience League 커뮤니티 토론 게시물에서 공유하십시오.

다음: Experience Platform에게 데이터 보내기

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b