설명서Experience Platform데이터스트림 안내서

데이터 수집을 위한 데이터 준비

마지막 업데이트: 2025년 5월 5일
  • 주제:
  • 데이터스트림

작성 대상:

  • 개발자

데이터 준비는 Experience Data Model(XDM)과의 데이터를 매핑, 변환 및 확인할 수 있는 Adobe Experience Platform 서비스입니다. Experience Platform 지원 데이터스트림을 구성할 때 Experience Platform Edge Network에 전송할 때 데이터 준비 기능을 사용하여 소스 데이터를 XDM에 매핑할 수 있습니다.

웹 페이지에서 전송된 모든 데이터는 Experience Platform에 XDM으로 도착해야 합니다. 3가지 방법으로 페이지 내 데이터 레이어의 데이터를 Experience Platform에서 허용하는 XDM으로 변환할 수 있습니다.

  1. 웹 페이지 자체에서 데이터 레이어를 XDM으로 다시 포맷합니다.
  2. 태그 기본 데이터 요소 기능을 사용하여 웹 페이지의 기존 데이터 레이어 형식을 XDM으로 다시 지정합니다.
  3. 데이터 수집을 위한 데이터 준비를 사용하여 Edge Network을 통해 웹 페이지의 기존 데이터 레이어 형식을 XDM으로 다시 지정합니다.

이 안내서는 세 번째 옵션에 중점을 둡니다.

데이터 수집을 위해 데이터 준비를 사용해야 하는 경우

데이터 수집을 위한 데이터 준비가 유용한 두 가지 사용 사례가 있습니다.

  1. 웹 사이트에는 잘 구성되고, 관리되고, 유지되는 데이터 레이어가 있으며, JavaScript 조작을 사용하여 페이지에서 XDM으로 변환하는 대신(태그 데이터 요소를 통해 또는 수동으로 JavaScript 조작을 통해) Edge Network으로 직접 전송하는 것이 좋습니다.
  2. 태그 이외의 태그 지정 시스템이 사이트에 배포됩니다.

WebSDK를 통해 Edge Network에 기존 데이터 레이어 보내기

기존 데이터 레이어는 sendEvent 명령 내에서 data 개체를 사용하여 보내야 합니다.

태그를 사용하는 경우 Web SDK 태그 확장 설명서에 설명된 대로 이벤트 보내기 작업 유형의 데이터 필드를 사용해야 합니다.

이 안내서의 나머지 부분에서는 WebSDK에서 데이터 레이어를 전송한 후 XDM 표준에 매핑하는 방법에 중점을 둡니다.

NOTE
계산된 필드의 변환 기능을 포함하여 모든 데이터 준비 기능에 대한 포괄적인 지침은 다음 설명서를 참조하십시오.
  • 데이터 준비 개요
  • 데이터 준비 매핑 기능
  • 데이터 준비로 데이터 포맷 처리

이 안내서에는 UI에서 데이터를 매핑하는 방법을 설명합니다. 단계와 함께 팔로우하려면 기본 구성 단계까지(이를 포함) 데이터스트림을 생성하는 프로세스를 시작합니다.

데이터 수집 프로세스에 대한 데이터 준비 데모를 빠르게 보려면 다음 비디오를 참조하십시오.

video poster

https://video.tv.adobe.com/v/345567?quality=12&enable10seconds=on&speedcontrol=on&captions=kor

데이터 선택

데이터스트림에 대한 기본 구성을 완료한 후 매핑 저장 및 추가 ​를 선택하면 데이터 선택 단계가 표시됩니다. 여기에서 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이 유효한 경우 오른쪽 패널에 미리보기 스키마가 표시됩니다. 계속하려면 다음 ​을 선택합니다.

수신 데이터의 JSON 샘플입니다.

NOTE
모든 페이지에서 사용할 수 있는 모든 데이터 레이어 요소를 나타내는 샘플 JSON 개체를 사용합니다. 예를 들어 모든 페이지에서 장바구니 데이터 계층 요소를 사용하는 것은 아닙니다. 그러나 장바구니 데이터 계층 요소는 이 샘플 JSON 개체에 포함되어야 합니다.

매핑

소스 데이터의 필드를 Experience Platform의 대상 이벤트 스키마의 필드에 매핑할 수 있는 매핑 단계가 나타납니다. 여기서 두 가지 방법으로 매핑을 구성할 수 있습니다.

  • 수동 프로세스를 통해 이 데이터 스트림에 대한 매핑 규칙을 만듭니다.
  • 기존 데이터스트림에서 매핑 규칙을 가져옵니다.
IMPORTANT
데이터 준비 매핑은 identityMap XDM 페이로드를 무시하며, 이는 Real-Time CDP 대상에 대한 프로필 일치에 더 영향을 줄 수 있습니다.

매핑 규칙 만들기

매핑 규칙을 만들려면 새 매핑 추가 ​를 선택합니다.

새 매핑을 추가합니다.

소스 아이콘( 소스 아이콘 )을 선택하고 표시되는 대화 상자에서 제공된 캔버스에서 매핑하려는 소스 필드를 선택합니다. 필드가 선택되면 선택 버튼을 사용하여 계속합니다.

원본 스키마에서 매핑할 필드를 선택합니다.

다음으로 스키마 아이콘( 스키마 아이콘 )을 선택하여 대상 이벤트 스키마에 유사한 대화 상자를 엽니다. 선택 ​을 사용하여 확인 전에 데이터를 매핑하려는 필드를 선택합니다.

대상 스키마에서 매핑할 필드를 선택합니다.

완료된 필드 매핑이 표시되면 매핑 페이지가 다시 나타납니다. 매핑이 완료된 총 필드 수를 반영하도록 매핑 프로세스 섹션이 업데이트됩니다.

진행률이 반영된 필드가 정상적으로 매핑되었습니다.

TIP
(소스 필드의) 오브젝트 배열을 (대상 필드의) 다른 오브젝트 배열에 매핑하려면 아래와 같이 소스 및 대상 필드 경로에서 배열 이름 다음에 [*]을 추가합니다.
배열 개체 매핑.

기존 매핑 규칙 가져오기

이전에 데이터스트림을 생성한 경우 구성된 매핑 규칙을 새 데이터스트림에 대해 재사용할 수 있습니다.

WARNING
다른 데이터 스트림에서 매핑 규칙을 가져오면 가져오기 전에 추가했을 수 있는 필드 매핑을 덮어씁니다.

시작하려면 매핑 가져오기 ​를 선택합니다.

매핑 가져오기 단추가 선택되어 있습니다.

표시되는 대화 상자에서 가져오려는 매핑 규칙이 있는 데이터스트림을 선택합니다. 데이터스트림이 선택되면 미리보기 ​를 선택합니다.

기존 데이터 스트림을 선택합니다.

NOTE
데이터스트림은 동일한 샌드박스 내에서만 가져올 수 있습니다. 다시 말해, 한 샌드박스에서 다른 샌드박스로 데이터스트림을 가져올 수 없습니다.

다음 화면에는 선택한 데이터스트림에 대해 저장된 매핑 규칙의 미리보기가 표시됩니다. 표시된 매핑이 예상한 매핑인지 확인한 다음 가져오기 ​를 선택하여 매핑을 확인하고 새 데이터스트림에 추가합니다.

가져올 매핑 규칙입니다.

NOTE
가져온 매핑 규칙의 소스 필드가 이전에 제공한 샘플 JSON 데이터에 포함되지 않은 경우 해당 필드 매핑은 가져오기에 포함되지 않습니다.

매핑 완료

위 단계를 따라 나머지 필드를 대상 스키마에 계속 매핑합니다. 사용 가능한 모든 소스 필드를 매핑할 필요는 없지만 필요에 따라 설정된 대상 스키마의 모든 필드를 매핑해야 이 단계를 완료할 수 있습니다. 필수 필드 카운터는 아직 현재 구성에 매핑되지 않은 필수 필드의 수를 표시합니다.

필수 필드 수가 0에 도달하고 매핑에 만족하면 저장 ​을 선택하여 변경 내용을 완료합니다.

매핑 완료

다음 단계

이 안내서에서는 UI에서 데이터스트림 설정 시 데이터를 XDM에 매핑하는 방법이 나와 있습니다. 일반 데이터스트림 튜토리얼을 참조하는 경우 이제 데이터스트림 세부 정보 보기 단계로 돌아갈 수 있습니다.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac