Show Menu
主题×

Analytics for Target 实施

Several steps are required when implementing Adobe Analytics as the reporting source for Target (A4T).

Implementation steps

以下各节介绍了将此集成部署到站点所需的步骤。

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

After you implement Analytics as the reporting source for Target, you must be provisioned for Analytics and Target. 使用此表单请求设置

步骤 2:设置用户权限

User account requirements must be met before you can create an Analytics-based activity in Target. 请参阅 用户权限要求

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

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

步骤 4:更新 AppMeasurement for JavaScript 或 s_code

您必须实施或迁移到所需版本的 appMeasurement.js。有关更多信息,请参阅 实施之前 中的“实施要求”。
有关新的实施,请参 阅《Analytics Implementation Guide 》中的 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 文件,请务必确认加载顺序。
The way the out-of-the-box settings are configured for Target and Analytics integration from an implementation perspective is to use the SDID that is passed from the page to stitch the Target and Analytics request together on the backend automatically for you.
However, if you want more control on how and when to send analytics data related to Target to Analytics for reporting purposes, and you do not want to opt-in to the default settings of having Target and Analytics automatically stitch the analytics data via the SDID, then you can set analyticsLogging = client_side 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"
   }
}

然后,可以通过数据插入API将有效负 荷转发到Analytics
如果不希望进行全局设置并且想要使用按需方法,则可以使用 at.js 函数 getOffers() 通过传入 analyticsLogging: "client_side" 来实现此目的。The analytics payload will be returned for only this call and the Target backend will not forward the payload to Analytics. By pursuing this approach, every at.js Target request will not return the payload by default, but instead only when desired and specified.
例如:
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:验证实施

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

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

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

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

In Target, click Administation > Visual Experience Composer and choose either Select per activity or Adobe Analytics to enable the options.
  • 如果选择为每个活动选择,您在创建每个活动时可以在 和 之间进行选择。 Target​Analytics
  • 如果选择 Adobe ,则会将 Analytics 设置为您创建的所有活动的报表源。 Analytics