Show Menu
화제×

데이터 준비 Intelligent Services

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

워크플로우 요약

준비 프로세스는 데이터가 Adobe Experience Platform에 저장되는지 외부적으로 저장되는지에 따라 달라집니다. 이 섹션에서는 두 가지 시나리오에서 수행해야 하는 필수 단계를 요약합니다.

외부 데이터 준비

데이터가 외부에 저장되는 Experience Platform경우 아래 절차를 따르십시오.
  1. 전용 Azure Blob 저장소 컨테이너에 대한 액세스 자격 증명을 요청하려면 Adobe 컨설팅 서비스에 문의하십시오.
  2. 액세스 자격 증명을 사용하여 데이터를 Blob 컨테이너에 업로드합니다.
  3. Adobe 컨설팅 서비스를 사용하여 데이터를 Consumer ExperienceEvent 스키마에 매핑하고 인제스트한 다음 Intelligent Services,

Experience Platform 데이터 준비

데이터가 이미 저장된 경우 아래 단계 Platform를 따르십시오.
  1. Consumer ExperienceEvent 스키마의 구조를 검토하고 데이터를 해당 필드에 매핑할 수 있는지 여부를 결정합니다.
  2. 데이터를 스키마에 매핑하고 인제스트하는 데 도움이 되도록 Adobe 컨설팅 서비스에 문의하거나, 데이터를 직접 매핑하려면 이 안내서의 Intelligent Services단계를 따르십시오 .

CEE 스키마 이해

Consumer ExperienceEvent 스키마는 디지털 마케팅 이벤트(웹 또는 모바일)뿐만 아니라 온라인 또는 오프라인 상거래 활동과 관련된 개인의 행동에 대해 설명합니다. 이 스키마의 의미상 잘 정의된 필드(열) Intelligent Services 때문에 데이터를 덜 명확하게 하는 알 수 없는 이름은 사용하지 않기 위해 이 스키마를 사용해야 합니다.
모든 XDM ExperienceEvent 스키마와 마찬가지로 CEE 스키마는 이벤트(또는 이벤트 집합)가 발생한 시점의 시간-시리즈 기반 시스템 상태를 캡처합니다(관련 대상의 ID 포함). 경험 이벤트는 발생한 사실에 대한 팩트 레코드이므로 변경할 수 없으며 집계 또는 해석 없이 발생한 사항을 나타냅니다.
Intelligent Services 이 스키마 내의 여러 주요 필드를 활용하여 마케팅 이벤트 데이터로부터 통찰력을 생성합니다. 이 모든 데이터는 루트 수준에서 찾을 수 있으며 필요한 하위 필드를 표시하도록 확장됩니다.
모든 XDM 스키마와 마찬가지로 CEE 믹스도 확장할 수 있습니다. 즉, CEE 믹스에 추가 필드를 추가할 수 있으며 필요한 경우 여러 스키마에 다른 변형을 포함시킬 수 있습니다.
믹싱의 전체 예는 공용 XDM 저장소에서 찾을 수 있습니다 . 또한 다음 JSON 파일을 보고 복사하여 CEE 스키마를 준수하도록 데이터를 구성하는 방법을 예로 들 수 있습니다. 사용자 자신의 데이터를 스키마에 매핑할 수 있는 방법을 결정하려면 아래 섹션에 나와 있는 키 필드에 대해 알 때 이러한 두 가지 예를 참조하십시오.

키 필드

CEE 믹스에는 유용한 인사이트를 생성하기 위해 활용해야 하는 몇 가지 주요 필드 Intelligent Services 가 있습니다. 이 섹션에서는 이러한 필드의 사용 사례와 예상 데이터에 대해 설명하고 추가 예제에 대한 참조 설명서에 대한 링크를 제공합니다.

필수 필드

모든 키 필드를 사용하는 것이 좋지만 다음 두 필드를 사용하는 것이 ​Intelligent Services 필요합니다.

기본 ID

스키마의 필드 중 하나를 기본 ID 필드로 설정해야 합니다. 이 필드는 시간 시리즈 데이터의 각 인스턴스 Intelligent Services 를 개별 사용자에게 연결할 수 있습니다.
데이터의 소스와 특성을 기반으로 기본 ID로 사용할 최상의 필드를 결정해야 합니다. ID 필드에는 필드가 값으로 기대하는 ID 데이터의 유형을 나타내는 ID 네임스페이스가 포함되어야 합니다. 일부 유효한 네임스페이스 값은 다음과 같습니다.
  • "이메일"
  • "phone"
  • "mcid"(Adobe Audience Manager ID용)
  • "aid"(Adobe Analytics ID용)
기본 ID로 사용해야 하는 필드를 잘 모르는 경우 Adobe 컨설팅 서비스에 문의하여 최상의 솔루션을 확인하십시오.

xdm:타임스탬프

이 필드는 이벤트가 발생한 날짜/시간을 나타냅니다. 이 값은 ISO 8601 표준에 따라 문자열로 제공해야 합니다.

xdm:채널

이 필드는 Attribution AI을 사용할 때만 필수입니다.
이 필드는 ExperienceEvent와 관련된 마케팅 채널을 나타냅니다. 이 필드에는 채널 유형, 미디어 유형 및 위치 유형에 대한 정보가 포함되어 있습니다.
스키마 예
{
  "@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
소유
클릭

권장 필드

키 필드의 나머지 부분은 이 섹션에 요약되어 있습니다. 이러한 필드를 반드시 Intelligent Services 사용해야 하는 것은 아니지만, 보다 풍부한 통찰력을 얻기 위해 가능한 한 많은 필드를 사용하는 것이 좋습니다.

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개월 데이터 기간 내에, 조회 기간으로 사용할 일 수는 포함되어야 Intelligent Services 합니다.
전송할 데이터 범위를 결정한 후 Adobe 컨설팅 서비스에 문의하여 스키마를 매핑하고 서비스에 데이터를 인제스트합니다.
구독을 보유하고 있고 직접 데이터를 매핑하고 인제스트하려면 아래 섹션에 설명된 단계를 따르십시오. Adobe Experience Platform

Adobe Experience Platform 사용

아래 단계는 Experience Platform에 가입해야 합니다. 플랫폼에 대한 액세스 권한이 없는 경우 다음 단계 섹션으로 건너뛸 수 있습니다.
이 섹션에서는 자세한 단계를 위한 자습서에 대한 링크를 Intelligent Services포함하여 사용할 수 있도록 데이터를 Experience Platform으로 매핑하고 인제스트하는 작업 과정을 간략하게 설명합니다.

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

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

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

향후 릴리스는 Intelligent Services Adobe Experience Platform ID 서비스 Identity Service개요 를 고객 식별 기능에 통합할 예정입니다. 따라서 아래 설명된 단계는 변경될 수 있습니다.
다른 외부 소스 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 스키마에 매핑하는 방법에 대한 자세한 내용은 자습서를 참조하십시오. 다음 샘플 JSON 파일을 사용하여 수집 프로세스를 테스트한 후 데이터를 사용할 수 있습니다.
데이터 세트를 채운 후에는 동일한 데이터 세트를 사용하여 추가 데이터 파일을 인제스트할 수 있습니다.
데이터가 지원되는 타사 애플리케이션에 저장되어 있는 경우 소스 커넥터를 만들어 마케팅 이벤트 데이터를 Platform 실시간으로 인제스트할 수도 있습니다.

다음 단계

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