데이터 수집을 위한 데이터 준비
- 주제:
- 데이터스트림
작성 대상:
- 개발자
데이터 준비는 Experience Data Model(XDM)과의 데이터를 매핑, 변환 및 확인할 수 있는 Adobe Experience Platform 서비스입니다. Experience Platform 지원 데이터스트림을 구성할 때 Experience Platform Edge Network에 전송할 때 데이터 준비 기능을 사용하여 소스 데이터를 XDM에 매핑할 수 있습니다.
웹 페이지에서 전송된 모든 데이터는 Experience Platform에 XDM으로 도착해야 합니다. 3가지 방법으로 페이지 내 데이터 레이어의 데이터를 Experience Platform에서 허용하는 XDM으로 변환할 수 있습니다.
- 웹 페이지 자체에서 데이터 레이어를 XDM으로 다시 포맷합니다.
- 태그 기본 데이터 요소 기능을 사용하여 웹 페이지의 기존 데이터 레이어 형식을 XDM으로 다시 지정합니다.
- 데이터 수집을 위한 데이터 준비를 사용하여 Edge Network을 통해 웹 페이지의 기존 데이터 레이어 형식을 XDM으로 다시 지정합니다.
이 안내서는 세 번째 옵션에 중점을 둡니다.
데이터 수집을 위해 데이터 준비를 사용해야 하는 경우
데이터 수집을 위한 데이터 준비가 유용한 두 가지 사용 사례가 있습니다.
- 웹 사이트에는 잘 구성되고, 관리되고, 유지되는 데이터 레이어가 있으며, JavaScript 조작을 사용하여 페이지에서 XDM으로 변환하는 대신(태그 데이터 요소를 통해 또는 수동으로 JavaScript 조작을 통해) Edge Network으로 직접 전송하는 것이 좋습니다.
- 태그 이외의 태그 지정 시스템이 사이트에 배포됩니다.
WebSDK를 통해 Edge Network에 기존 데이터 레이어 보내기
기존 데이터 레이어는 sendEvent
명령 내에서 data
개체를 사용하여 보내야 합니다.
태그를 사용하는 경우 Web SDK 태그 확장 설명서에 설명된 대로 이벤트 보내기 작업 유형의 데이터 필드를 사용해야 합니다.
이 안내서의 나머지 부분에서는 WebSDK에서 데이터 레이어를 전송한 후 XDM 표준에 매핑하는 방법에 중점을 둡니다.
이 안내서에는 UI에서 데이터를 매핑하는 방법을 설명합니다. 단계와 함께 팔로우하려면 기본 구성 단계까지(이를 포함) 데이터스트림을 생성하는 프로세스를 시작합니다.
데이터 수집 프로세스에 대한 데이터 준비 데모를 빠르게 보려면 다음 비디오를 참조하십시오.
데이터 선택
데이터스트림에 대한 기본 구성을 완료한 후 매핑 저장 및 추가 를 선택하면 데이터 선택 단계가 표시됩니다. 여기에서 Experience Platform으로 전송할 예정인 데이터의 구조를 나타내는 샘플 JSON 개체를 제공해야 합니다.
데이터 계층에서 바로 속성을 캡처하려면 JSON 오브젝트에는 단일 루트 속성이 있어야 합니다data
. 그런 다음 캡처할 데이터 레이어 속성에 매핑되는 방식으로 data
개체의 하위 속성을 구성해야 합니다. 아래 섹션을 선택하여 data
루트로 형식이 제대로 지정된 JSON 오브젝트의 예제를 확인합니다.
data
루트가 포함된 샘플 JSON 파일{
"data": {
"eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
"eventType": "view:load",
"timestamp": "2021-09-30T14:50:09.604Z",
"web": {
"webPageDetails": {
"siteSection": "Product section",
"server": "example.com",
"name": "product home",
"URL": "https://www.example.com"
},
"webReferrer": {
"URL": "https://www.adobe.com/index2.html",
"type": "external"
}
},
"commerce": {
"purchase": 1,
"order": {
"orderID": "1234"
}
},
"product": [
{
"productInfo": {
"productID": "123"
}
},
{
"productInfo": {
"productID": "1234"
}
}
],
"reservation": {
"id": "anc45123xlm",
"name": "Embassy Suits",
"SKU": "12345-L",
"skuVariant": "12345-LG-R",
"priceTotal": "112.99",
"currencyCode": "USD",
"adults": 2,
"children": 3,
"productAddMethod": "PDP",
"_namespace": {
"test": 1,
"priceTotal": "112.99",
"category": "Overnight Stay"
},
"freeCancellation": false,
"cancellationFee": 20,
"refundable": true
}
}
}
XDM 오브젝트 데이터 요소에서 속성을 캡처하려면 동일한 규칙이 JSON 오브젝트에 적용되지만 루트 속성은 대신 xdm
으로 입력되어야 합니다. 아래 섹션을 선택하여 xdm
루트로 형식이 제대로 지정된 JSON 오브젝트의 예제를 확인합니다.
xdm
루트가 포함된 샘플 JSON 파일{
"xdm": {
"environment": {
"type": "browser",
"browserDetails": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
"javaScriptEnabled": true,
"javaScriptVersion": "1.8.5",
"cookiesEnabled": true,
"viewportHeight": 900,
"viewportWidth": 1680,
"javaEnabled": true
},
"domain": "adobe.com",
"colorDepth": 24,
"viewportHeight": 1050,
"viewportWidth": 1680
},
"device": {
"screenHeight": 1050,
"screenWidth": 1680
}
}
}
옵션을 선택하여 오브젝트를 파일로 업로드하거나 원시 오브젝트를 대신 제공된 텍스트 상자에 붙여넣을 수 있습니다. JSON이 유효한 경우 오른쪽 패널에 미리보기 스키마가 표시됩니다. 계속하려면 다음 을 선택합니다.
매핑
소스 데이터의 필드를 Experience Platform의 대상 이벤트 스키마의 필드에 매핑할 수 있는 매핑 단계가 나타납니다. 여기서 두 가지 방법으로 매핑을 구성할 수 있습니다.
- 수동 프로세스를 통해 이 데이터 스트림에 대한 매핑 규칙을 만듭니다.
- 기존 데이터스트림에서 매핑 규칙을 가져옵니다.
identityMap
XDM 페이로드를 무시하며, 이는 Real-Time CDP 대상에 대한 프로필 일치에 더 영향을 줄 수 있습니다.매핑 규칙 만들기
매핑 규칙을 만들려면 새 매핑 추가 를 선택합니다.
소스 아이콘(
다음으로 스키마 아이콘(
완료된 필드 매핑이 표시되면 매핑 페이지가 다시 나타납니다. 매핑이 완료된 총 필드 수를 반영하도록 매핑 프로세스 섹션이 업데이트됩니다.
[*]
을 추가합니다.
기존 매핑 규칙 가져오기
이전에 데이터스트림을 생성한 경우 구성된 매핑 규칙을 새 데이터스트림에 대해 재사용할 수 있습니다.
시작하려면 매핑 가져오기 를 선택합니다.
표시되는 대화 상자에서 가져오려는 매핑 규칙이 있는 데이터스트림을 선택합니다. 데이터스트림이 선택되면 미리보기 를 선택합니다.
다음 화면에는 선택한 데이터스트림에 대해 저장된 매핑 규칙의 미리보기가 표시됩니다. 표시된 매핑이 예상한 매핑인지 확인한 다음 가져오기 를 선택하여 매핑을 확인하고 새 데이터스트림에 추가합니다.
매핑 완료
위 단계를 따라 나머지 필드를 대상 스키마에 계속 매핑합니다. 사용 가능한 모든 소스 필드를 매핑할 필요는 없지만 필요에 따라 설정된 대상 스키마의 모든 필드를 매핑해야 이 단계를 완료할 수 있습니다. 필수 필드 카운터는 아직 현재 구성에 매핑되지 않은 필수 필드의 수를 표시합니다.
필수 필드 수가 0에 도달하고 매핑에 만족하면 저장 을 선택하여 변경 내용을 완료합니다.
다음 단계
이 안내서에서는 UI에서 데이터스트림 설정 시 데이터를 XDM에 매핑하는 방법이 나와 있습니다. 일반 데이터스트림 튜토리얼을 참조하는 경우 이제 데이터스트림 세부 정보 보기 단계로 돌아갈 수 있습니다.