收集商业和产品信息

如果您的网站上有产品，那么这是您可能需要发送的默认功能集，用于启用Adobe中的大多数功能。 尽管这是一个建议，但它从一开始就提供了一组非常强大的数据。

本文档使用 ExperienceEvent商业详细信息 架构字段组。 此 commerce 字段组分为两部分： commerce 对象和 productListItems 数组。 此 commerce 对象可让您指示对以下对象执行的操作 productListItems 数组。

小贴士

如果您熟悉Adobe Analytics， commerce 与以下项目关系最密切： events 变量。 此 productListItems 与更密切相关的 products 变量。

与产品相关的操作

以下是 measures 中提供 commerce 对象。

小贴士

度量值包含两个字段： id 和 value. 大多数情况下，您将使用 value 仅字段(例如， 'value':1)。 此 id 字段允许您设置唯一标识符，用于跟踪度量的发送时间。 请参阅XDM文档，了解 衡量.

衡量 推荐 描述
cartAbandons 可选 用户无法再访问或购买购物车。
结账 强烈建议 用户不再浏览产品，而是正在购买产品。
productListAdd 强烈建议 将产品添加到列表。 请务必在 productListItems 同时。
productListOpens 可选 将创建新的产品列表。 （例如，创建一个新的购物车。）
productListRemovals 强烈建议 从产品列表中删除产品。
productListReopens 可选 用户重新激活产品列表。 这通常发生在再营销活动中。
productListView 强烈建议 已查看产品列表。
产品查看 强烈建议 产品视图。 请务必设置在中查看的产品 productListItems.
购买 强烈建议 订单已接受。 必须具有产品列表。
saveForLaters 可选 保存产品以供将来使用。

以下是如何设置这些参数的示例 Measures 在SDK中。

alloy("sendEvent", {
  "xdm":{
    "commerce":{
      "productViews":{
        "value":1
      }
    }
  }
});

商业对象还具有一个用于收集订单详细信息的特殊字段，称为 order.

订购 Option 推荐 描述
currencyCode 此 ISO 4217 订单总计的货币。
payments[paymentItems] 订单上的付款列表。 A paymentitem 包括以下内容。
currencyCode 可选 此 ISO 4217 此付款方式的货币。
paymentAmount 强烈建议 以指定的货币代码表示的付款值。
paymentType 强烈建议 付款类型(例如， credit_card， gift_card， paypal)。 查看列表 已知值 了解详细信息。
transactionID 可选 此付款交易记录的唯一ID。
priceTotal 强烈建议 应用所有折扣和税费后此订单的总额。
purchaseID 强烈推荐 卖方为此购买分配的唯一标识符。
purchaseOrderNumber 可选 购买者为此购买分配的唯一标识符。

以下是SDK中典型购买的示例。

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
      }
    ]
  }
});

产品列表

产品列表会指示哪些产品与相应的操作相关。 它是一个 productListItems. 每个产品都有许多可选字段。

字段 推荐 描述
currencyCode 可选 此 ISO 4217 产品的货币。 仅当您可以拥有具有不同货币代码的产品并且适用时，此功能才有用。 例如，当有购买或添加到购物车时。
priceTotal 强烈建议 应仅在适用时设置。 例如，可能无法将设置为 productView 事件，因为产品不同变体可能具有不同的价格，但 productListAdds 事件。
product 强烈建议 产品的XDM ID。
productAddMethod 强烈建议 访客用来将产品项目添加到列表的方法。 设置方式 productListAdds 度量，并且仅当将产品添加到列表时才应使用和。 示例包括 add to cart button、quick add 和 upsell。
productName 强烈建议 设置为产品的显示名称或人类可读的名称。
数量 强烈建议 客户表明的产品需求单位数。 应设置于 productListAdds， productListRemoves， purchases， saveForLaters，等等。
SKU 强烈建议 商店保管单位。 它是产品的唯一标识符。

示例

productViews 事件

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

productListAdds 事件

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 事件

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
      }
    ]
  }
});

order 事件

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
      }
    ]
  }
});

在此页面上