使用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