如果您的网站上有产品,那么这是您可能需要发送的默认功能集,用于启用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
}
]
}
});