如果您的网站上有产品,则这是您可能想要发送的一组默认内容,用于启用Adobe中的大多数功能。 尽管这是一项建议,但它从一开始就提供了一组非常强的数据。
本文档使用 ExperienceEvent商务详细信息 架构字段组。 的 commerce
字段组分为两部分:the commerce
对象和 productListItems
数组。 的 commerce
对象允许您指示正在执行哪些操作 productListItems
数组。
如果您熟悉Adobe Analytics, commerce
与 events
变量。 的 productListItems
与 products
变量。
以下是 measures
在 commerce
对象。
度量包含两个字段: id
和 value
. 大多数情况下,您会使用 value
(例如, 'value':1
)。 的 id
字段中,您可以设置唯一标识符,以用于跟踪测量发送的时间。 有关 测量.
测量 | 推荐 | 描述 |
---|---|---|
cartAnabonts | 可选 | 用户无法再访问或购买购物车。 |
结账 | 强烈建议 | 用户不再浏览产品,而是正在购买产品。 |
productListAdds | 强烈建议 | 产品会添加到列表中。 确保在 productListItems 同时。 |
productListOpens | 可选 | 随即会创建新的产品列表。 (例如,会创建一个新购物车。) |
productListRemuves | 强烈建议 | 产品将从产品列表中删除。 |
productListReopens | 可选 | 用户将重新激活产品列表。 这通常发生在再营销活动中。 |
productListViews | 强烈建议 | 将查看产品列表。 |
productViews | 强烈建议 | 出现产品视图。 确保在 productListItems . |
购买 | 强烈建议 | 接受命令。 必须具有产品列表。 |
saveForLaters | 可选 | 产品已保存以供将来使用。 |
以下是如何设置这些值的示例 Measures
中。
alloy("sendEvent", {
"xdm":{
"commerce":{
"productViews":{
"value":1
}
}
}
});
商务对象还具有一个用于收集订单详细信息的特殊字段,称为 order
.
订购 | 选项 | 推荐 | 描述 |
---|---|---|---|
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 事件。 |
产品 | 强烈建议 | 产品的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
}
]
}
});