Show Menu
主题×

Analytics for Target 实施

在实施 Adobe Analytics 作为 Target 报表源 (A4T) 时,需要执行几个步骤。

实施步骤

下表介绍了将此集成部署到您的网站时需要执行的步骤。

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

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

步骤 2:设置用户权限

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

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

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

步骤 4:更新 AppMeasurement for JavaScript 或 s_code

您必须实施或迁移到所需版本的 appMeasurement.js。有关更多信息,请参阅 实施之前 中的“实施要求”。
有关新的实施,请参 阅《Analytics实施指南》中的 ​JavaScript实施概述
有关迁移,请参 阅《分析实施指南》中的迁移到AppMeasurement for javaScript ​(迁移到AppMeasurement for JavaScript)

步骤 5:下载并更新 at.js 或 mbox.js

您必须使用生产帐户实施或迁移到所需版本的 at.js 或 mbox.js。无需对代码进行修改。
有关更多信息,请参阅 实施之前 中的“实施要求”。

步骤 6:托管 at.js 或 mbox.js

如果您之前已部署 at.js 或 mbox.js,则可以将现有文件替换为更新版本。有关更多信息,请参阅 实施之前 中的“实施要求”。
如果不替换,则可以将此文件与访客 ID 服务文件和 AppMeasurement for JavaScript 文件一起托管。这些文件必须托管在可从您网站上的所有页面进行访问的 Web 服务器上。下一步需要使用这些文件的路径。

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

通过在每个页面的标记中添加下面一行代码,将 at.js 或 mbox.js 包含在 VisitorAPI.js 下:
对于 at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

对于 mbox.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/mbox.js"></script>

必须先加载 VisitorAPI.js,然后再加载 at.js 或 mbox.js。如果您要更新现有的 at.js 或 mbox.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 进行的每次调用都将在 Target 请求中发送 analyticsLogging: "client_side" ,并且将为每个请求返回分析有效负载。完成此设置后,返回的有效负载格式如下所示:
"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

然后,可以通过数据插入API将有效负载 转发到Analytics
如果不希望进行全局设置并且想要使用按需方法,则可以使用 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

步骤 8:验证实施

更新 JavaScript 库后,加载您的页面,以确认 Target 调用中的 mboxMCSDID 参数值与 Analytics 页面查看调用中的 sdid 参数值相匹配。
在单页应用程序 (SPA) 中,由于调用顺序并不总是可以预测,因此尤其务必要进行此验证。
注意: ​为使 A4T 能够正常运行,这些值必须匹配。

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

我们建议您删除之前的集成,以便简化您的实施,并免除解决系统间差异的麻烦。您可以删除可能已为之前的 SC 与 T&T 集成部署的任何代码,包括 mboxLoadSCPlugin

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

在 Target 中,单击设置 &gt; 首选项,然后选择为每个活动选择或 Adobe Analytics,以启用相应的选项。
  • 如果选择为每个活动选择,您在创建每个活动时可以在 Target 和 Analytics 之间进行选择。
  • 如果选择 Adobe Analytics,则会将 Analytics 设置为您创建的所有活动的报表源。