설명서Experience Platform데이터 수집

상거래, 제품 및 주문 정보 수집

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

조직에서 제품 또는 서비스를 판매하는 경우 이 페이지를 해당 제품 및 서비스를 추적하는 방법에 대한 안내서로 사용할 수 있습니다.

이 페이지에서는 XDM Commerce 스키마 필드 그룹을 사용합니다.

이 필드 그룹은 다음 두 가지 주요 부분으로 구성됩니다.

  • commerce 개체입니다. 이 개체를 사용하면 productListItems 배열에 발생하는 작업을 나타낼 수 있습니다.
  • productListItems 배열입니다.
TIP
Adobe Analytics에 익숙한 경우 commerce 개체에 events 변수의 상거래 이벤트와 유사한 데이터가 포함됩니다. productListItems 개체 배열에 products 변수와 유사한 데이터가 있습니다.

commerce 개체 commerce-object

이 단원에서는 commerce 개체에서 사용할 수 있는 필드에 대해 설명합니다.

TIP
측정값에는 id 및 value 필드가 있습니다. 대부분의 경우 value 필드(예: 'value':1)만 사용합니다. id 필드를 사용하면 측정값이 전송될 때 추적할 고유 식별자를 설정할 수 있습니다. 자세한 내용은 측정에 대한 XDM 설명서를 참조하십시오.
측정
권장 사항
설명
cartAbandons
선택 사항입니다
사용자가 장바구니에 더 이상 액세스하거나 구매할 수 없습니다.
checkouts
적극 권장
사용자가 더 이상 제품을 탐색하지 않고 제품을 구매 중입니다.
productListAdds
적극 권장
제품이 목록에 추가됩니다. 동시에 productListItems에서 제품을 설정하십시오.
productListOpens
선택 사항입니다
새 제품 목록이 만들어집니다. 예를 들어 새 장바구니가 만들어집니다.
productListRemovals
적극 권장
제품이 제품 목록에서 제거됩니다.
productListReopens
선택 사항입니다
사용자가 제품 목록을 다시 활성화합니다. 이 작업은 리마케팅 캠페인에서 자주 수행됩니다.
productListViews
적극 권장
제품 목록이 표시됩니다.
productViews
적극 권장
제품 보기가 발생했습니다. productListItems에서 본 제품을 설정하십시오.
purchases
적극 권장
주문이 수락됩니다. 제품 목록이 있어야 합니다.
saveForLaters
선택 사항입니다
나중에 사용할 수 있도록 제품이 저장됩니다.

Commerce 개체 예

commerce 개체의 필드를 사용하는 웹 SDK 명령의 예제를 보려면 아래 섹션을 확장하세요.

productViews

sendEvent 필드를 productViews(으)로 설정하는 기본 웹 SDK 1 호출:

code language-javascript 
alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

order 개체 order-object

commerce 개체에 주문 세부 사항을 수집하는 전용 개체가 있습니다. 이를 order 개체라고 합니다.

이 단원에서는 order 개체에서 지원하는 모든 필드를 설명합니다.

필드
옵션
권장 사항
설명
currencyCode
주문 합계에 대한 ISO 4217 통화입니다.
payments[]
주문에 대한 결제 목록. paymentItem에는 다음 항목이 포함되어 있습니다.
currencyCode
선택 사항입니다
이 결제 방법에 대한 ISO 4217 통화입니다.
paymentAmount
적극 권장
지정된 통화 코드 내 결제 값.
paymentType
적극 권장
결제 유형(예: credit_card, gift_card, paypal). 자세한 내용은 알려진 값 목록을 참조하세요.
transactionID
선택 사항입니다
해당 결제 거래에 대한 고유 ID.
priceTotal
적극 권장
할인 및 세금이 모두 적용된 후 이 주문에 대한 합계입니다.
purchaseID
적극 권장
판매자가 해당 구매에 할당한 고유 식별자.
purchaseOrderNumber
선택 사항입니다
구매자가 해당 구매에 할당한 고유 식별자.

Order 객체 예

commerce 개체를 사용한 웹 SDK 명령의 예를 보려면 아래 섹션을 확장하십시오.

Order 개체 예

sendEvent 배열의 여러 제품에 적용되는 order 개체를 설정하는 웹 SDK productListItems 호출:

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "order":{
        "purchaseID":"123456789",
        "currencyCode":"USD",
        "priceTotal":39.98,
        "payments":[
          {
            "transactionID":"amx12345",
            "paymentAmount":39.98,
            "paymentType":"credit_card",
            "currencyCode":"USD"
          }
        ]
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "priceTotal":29.99,
        "quantity":1
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "priceTotal":9.99,
        "quantity":1
      }
    ]
  }
});

제품 목록 개체 product-list-object

제품 목록은 해당 작업과 관련된 제품을 나타냅니다. productListItems 목록입니다. 각 제품에는 몇 가지 옵션 필드가 있습니다.

필드
권장 사항
설명
currencyCode
선택 사항입니다
제품에 대한 ISO 4217 통화입니다. 이 필드는 일반적으로 제품 목록에 다른 통화 코드가 있는 제품이 여러 개 있는 경우에만 적용됩니다.
priceTotal
적극 권장
해당되는 경우에만 이 필드를 설정하십시오. 예를 들어 productView 이벤트가 아닌 다른 제품 변형의 가격이 다를 수 있으므로 productListAdds 이벤트에 설정하지 못할 수 있습니다.
product
적극 권장
제품에 대한 XDM ID.
productAddMethod
적극 권장
방문자가 목록에 제품 항목을 추가하는 데 사용한 메서드입니다. productListAdds 측정값으로 설정되며 제품이 목록에 추가되는 경우에만 사용됩니다. add to cart button, quick add 및 upsell을(를) 예로 들 수 있습니다.
productName
적극 권장
제품의 표시 이름 또는 사람이 인식할 수 있는 이름.
quantity
적극 권장
고객이 제품에 필요하다고 표시한 단위 수. productListAdds, productListRemoves, purchases, saveForLaters 등에 설정해야 합니다.
SKU
적극 권장
상점 유지 장치. 제품에 대한 고유 식별자입니다.

제품 목록 예

아래 섹션을 확장하여 productListItems 개체를 사용한 웹 SDK 명령의 예를 봅니다.

productListItems 예

웹 SDK sendEvent 호출에서 productViews 배열의 여러 제품에 대해 productListItems을(를) 설정하는 중:

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
      }
    ]
  }
});
productListAdds 예

웹 SDK sendEvent 호출에서 productListAdds 배열의 여러 제품에 대해 productListItems 이벤트를 설정합니다.

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "productListAdds":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99,
        "productAddMethod":"Add to Cart Button"
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99,
        "productAddMethod":"Add-on"
      }
    ]
  }
});
checkouts 예

웹 SDK sendEvent 호출에서 checkouts 배열의 여러 제품에 대해 productListItems 이벤트를 설정합니다.

code language-javascript 
alloy("sendEvent",{
  "xdm":{
    "commerce":{
      "checkouts":{
        "value":1
      }
    },
    "productListItems":[
      {
        "SKU":"HT105",
        "name":"The Big Floppy Hat",
        "quantity":1,
        "priceTotal":29.99
      },
      {
        "SKU":"HT104",
        "name":"The Small Floppy Hat",
        "quantity":1,
        "priceTotal":9.99
      }
    ]
  }
});
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1