实施适用于 Analytics、Audience Manager 和 Target 的 Experience Cloud Identity 服务

这些说明适用于那些想要使用 Experience Cloud Identity 服务而不使用 Dynamic Tag Management (DTM) 的 Analytics、Audience Manager 和 Target 客户。但是,我们强烈建议您使用 DTM 来实施 ID 服务。DTM 可简化实施工作流程,并自动确保代码放置和排序正确无误。

重要

在开始之前,请先阅读 ID 服务要求,并记下特定于此实施的以下要求:

  • 使用 s_code 的客户无法完成此过程。请升级到 mbox 代码 v61 以完成此过程。
  • 在生产环境中实施此代码​之前,请先在开发环境中对其进行配置和测试。

步骤 1:规划服务器端转发

除了这里介绍的步骤以外,使用 Analytics 和 Audience Manager 的客户还应迁移到服务器端转发。服务器端转发允许您删除 DIL(Audience Manager 的数据收集代码)并将其替换为受众管理模块。有关更多信息,请参阅服务器端转发文档

迁移到服务器端转发需要进行规划和协调。此过程涉及对您的网站代码进行外部更改以及 Adobe 配置您的帐户时必须执行的内部步骤。事实上,其中的许多迁移步骤需要并行执行并一起发布。您的实施路径应遵循以下事件顺序:

  1. 与您的 Analytics 和 Audience Manager 联系人一起计划您的 ID 服务和服务器端转发迁移。将选择跟踪服务器作为此计划的重要环节。

  2. 完成集成和配置站点上的表单以开始操作。

  3. 同时实施 ID 服务和 Audience Management Module。若要正常工作,必须为同一组页面同时发布 Audience Management Module(服务器端转发)和 ID 服务。

步骤 2:下载 ID 服务代码

ID 服务 要求具备 VisitorAPI.js 代码库。要下载此代码库,请执行以下操作:

  1. 转到​管理员 > 代码管理器

  2. 在“代码管理器”中,单击 JavaScript(新版)​或 JavaScript(旧版)。此下载文件对代码库进行了压缩。

  3. 解压缩代码文件,并打开 VisitorAPI.js 文件。

步骤 3:将 Visitor.getInstance 函数添加到 ID 服务代码中

重要
  • 早期版本的 ID 服务 API 将此函数放置在不同的位置,并且需要使用不同的语法。如果您是从版本 1.4 之前的版本迁移,请注意此处介绍的函数新位置和语法。
  • ALL CAPS 中的代码是实际值的占位符。请将此文本替换为您的组织 ID、跟踪服务器 URL 或其他命名值。

第 1 部分:复制下面的 Visitor.getInstance 函数

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

第 2 部分:将函数代码添加到 VisitorAPI.js 文件

Visitor.getInstance 函数放置在位于文件末尾的代码块后面。您编辑的文件应该类似于下面的样子:

/* 
========== DO NOT ALTER ANYTHING BELOW THIS LINE ========== 
Version and copyright section 
*/ 
 
// Visitor API code library section 
 
// Put Visitor.getInstance at the end of the file, after the code library 
 
var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

步骤 4:将您的 Experience Cloud 组织 ID 添加到 Visitor.getInstance

Visitor.getInstance 函数中,将 INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE 替换为您的 Experience Cloud 组织 ID。如果您不知道自己的组织 ID,可以在 Experience Cloud 管理页面上查找。您编辑的函数看起来类似于下面的示例。

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

重要

请不要​更改组织 ID 中字符的大小写。这个 ID 是区分大小写的,因此必须严格按照所提供的形式使用。

步骤 5:将您的跟踪服务器添加到 Visitor.getInstance

Analytics 使用跟踪服务器进行数据收集。

第 1 部分:查找您的跟踪服务器 URL

检查您的 s_code.jsAppMeasurement.js 文件,以查找跟踪服务器 URL。您将需要由以下变量指定的 URL:

  • s.trackingServer
  • s.trackingServerSecure

第 2 部分:设置跟踪服务器变量

要确定要使用的跟踪服务器变量,请执行以下操作:

  1. 回答下面的决策矩阵中的问题。使用与答案对应的变量。
  2. 将跟踪服务器占位符替换为您的跟踪服务器 URL。
  3. 从代码中删除未使用的跟踪服务器和 Experience Cloud 服务器变量。

注意

在使用时,请将 Experience Cloud 服务器 URL 与它们所对应的跟踪服务器 URL 相匹配,如下所示:

  • Experience Cloud 服务器 URL = 跟踪服务器 URL
  • Experience Cloud 服务器安全 URL = 跟踪服务器安全 URL

如果您不确定如何找到跟踪服务器,请参阅常见问题解答以及正确填充 trackingServer 和 trackingServerSecure 变量

步骤 6:更新您的 AppMeasurement.js 文件

此步骤需要使用 AppMeasurement。如果您仍使用 s_code,则无法继续。

将如下所示的 Visitor.getInstance 函数添加到您的 AppMeasurement.js 文件中。将该函数放置在包含 linkInternalFilterscharSettrackDownloads 等配置的部分中:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

重要

此时,您应当删除 Audience Manager DIL 代码,并将其替换为受众管理模块。有关说明,请参阅实施服务器端转发

***(可选,但是推荐)*创建自定义 prop **

AppMeasurement.js 中设置自定义 prop 来测量范围。将此自定义 prop 添加到 doPlugins 文件的 AppMeasurement.js 函数中:

// prop1 is used as an example only. Choose any available prop. 
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

步骤 7:将访客 API 代码添加到页面中

VisitorAPI.js 文件放置在每个页面的 <head> 标记之内。在将 VisitorAPI.js 文件放入页面之后,您可以:

  • 将它放在 <head> 部分的开头处,使其显示在其他解决方案标记之前。
  • 它必须在 AppMeasurement 以及其他 Experience Cloud 解决方案的代码之前执行。

步骤 8:(可选)配置宽限期

如果这些用例中的任何一个用例适用于您的情况,请联系客户关怀以设置临时宽限期。宽限期最长可达 180 天。您可以根据需要延长宽限期。

部分实施

如果您的某些页面使用 ID 服务而某些页面没有使用,并且它们全部报告到同一个 Analytics 报表包中,那么就需要设置宽限期。如果您有一个跨域报告的全局报表包,则这种情况很常见。

将 ID 服务部署在报告到同一报表包中的所有网页上后,就可以中止宽限期。

s_vi Cookie 要求

如果您在迁移到 ID 服务后需要新访客具有 s_vi Cookie,则需要设置宽限期。如果您的实施读取 s_vi Cookie 并将其存储在变量中,那么设置宽限期是常见的做法。

在实施可捕获 MID 而不是读取 s_vi Cookie 后,就可以中止宽限期。

另请参阅 Cookie 和 Experience Cloud Identity 服务

点击流数据集成

如果您将来自点击流数据馈送和使用 visid_highvisid_low 列的流程中的数据发送至内部系统,则需要设置宽限期。

当您的数据获取流程可以使用 post_visid_highpost_visid_low 列之后,就可以中止宽限期。

另请参阅点击流数据列引用

步骤 9:测试和验证

此实施中的 Experience Cloud 解决方案会以键值对的形式返回 ID。每个解决方案分别使用不同的键(例如 Analytics SDID 和 Target mboxMCSDID)来保存同一 ID。要测试您的实施,请在开发环境中加载您的页面。使用监控 HTTP 请求和响应的浏览器控制台或软件来检查下面列出的 ID。如果下面列出的键值对返回相同的 ID 值,则表明 ID 服务已得到正确实施。

小贴士

您可以使用 Adobe 调试器Charles HTTP 代理检查这些特定于解决方案的 ID。当然,您也可以随意使用最适合您的任何工具或调试器。

所有解决方案

检查:

有关帮助您确定 ID 服务是否正常运行的其他检查,请参阅测试和验证 Experience Cloud Identity 服务

Analytics

检查 JavaScript 请求中的 SDID 标识符。Analytics SDID 应与 Target mboxMCSDID 匹配。

如果测试返回 AID,则表示出现以下任一情况:

  • 您是正在迁移旧版 Analytics ID 的回访访客。
  • 您已启用宽限期

如果您看到 AID,请检查它的值是否与 Target mboxMCAVID 一致。正确实施 ID 服务后,这些值将相同。

Audience Manager

要测试服务器端转发,请参阅如何验证服务器端转发实施

Target

检查:

  • mboxMCGVID
  • mboxMCSDID(mboxMCSDID 应与 Analytics SDID 匹配。)

如果测试返回 mboxMCAVID,则表示出现以下任一情况:

  • 您是正在迁移旧版 Analytics ID 的回访访客。
  • 您已启用了宽限期。

如果您看到 mboxMCAVID,请检查它的值是否与 Analytics AID 一致。正确实施 ID 服务后,这些值将相同。

部署

步骤 10:部署

在代码通过测试后,部署代码。

如果已启用宽限期:

  • 请确保 Analytics ID (AID) 和 MID 都在图像请求中。
  • 当您符合中止宽限期的条件时,请记住禁用宽限期。

在此页面上