文档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对象中的字段的Web SDK命令示例。

productViews

将sendEvent字段设置为productViews的基本Web 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
可选
购买者为此购买分配的唯一标识符。

排序对象示例

展开以下部分以查看使用commerce对象的Web SDK命令的示例。

Order对象示例

Web SDK sendEvent调用设置适用于order数组中的多个产品的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对象的Web SDK命令示例。

productListItems示例

Web 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示例

Web 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示例

Web 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