实施适用于 Analytics、Audience Manager 和 Target 的 Experience Cloud 身份服务 implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员
用户
管理员
领导

这些说明适用于要使用 Experience Cloud 身份服务但不使用数据收集标记的 Analytics、Audience Manager 和 Target 客户。但是，我们强烈建议您使用标记实施 ID 服务。标记可简化实施工作流程，并自动确保代码放置和排序正确无误。

IMPORTANT

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

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

步骤 1：规划服务器端转发 section-880797cc992d4755b29cada7b831f1fc

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

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

与您的 Analytics 和 Audience Manager 联系人一起计划您的 ID 服务和服务器端转发迁移。将选择跟踪服务器作为此计划的重要环节。
完成集成和配置站点上的表单以开始操作。
同时实施 ID 服务和 Audience Management Module。若要正常工作，必须为同一组页面同时发布 Audience Management Module（服务器端转发）和 ID 服务。

步骤 2：下载 ID 服务代码 section-0780126cf43e4ad9b6fc5fe17bb3ef86

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

转到 管理员 > 代码管理器。
在“代码管理器”中，单击 JavaScript（新版） 或 JavaScript（旧版）。此下载文件对代码库进行了压缩。
解压缩代码文件，并打开 VisitorAPI.js 文件。

步骤 3：将 Visitor.getInstance 函数添加到 ID 服务代码 section-9e30838b4d0741658a7a492153c49f27

IMPORTANT

早期版本的 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 section-e2947313492546789b0c3b2fc3e897d8

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

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

IMPORTANT

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

步骤 5：将您的跟踪服务器添加到 Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

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

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

检查您的 s_code.js 或 AppMeasurement.js 文件，以查找跟踪服务器 URL。您将需要由以下变量指定的 URL：

s.trackingServer
s.trackingServerSecure

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

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

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

NOTE

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

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

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

步骤 6：更新您的 AppMeasurement.js 文件 section-5517e94a09bc44dfb492ebca14b43048

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

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

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

IMPORTANT

此时，您应当删除 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 代码添加到页面 section-c2bd096a3e484872a72967b6468d3673

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

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

步骤 8：（可选）配置宽限期 section-aceacdb7d5794f25ac6ff46f82e148e1

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

部分实施

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

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

s_vi Cookie 要求

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

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

另请参阅 Cookie 和 Experience Cloud 身份服务。

点击流数据集成

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

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

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

步骤 9：测试和验证 section-f857542bfc70496dbb9f318d6b3ae110

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

TIP

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

所有解决方案

检查：

托管页面的域中的 AMCV Cookie。
使用 Adobe 调试器或首选调试工具检查 Experience Cloud ID (MID)。

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

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：部署 section-4188fa95e7dc455a986b48a6c517c1c9

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

如果已启用宽限期：

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

recommendation-more-help

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a