将Adobe Analytics作为Target (A4T)的报告源实施时,需要几个步骤。
以下各节介绍了将此集成部署到站点所需的步骤。
将Analytics作为Target的报告源实施后,必须为Analytics和Target设置。 使用此表单请求设置。
必须满足用户帐户要求,才能在Target中创建基于Analytics的活动。 请参阅用户权限要求。
通过访客 ID 服务,您可以在各个 Adobe Experience Cloud 解决方案中识别用户。您必须实施或迁移到所需版本的 Experience Cloud 访客 ID 服务。有关更多信息,请参阅实施之前中的“实施要求”。
请参阅Experience CloudID服务文档中的为目标实施Experience CloudID服务。
您必须实施或迁移到所需版本的 appMeasurement.js。有关更多信息,请参阅实施之前中的“实施要求”。
有关新的实现,请参阅Analytics Implementation Guide中的JavaScript实现概述。
有关迁移,请参阅分析实施指南中的迁移到AppMeasurement for JavaScript。
必须使用生产帐户实施或迁移到所需版本的at.js。 无需对代码进行修改。
有关更多信息,请参阅实施之前中的“实施要求”。
如果您以前部署了at.js,则可以用更新的版本替换现有文件。 有关更多信息,请参阅实施之前中的“实施要求”。
如果不替换,则可以将此文件与访客 ID 服务文件和 AppMeasurement for JavaScript 文件一起托管。这些文件必须托管在可从您网站上的所有页面进行访问的 Web 服务器上。下一步需要使用这些文件的路径。
通过在每页的标记中添加以下代码行,将at.js包含在VisitorAPI.js下:
对于 at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>
在at.js之前加载VisitorAPI.js至关重要。如果要更新现有的at.js或mbox.js文件,请确保验证加载顺序。
从实现角度为Target和Analytics集成配置现成设置的方法是使用从页面传递的SDID在后端自动将Target和Analytics请求串接在一起。
但是,如果您希望更多地控制将与Target相关的分析数据发送到Analytics以用于报告目的的方式和时间,并且您不希望选择通过SDID使Target和Analytics自动缝合分析数据的默认设置,则可以通过analyticsLogging = client_side通过设置window.targetGlobalSettings。 注意:低于 2.1 的任何版本均不支持此方法。
例如:
window.targetGlobalSettings = {
analyticsLogging: "client_side"
};
此设置具有全局效果,这意味着 at.js 进行的每次调用都将在 请求中发送 analyticsLogging: "client_side",并且将为每个请求返回分析有效负载。Target完成此设置后,返回的有效负载格式如下所示:
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
然后,可以通过数据插入API将有效负荷转发到Analytics。 请注意,对于自动分配和自动目标活动,您还需要转发sessionId。 有关详细信息,请参阅Adobe TargetSDK指南中的目标分析(A4T)报告。
如果不希望进行全局设置并且想要使用按需方法,则可以使用 at.js 函数 getOffers() 通过传入 analyticsLogging: "client_side" 来实现此目的。将仅返回此调用的分析有效负荷,且Target后端不会将有效负荷转发到Analytics。 通过采用此方法,默认情况下,每个at.js Target请求都不会返回有效负荷,而是仅在需要并指定时才返回。
例如:
adobe.target.getOffers({
request: {
experienceCloud: {
analytics: {
logging: "client_side"
}
},
prefetch: {
mboxes: [{
index: 0,
name: "a1-serverside-xt"
}]
}
}
})
.then(console.log)
此调用将会调用一个响应,您可以从中提取分析有效负载。
响应如下所示:
{
"prefetch": {
"mboxes": [{
"index": 0,
"name": "a1-serverside-xt",
"options": [{
"content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
"type": "html",
"eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
"responseTokens": {
"profile.memberlevel": "0",
"geo.city": "bucharest",
"activity.id": "167169",
"experience.name": "USA Experience",
"geo.country": "romania"
}
}],
"analytics": {
"payload": {
"pe": "tnt",
"tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
}
}
}]
}
}
然后,可通过数据插入API将有效负荷转发到Analytics。
更新 JavaScript 库后,加载您的页面,以确认 调用中的 mboxMCSDID
Target 参数值与 页面查看调用中的 sdid
Analytics 参数值相匹配。
在单页应用程序 (SPA) 中,由于调用顺序并不总是可以预测,因此尤其务必要进行此验证。
注意:为使 A4T 能够正常运行,这些值必须匹配。
我们建议您删除之前的集成,以便简化您的实施,并免除解决系统间差异的麻烦。您可以删除可能已为之前的 SC 与 T&T 集成部署的任何代码,包括 mboxLoadSCPlugin
。
在Target中,单击管理>可视体验书写器,然后选择按活动或Adobe Analytics选择以启用这些选项。