Show Menu
화제×

지능형 서비스에서 사용할 데이터 준비

Intelligent Services가 마케팅 이벤트 데이터에서 얻은 통찰력을 얻으려면 데이터가 세밀하게 농축되어 표준 구조로 유지되어야 합니다. 지능형 서비스는 이를 달성하기 위해 XDM(Experience Data Model) 스키마를 활용합니다. 특히, Intelligent Services에서 사용되는 모든 데이터 세트는 CEE( Consumer ExperienceEvent) XDM 스키마를 따라야 합니다.
이 문서에서는 여러 채널에서 이 스키마로 마케팅 이벤트 데이터를 매핑하는 방법에 대한 일반적인 지침을 제공하며, 스키마 내의 중요한 필드에 대한 정보를 요약하여 데이터를 해당 구조에 효과적으로 매핑하는 방법을 결정하는 데 도움이 됩니다.

CEE 스키마 이해

Consumer ExperienceEvent 스키마는 디지털 마케팅 이벤트(웹 또는 모바일)뿐만 아니라 온라인 또는 오프라인 상거래 활동과 관련된 개인의 행동에 대해 설명합니다. 지능적인 서비스의 경우 이 스키마를 사용하는 것이 필요합니다. 이유는 의미상 잘 정의된 필드(열)가 있기 때문에 데이터를 더 명확하게 하는 알 수 없는 이름은 사용할 수 없습니다.
Intelligent Services는 이 스키마 내의 여러 주요 필드를 활용하여 마케팅 이벤트 데이터로부터 통찰력을 생성합니다. 이 모든 데이터는 루트 수준에서 찾을 수 있으며 필요한 하위 필드를 표시하도록 확장됩니다.
모든 XDM 스키마와 마찬가지로 CEE 믹스도 확장할 수 있습니다. 즉, CEE 믹스에 추가 필드를 추가할 수 있으며 필요한 경우 여러 스키마에 다른 변형을 포함시킬 수 있습니다.
믹싱의 전체 예는 공용 XDM 저장소에서 찾을 수 있으며 아래 섹션에 나와 있는 주요 필드에 대한 참조로 사용해야 합니다.

키 필드

아래의 섹션에서는 CEE 믹스에서 활용되어야 하는 주요 필드가 강조 표시되어 있으며, 이러한 주요 필드는 지능형 서비스가 유용한 통찰력을 도출하도록 하는데 여기에는 설명 및 참조 설명서에 대한 링크 등이 포함됩니다.
고객 AI에 필수 필드가 없는 반면 xdm:channel 속성 AI는 데이터 작업을 수행하려면 아래 첫 번째 섹션에 설명된 필드가 필요합니다. 다른 모든 키 필드는 권장되지만 필수는 아닙니다.

xdm:채널

이 필드는 ExperienceEvent와 관련된 마케팅 채널을 나타냅니다. 이 필드에는 채널 유형, 미디어 유형 및 위치 유형에 대한 정보가 포함되어 있습니다. 속성 AI가 데이터​__ ​와 연동되도록 하려면 이 필드를 제공해야 합니다.
스키마 예
{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

에 대한 각 필수 하위 필드에 대한 자세한 내용 xdm:channel 경험 채널 스키마 사양을 참조하십시오. 일부 예제 매핑은 아래 표를 참조하십시오 .

채널 매핑의 예

다음 표에서는 스키마에 매핑된 마케팅 채널의 몇 가지 예를 xdm:channel 제공합니다.
Channel
@type
mediaType
mediaAction
유료 검색
https:/ /ns.adobe.com/xdm/channel-types/search
paid
클릭
소셜 - 마케팅
https:/ /ns.adobe.com/xdm/channel-types/social
earned
클릭
표시
https:/ /ns.adobe.com/xdm/channel-types/display
paid
클릭
이메일
https:/ /ns.adobe.com/xdm/channel-types/email
paid
클릭
내부 레퍼러
https:/ /ns.adobe.com/xdm/channel-types/direct
소유
클릭
ViewThrough 표시
https:/ /ns.adobe.com/xdm/channel-types/display
paid
노출 횟수
QR 코드 리디렉션
https:/ /ns.adobe.com/xdm/channel-types/direct
소유
클릭
모바일
https:/ /ns.adobe.com/xdm/channel-types/mobile
소유
클릭

xdm:productListItems

이 필드는 제품 SKU, 이름, 가격 및 수량을 포함하여 고객이 선택한 제품을 나타내는 항목 배열입니다.
스키마 예
[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

에 대한 각 필수 하위 필드에 대한 자세한 내용 xdm:productListItems 상거래 세부 정보 스키마 사양을 참조하십시오.

xdm:커머스

이 필드에는 구매 발주 번호 및 지불 정보를 비롯하여 ExperienceEvent에 대한 상거래 관련 정보가 포함되어 있습니다.
스키마 예
{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

에 대한 각 필수 하위 필드에 대한 자세한 내용 xdm:commerce 상거래 세부 정보 스키마 사양을 참조하십시오.

xdm:웹

이 필드는 상호 작용, 페이지 세부 사항 및 레퍼러 등 ExperienceEvent와 관련된 웹 세부 사항을 나타냅니다.
스키마 예
{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

에 대한 각 필수 하위 필드에 대한 자세한 내용 xdm:productListItems ExperienceEvent 웹 세부 정보 스키마 사양을 참조하십시오.

xdm:마케팅

이 필드는 터치포인트에서 활성화된 마케팅 활동과 관련된 정보를 포함합니다.
스키마 예
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

에 대한 각 필수 하위 필드에 대한 자세한 내용 xdm:productListItems 마케팅 섹션 사양을 참조하십시오.

데이터 매핑 및 인제스트

마케팅 이벤트 데이터를 CEE 스키마에 매핑할 수 있는지 여부를 확인한 후, 다음 단계는 지능형 서비스에 가져올 데이터를 결정하는 것입니다. Intelligent Services에서 사용되는 모든 내역 데이터는 최소 4개월 데이터 기간 내에 포함되고, 조회 기간으로 의도한 일수는 포함되어야 합니다.
전송할 데이터 범위를 정한 후 Adobe 컨설팅 서비스에 문의하여 스키마에 데이터를 매핑하고 서비스에 인제스트합니다.
Adobe Experience Platform 구독을 보유하고 있고 데이터를 직접 매핑하고 인제스트하려면 아래 섹션에 설명된 단계를 따르십시오.

Adobe Experience Platform 사용

아래 단계에는 경험 플랫폼의 구독이 필요합니다. 플랫폼에 대한 액세스 권한이 없는 경우 다음 단계 섹션으로 건너뛸 수 있습니다.
이 섹션에서는 자세한 단계를 위한 튜토리얼에 대한 링크를 비롯하여 Adobe Experience Platform(지능형 서비스)에서 사용할 수 있도록 데이터를 매핑하고 인제스트하는 워크플로우에 대해 간략하게 설명합니다.

CEE 스키마 및 데이터 집합 만들기

데이터 섭취 준비를 시작할 준비가 되면 첫 번째 단계는 CEE 믹싱을 사용하는 새로운 XDM 스키마를 만드는 것입니다. 다음 자습서에서는 UI 또는 API에서 새 스키마를 만드는 프로세스를 안내합니다.
위의 자습서는 스키마를 만들기 위한 일반 작업 과정을 따릅니다. 스키마의 클래스를 선택할 때는 XDM ExperienceEvent 클래스를 사용해야 합니다 . 이 클래스가 선택되면 CEE 믹싱을 스키마에 추가할 수 있습니다.
스키마에 CEE 믹스를 추가한 후 데이터 내의 추가 필드에 대해 필요에 따라 다른 믹스를 추가할 수 있습니다.
스키마를 만들고 저장하면 해당 스키마를 기반으로 새 데이터 세트를 만들 수 있습니다. 다음 자습서에서는 UI 또는 API에서 새 데이터 세트를 만드는 과정을 설명합니다.

데이터 세트에 기본 ID 네임스페이스 태그 추가

Adobe Audience Manager, Adobe Analytics 또는 다른 외부 소스에서 데이터를 가져오는 경우 데이터 세트에 primaryIdentityNameSpace 태그를 추가해야 합니다. 이 작업은 카탈로그 서비스 API에 PATCH 요청을 수행하여 수행할 수 있습니다.
로컬 CSV 파일의 데이터를 인제스트하는 경우 데이터 매핑 및 인제스트 관련 다음 섹션으로 건너뛸 수 있습니다 .
API 형식
PATCH /dataSets/{DATASET_ID}

매개 변수
설명
{DATASET_ID}
이전에 만든 데이터 세트의 ID입니다.
요청
데이터를 수집하는 소스에 따라, 요청 페이로드에서 적절한 primaryIdentityNamespace sourceConnectorId 태그 값을 제공해야 합니다.
다음 요청은 Audience Manager에 적합한 태그 값을 추가합니다.
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

다음 요청은 Analytics에 적합한 태그 값을 추가합니다.
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

플랫폼에서 ID 네임스페이스를 사용한 작업에 대한 자세한 내용은 ID 네임스페이스 개요를 참조하십시오 .
응답
성공적인 응답은 업데이트된 데이터 세트의 ID가 포함된 배열을 반환합니다. 이 ID는 PATCH 요청에서 전송된 ID와 일치해야 합니다.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

데이터 매핑 및 인제스트

CEE 스키마 및 데이터 세트를 만든 후 데이터 테이블을 스키마에 매핑하고 해당 데이터를 플랫폼에 인제스트할 수 있습니다. UI에서 CSV 파일을 XDM 스키마에 매핑하는 방법에 대한 자세한 내용은 자습서를 참조하십시오. 데이터 세트를 채운 후에는 동일한 데이터 세트를 사용하여 추가 데이터 파일을 인제스트할 수 있습니다.
데이터가 지원되는 타사 애플리케이션에 저장되어 있는 경우 소스 커넥터를 만들어 마케팅 이벤트 데이터를 실시간으로 플랫폼에 인제스트하도록 할 수도 있습니다.

다음 단계

이 문서에서는 지능형 서비스에 사용할 데이터를 준비하는 방법에 대한 일반적인 지침을 제공합니다. 사용 사례에 따라 추가 컨설팅을 필요로 하는 경우 Adobe 컨설팅 지원에 문의하십시오.
데이터 세트에 고객 경험 데이터를 성공적으로 채우면 지능형 서비스를 사용하여 통찰력을 생성할 수 있습니다. 시작하려면 다음 문서를 참조하십시오.