使用Platform Web SDK跟踪Target转化事件
与at.js类似,可以使用Platform Web SDK跟踪Target的转化事件。 转化事件通常分为以下类别:
- 自动跟踪不需要任何配置的事件
- 应为最佳实践Platform Web SDK实施调整的购买转化事件
- 需要代码更新的非购买转化事件
目标跟踪比较
下表比较了at.js和Platform Web SDK如何跟踪转化事件
活动目标
Target at.js 2.x
平台Web SDK
转化>查看页面
已自动跟踪。 基于at.js请求有效负载中
context.address.url的值。已自动跟踪。 基于
sendEvent有效负载中xdm.web.webPageDetails.URL的值“转化”>“已查看mbox”
已使用
trackEvent()或sendNotifications()且值为display的显示mbox位置或通知请求进行跟踪。type已使用
decisioning.propositionDisplay的eventType通过Platform Web SDK sendEvent调用进行跟踪。转化>单击元素
自动为基于VEC的活动进行跟踪。 显示为at.js网络调用,在请求有效负载中具有
notifications对象且type值为click。自动为基于VEC的活动进行跟踪。 显示为Platform Web SDK
sendEvent调用,其中包含decisioning.propositionInteract的eventType。参与>页面查看
已自动跟踪
已自动跟踪
参与>网站逗留时间
已自动跟踪
已自动跟踪
自动跟踪的事件
以下转化目标不需要对实施进行任何具体调整:
- 转化>查看页面
- 转化>单击元素
- 参与>页面查看
- 参与>网站逗留时间
NOTE
Platform Web SDK允许更好地控制请求有效负载中传递的值。 要确保Target功能(如QA URL和“查看了某个页面”转化目标正常工作,请检查
xdm.web.webPageDetails.URL值是否包含具有正确字符大小写的完整页面URL。自定义跟踪事件
Target实施通常使用自定义转化事件来跟踪基于表单的活动的点击次数,以指示流量中的转化,或者在不请求新内容的情况下传递参数。
下表概述了几种常见的转化跟踪用例的at.js方法和Platform Web SDK等效项。
用例
Target at.js 2.x
平台Web SDK
跟踪mbox位置(范围)的点击转化事件
为特定mbox位置执行
trackEvent()或值为click的type的sendNotifications()执行事件类型为
decisioning.propositionInteract的sendEvent命令跟踪可能还包含其他数据(如Target配置文件参数)的自定义转化事件
为特定mbox位置执行
trackEvent()或值为display的type的sendNotifications()执行事件类型为
decisioning.propositionDisplay的sendEvent命令NOTE
虽然
decisioning.propositionDisplay最常用于增加特定范围的展示次数,但通常也应将它用作at.js trackEvent()的直接替代项。 如果未指定,trackEvent()函数将默认为display类型。 检查您的实施,确保对您可能已定义的任何自定义转化使用正确的事件类型。有关如何使用trackEvent()和sendNotifications()跟踪Target事件的更多信息,请参阅at.js专用文档。
at.js示例使用trackEvent()跟踪对mbox位置的点击:
adobe.target.trackEvent({
"type": "click",
"mbox": "homepage_hero"
});
通过Platform Web SDK实施,您可以通过调用sendEvent命令、填充_experience.decisioning.propositions XDM字段组并将eventType设置为以下两个值之一来跟踪事件和用户操作:
decisioning.propositionDisplay:表示Target活动的渲染。decisioning.propositionInteract:表示用户与活动的交互,如鼠标单击。
_experience.decisioning.propositions XDM字段组是一个对象数组。 每个对象的属性派生自sendEvent命令中返回的result.propositions: { id, scope, scopeDetails }
alloy("sendEvent", {
xdm: { ...},
decisionScopes: ["hero-banner"]
}).then(function (result) {
var propositions = result.propositions;
if (propositions) {
// Find the discount proposition, if it exists.
for (var i = 0; i < propositions.length; i++) {
var proposition = propositions[i];
for (var j = 0; j < proposition.items; j++) {
var item = proposition.items[j];
if (item.schema === "https://ns.adobe.com/personalization/measurement") {
// add metric to the DOM element
const button = document.getElementById("form-based-click-metric");
button.addEventListener("click", event => {
const executedPropositions = [
{
id: proposition.id,
scope: proposition.scope,
scopeDetails: proposition.scopeDetails
}
];
// send the click track event
alloy("sendEvent", {
"xdm": {
"eventType": "decisioning.propositionInteract",
"_experience": {
"decisioning": {
"propositions": executedPropositions
}
}
}
});
});
}
}
}
}
});
接下来,了解如何为一致的访客配置文件启用跨域ID共享。
NOTE
我们致力于帮助您成功完成从at.js到Web SDK的Target迁移。 如果您在迁移过程中遇到障碍或觉得本指南中缺少关键信息,请在此社区讨论中发帖让我们知道。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110