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

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

重要
  • 请在开始之前阅读相关要求。
  • 请在生产环境中实施此代码之前，首先在开发环境中对它进行配置和测试。

请按照以下步骤为 Adobe Analytics 实施 ID 服务：

  1. 下载 ID 服务代码
  2. 将 Visitor.getInstance 函数添加到 ID 服务代码中
  3. 将您的 Experience Cloud 组织 ID 添加到 Visitor.getInstance
  4. 将您的跟踪服务器添加到 Visitor.getInstance
  5. 更新您的 AppMeasurement.js 或 s_code.js 文件
  6. 将访客 API 代码添加到页面中
  7. （可选）配置宽限期
  8. 测试和部署 ID 服务代码

步骤 1：下载 ID 服务代码

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

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

  2. 在代码管理器中，单击 JavaScript（新版）​或 JavaScript（旧版）。

    此下载文件对代码库进行了压缩。

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

步骤 2. 将 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
});

步骤 3：将您的 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 是区分大小写的，因此必须严格按照所提供的形式使用。

步骤 4：将您的跟踪服务器添加到 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 变量。

步骤 5：更新您的 AppMeasurement.js 或 s_code.js 文件

将这个函数添加到您的 AppMeasurement.js 或 s_code.js 文件：

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

将这个代码放置在包含 linkInternalFilters、charSet、trackDownloads 等配置的相同部分中。

**（可选，但是推荐）​创建自定义 prop **

在 AppMeasurement.js 或 s_code.js 中设置自定义 prop 以测量覆盖范围。将此自定义 prop 添加到 AppMeasurement.js 或 s_code.js 文件的 doPlugins 函数中：

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

步骤 6：将访客 API 代码添加到页面中

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

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

在测试和验证后将此代码移入生产环境中。

步骤 7：（可选）配置宽限期

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

部分实施

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

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

s_vi Cookie 要求

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

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

请参阅 Cookie 和 Experience Cloud Identity 服务。

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

当您的数据获取流程可以使用 post_visid_high 和 post_visid_low 列之后，就可以中止宽限期。

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

点击流数据获取

步骤 8：测试和部署 ID 服务代码

您可以按如下方式进行测试和部署。

测试和验证

要测试 ID 服务的实施状况，请检查以下各项：

另请参阅测试和验证 Experience Cloud Identity 服务。

部署代码

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

如果您在步骤 7 中启用了宽限期：

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

在此页面上