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

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

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

이 안내서에서는 세 번째 옵션을 다룹니다.

데이터 수집을 위해 데이터 준비를 사용해야 하는 경우 when-to-use-data-prep

데이터 수집을 위한 데이터 준비는 다음 두 가지 상황에서 유용합니다.

Web SDK을 통해 기존 데이터 레이어를 Edge Network으로 전송 send-datalayer-via-websdk

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

Tags을(를) 사용하는 경우 Send Event 작업 유형의 Data 필드를 사용해야 합니다.

이 안내서의 나머지 부분에서는 웹 SDK에서 데이터 레이어를 보낸 후 XDM 표준에 매핑하는 방법을 다룹니다.

이 안내서에는 UI에서 데이터를 매핑하는 방법을 설명합니다. 단계를 완료하려면 기본 구성 단계까지 데이터 스트림을 만드는 프로세스를 시작하십시오.

데이터 수집을 위한 데이터 준비 프로세스에 대한 빠른 데모는 다음 비디오를 참조하십시오.

샘플 데이터 제공 select-data

데이터 스트림에 대한 기본 구성을 완료한 후 Save and Add Mapping​을(를) 선택하면 Select data 단계가 나타납니다. 여기에서 Experience Platform으로 전송할 예정인 데이터의 구조를 나타내는 샘플 JSON 개체를 제공해야 합니다.

데이터 계층에서 바로 속성을 캡처하려면 JSON 오브젝트에는 단일 루트 속성이 있어야 합니다data. 그런 다음 캡처할 데이터 레이어 속성에 매핑되는 방식으로 data 개체의 하위 속성을 구성해야 합니다. 아래 섹션을 선택하여 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": {
    "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이 유효한 경우 오른쪽 패널에 미리보기 스키마가 표시됩니다. 계속하려면 Next​을(를) 선택하십시오.

데이터 매핑 mapping

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

매핑 규칙 만들기 create-mapping

매핑 규칙을 만들려면 Add new mapping​을(를) 선택합니다.

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

그런 다음 스키마 아이콘( )을 선택하여 대상 이벤트 스키마에 대한 유사한 대화 상자를 엽니다. Select(으)로 확인하기 전에 데이터를 매핑할 필드를 선택하십시오.

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

TIP

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

기존 매핑 규칙 가져오기 import-mapping

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

시작하려면 Import Mapping​을(를) 선택하십시오.

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

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

매핑 완료 complete-mapping

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

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

다음 단계 next-steps

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