收集商务和产品信息

如果您的网站上有产品，则这是您可能希望发送的默认内容集，以启用Adobe中的最大功能。 尽管这是一个建议，但它提供了一套非常强大的开始数据。

此文档使用ExperienceEvent商务详细信息模式字段组。 commerce字段组分为两部分：commerce对象和productListItems数组。 通过commerce对象，可以指示正在对productListItems数组执行哪些操作。

小贴士

如果您熟悉Adobe Analytics，则commerce与events变量最密切相关。 productListItems与products变量更加密切相关。

与产品相关的操作

以下是commerce对象中可用的measures列表。

小贴士

度量包含两个字段：id和value。 大多数情况下，您只使用value字段（例如'value':1）。 id字段允许您设置唯一标识符，用于跟踪发送度量的时间。 请参阅Measure的XDM文档。

度量 推荐 描述
购物车放弃 可选 购物车不再由用户访问或购买。
结帐 强烈建议 用户不再浏览产品，但正在购买产品。
productListAdds 强烈建议 产品已添加到列表。 请务必同时在productListItems中设置产品。
productListOpens 可选 将创建新产品列表。 （例如，新购物车已创建。）
productListRemults 强烈建议 产品从产品列表中删除。
productListReopens 可选 产品列表由用户重新激活。 这种情况经常发生在再营销活动。
productListViews 强烈建议 查看产品列表。
productViews 强烈建议 产品视图。 请务必设置在productListItems中查看的产品。
购买 强烈建议 接受命令。 必须具有产品列表。
saveForLaters 可选 产品已保存以供将来使用。

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

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

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

订单 选项 推荐 描述
currencyCode 订单合计的ISO 4217货币。
payments[paymentItems] 订单付款的列表。 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 强烈建议 存储保持单元。 它是产品的唯一标识符。

示例

productView 事件

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

productView 事件

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

checkout 事件

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

purchase 事件

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

在此页面上