分析 Target 实现
实施时需要执行多个步骤 Adobe Analytics 作为的报表源 Adobe Target (A4T)。 根据您是否使用实施A4T,此过程会有所不同 Adobe Experience Platform Web SDK 或使用at.js。
Adobe Experience Platform Web SDK实施的实施步骤 platform
如果您计划使用Platform Web SDK,以下部分将介绍将此集成部署到站点所需的步骤:
步骤1:请求配置 Analytics 和 Target
在实施A4T之前,必须为您配置 Analytics 和 Target. 使用此表单可请求进行配置.
步骤 2:设置用户权限
必须先满足用户帐户要求,然后才能根据以下条件创建活动 Analytics 在 Target. 请参阅用户权限要求。
步骤3:创建Edge配置
创建Edge配置,使用 Adobe Experience Platform 使用边缘配置工具。 配置 创建和配置数据流.
步骤4:安装和配置平台Web SDK
开始投放 Target 体验和应用 Analytics 出于跟踪和分析目的, 安装 和 配置 网站页面上的Platform Web SDK。
步骤5:启用用于使用A4T的选项
在 Target UI,单击 Administration > Visual Experience Composer,然后选择以下任一选项 Select per activity 或 Adobe Analytics.
- Select per activity 可让您选择 Target 和 Analytics 创建每个活动时。
- Adobe Analytics 集 Analytics 作为您创建的所有活动的报表源。
at.js实施的实施步骤 section_73961BAD5BB4430A95E073DE5C026277
如果您计划使用at.js,以下部分将介绍将此集成部署到您的网站所需的步骤:
步骤 1:请求配置 Analytics 和 Target。
实施之后 Analytics 作为的报表源 Target,您必须进行配置, Analytics 和 Target. 使用此表单可请求进行配置.
步骤 2:设置用户权限
在创建 Analytics中基于的活动 Target. 请参阅用户权限要求。
步骤 3:实施 Experience Cloud 访客 ID 服务。
通过访客ID服务,您可以识别以下各项中的用户: Adobe Experience Cloud 解决方案。 实施或迁移到所需版本的Experience Cloud访客ID。 有关更多信息,请参阅实施之前中的“实施要求”。
请参阅 实施适用于Target的Experience CloudID服务 在 Experience Cloud访客ID服务 文档。
步骤 4:更新 AppMeasurement for JavaScript 或 s_code
实施或迁移到所需版本的appMeasurement.js。 有关更多信息,请参阅实施之前中的“实施要求”。
有关新的实施,请参阅 JavaScript实施概述 在 Analytics实施指南.
有关迁移,请参阅 迁移到JavaScript的AppMeasurement 在 Analytics实施指南.
步骤5:下载并更新at.js
使用您的生产帐户实施或迁移到所需版本的at.js。 无需对代码进行修改。
有关更多信息,请参阅实施之前中的“实施要求”。
步骤6:托管at.js
如果您之前已部署at.js,则可以将现有文件替换为更新版本。 有关更多信息,请参阅实施之前中的“实施要求”。
如果不替换,则可以将此文件与访客 ID 服务文件和 AppMeasurement for JavaScript 文件一起托管。这些文件必须托管在可从您网站上的所有页面进行访问的 Web 服务器上。下一步需要使用这些文件的路径。
步骤7:在所有网站页面上引用at.js step7
通过将下面一行代码添加至每个页面的标记中,将at.js包含在VisitorAPI.js下:
对于 at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>
必须先加载VisitorAPI.js,然后再加载at.js。 如果要更新现有的at.js文件,请确保验证加载顺序。
的默认设置 Target 和 Analytics 从实施的角度来看,集成就是使用从页面传递的SDID来拼合 Target 和 Analytics 一起在后端自动请求。
您可以控制如何以及何时发送与相关的分析数据 Target 到 Analytics 作报告用途。 如果您不想选择使用默认设置,即 Target 和 Analytics 通过SDID自动拼合分析数据,设置 analyticsLogging =客户端 via 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"
}
}
然后,可以通过将有效负载转发到Analytics 数据插入API. 对于自动分配和自动定位活动,还必须转发sessionId。 有关更多信息,请参阅 Analytics for Target (A4T)报表 在 ADOBE TARGET SDK 指南。
如果不希望进行全局设置并且想要使用按需方法,请使用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"
}
}
}]
}
}
然后,可以将有效负载转发到 Analytics 通过 数据插入API.
步骤 8:验证实施 step8
更新JavaScript库后加载页面,以确认 mboxMCSDID
参数值 Target 调用匹配 sdid
参数值 Analytics 页面查看调用。
尤其重要的是,要确认这些值与单页应用程序(SPA)中的值相匹配,因为后者的调用顺序并不总是可预见的。
步骤 9:(可选)删除之前的集成代码
Adobe建议您删除之前的集成,以简化实施过程,并免除解决系统间差异的麻烦。 您可以删除为之前的SC与T&T集成部署的任何代码,包括 mboxLoadSCPlugin
.
步骤 10:启用可将 Analytics 用作 Target 报表源的选项
在 Target,单击 Administration > Reporting 并选择 Select per activity 或 Adobe Analytics 以启用选项。
- Select per activity 可让您选择 Target 和 Analytics 创建每个活动时。
- Adobe Analytics 集 Analytics 作为您创建的所有活动的报表源。