Analytics forTarget实施

在实施Adobe Analytics作为Adobe Target (A4T)的报表源时,需要执行几个步骤。 具体过程会因您是使用Adobe Experience Platform Web SDK实施A4T,还是使用at.js实施A4T而异。

Adobe Experience Platform Web SDK徽 章Adobe Experience Platform Web SDK实施的实施步骤

以下部分介绍了在您计划使用Platform Web SDK时,将此集成部署到您的网站所需的步骤:

步骤1:请求配置Analytics和Target

在实施A4T之前,必须针对Analytics和Target进行配置。 使用此表单可请求进行配置

步骤 2:设置用户权限

必须满足用户帐户要求,然后才能在Target中创建基于Analytics的活动。 请参阅用户权限要求

步骤3:创建边缘配置

使用边缘配置工具使用Adobe Experience Platform创建边缘配置。 配置Analytics and Target 边缘配置设置

步骤4:安装和配置平台Web SDK

要开始交付Target体验并应用Analytics以进行跟踪和分析,请在您的网站页面上安装配置平台Web SDK。

步骤5:启用用于使用A4T的选项

在Target UI中,单击​管理 > 可视化体验编辑器,然后选择​为每个活动​选择或​Adobe Analytics

  • **如果选择为每个活动选择,您在创建每个活动时可以在 和 之间进行选择。**TargetAnalytics
  • **如果选择 Adobe ,则会将 Analytics 设置为您创建的所有活动的报表源。**Analytics

at.js徽 章at.js实施的实施步骤

以下部分介绍了如果您计划使用at.js,则将此集成部署到您的网站所需的步骤:

步骤 1:请求配置 Analytics 和 Target。

将Analytics作为Target的报表源实施后,必须为Analytics和Target配置。 使用此表单可请求进行配置

步骤 2:设置用户权限

在Target中创建基于Analytics的活动之前,必须满足用户帐户要求。 请参阅用户权限要求

步骤 3:实施 Experience Cloud 访客 ID 服务。

通过访客 ID 服务,您可以在各个 Adobe Experience Cloud 解决方案中识别用户。实施或迁移到所需版本的Experience Cloud访客ID。 有关更多信息,请参阅实施之前中的“实施要求”。

请参阅​Experience Cloud访客ID服务​文档中的为Target实施Experience CloudID服务。

步骤 4:更新 AppMeasurement for JavaScript 或 s_code

实施或迁移到所需版本的appMeasurement.js。 有关更多信息,请参阅实施之前中的“实施要求”。

有关新实施的信息,请参阅​Analytics实施指南​中的JavaScript实施概述

有关迁移,请参阅​Analytics实施指南​中的迁移到AppMeasurement for JavaScript

步骤5:下载和更新at.js

使用您的生产帐户实施或迁移到所需版本的at.js。 无需对代码进行修改。

有关更多信息,请参阅实施之前中的“实施要求”。

步骤6:托管at.js

如果您之前已部署at.js,则可以将现有文件替换为更新版本。 有关更多信息,请参阅实施之前中的“实施要求”。

如果不替换,则可以将此文件与访客 ID 服务文件和 AppMeasurement for JavaScript 文件一起托管。这些文件必须托管在可从您网站上的所有页面进行访问的 Web 服务器上。下一步需要使用这些文件的路径。

步骤7:在所有网站页面上引用at.js

通过将下面一行代码添加到每个页面的标记中,将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自动拼合分析数据,请通过​window.targetGlobalSettings​设置​analyticsLogging = client_side。 注意:低于 2.1 的任何版本均不支持此方法。

例如:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

此设置具有全局效果,这意味着at.js进行的每次调用都具有​analyticsLogging:在Target请求中发送的"client_side",并且会为每个请求返回分析有效负载。 设置此选项时,返回的有效负载格式如下所示:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

然后,可以通过数据插入API将负载转发到Analytics。 对于自动分配和自动定位活动,还必须转发sessionId。 有关更多信息,请参阅​Adobe Target SDK​指南中的Analytics for Target(A4T)报表

如果不希望进行全局设置并且希望使用按需方法,请通过传入​analyticsLogging,使用at.js函数getOffers():"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。

步骤 8:验证实施

更新 JavaScript 库后,加载您的页面,以确认 调用中的 mboxMCSDIDTarget 参数值与 页面查看调用中的 sdidAnalytics 参数值相匹配。

在单页应用程序(SPA)中,调用顺序并非总是可预测的情况下,确认这些值是否匹配尤为重要。

注意

A4T要正常运行,需要匹配这些值。

步骤 9:(可选)删除之前的集成代码

Adobe建议您删除之前的集成,以简化实施,并消除解决系统间差异的需要。 您可以删除为之前的SC与T&T集成部署的任何代码,包括mboxLoadSCPlugin

步骤 10:启用可将 Analytics 用作 Target 报表源的选项

在Target中,单击​管理>可视化体验编辑器,然后选择​为每个活动​选择或​Adobe Analytics​以启用选项。

  • **如果选择为每个活动选择,您在创建每个活动时可以在 和 之间进行选择。**TargetAnalytics
  • **如果选择 Adobe ,则会将 Analytics 设置为您创建的所有活动的报表源。**Analytics

在此页面上