Show Menu
主题×

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

这些说明适用于那些想要使用 Experience Cloud Identity 服务而不使用 Dynamic Tag Management (DTM) 的 Analytics 和 Audience Manager 客户。但是,我们强烈建议您使用 DTM 来实施此 ID 服务。DTM 可简化实施工作流程,并自动确保代码放置和排序的正确性。
  • 此流程需要 AppMeasurement。使用 s_code 的客户无法完成此过程。
  • 请在生产环境中实施此代码之前,首先在开发环境中对它进行配置和测试。

步骤 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 之前的版本迁移,请注意此处记录的新放置位置和语法。
  • 全部大写的代码是一个对应实际值的占位符。将此文本替换为您的组织 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.js
AppMeasurement.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
文件中。将该函数放置在包含
linkInternalFilters
charSet
trackDownloads
等配置的部分中:
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:(可选)配置宽限期

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . 宽限期可长达 180 天。您可以在必要时延长宽限期。
部分实施
如果您的某些页面使用 ID 服务而某些页面没有使用,并且它们全部报告到同一个 Analytics 报表包中,那么就需要设置宽限期。这对于一个跨域报告的全局报表包来说,设置宽限期是很常见的。
当报告到同一报表包中的所有网页都部署了 ID 服务后,就可以中止宽限期。
s_vi Cookie 要求
如果在迁移到 ID 服务后,您要求新访客具有 s_vi Cookie,则需要设置宽限期。当您的实施需要读取 s_vi Cookie 并将其存储在变量中时,设置宽限期是很常见的。
在您的实施可以捕获 MID 而不是读取 s_vi Cookie 时,就可以中止宽限期。
点击流数据集成
如果您将来自点击流数据馈送和使用
visid_high
visid_low
列的流程中的数据发送至内部系统,则需要设置宽限期。
当您的数据获取流程可以使用
post_visid_high
post_visid_low
列之后,就可以中止宽限期。
另请参阅 点击流数据列引用

步骤 9:测试和部署 ID 服务代码

您可以按如下方式进行测试和部署。
测试和验证
要测试 ID 服务的实施状况,请检查以下环节:
要验证服务器端转发,请参阅 如何验证服务器端转发的实施情况
部署
部署通过了测试的代码。
如果您启用了宽限期:
  • 请确保 Analytics ID (AID) 和 MID 都在图像请求中。
  • 当您符合中止宽限期的条件时,请记住禁用宽限期。