实施适用于 Analytics 的 Experience Cloud Identity 服务 implement-the-experience-cloud-id-service-for-analytics

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

主题：

创建对象：

开发人员
用户
管理员
领导

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

IMPORTANT

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

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

步骤 1：下载 ID 服务代码 section-ead9403a6b7e45b887f9ac959ef89f7f

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

转到 管理员 > 代码管理器。
在代码管理器中，单击 JavaScript（新版） 或 JavaScript（旧版）。

此下载文件对代码库进行了压缩。
解压缩代码文件，并打开 VisitorAPI.js 文件。

步骤 2. 将 Visitor.getInstance 函数添加到 ID 服务代码 section-6053a6b7c16c466a9f9fdbf9cb9db3df

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
});

步骤 3：将您的 Experience Cloud 组织 ID 添加到 Visitor.getInstance section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

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

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

IMPORTANT

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

步骤 4：将您的跟踪服务器添加到 Visitor.getInstance section-70ec9ebff47940d8ab520be5ec4728c5

跟踪服务器可用于 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 变量。

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

将这个函数添加到您的 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 代码添加到页面 section-d46d6aa324c842f2931d901e38d6db1d

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

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

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

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

如果这些用例中的任何一个用例适用于您的情况，请联系客户关怀以设置临时宽限期。宽限期最长可达 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 服务代码 section-e9c1764ac21a4ec5be1ff338c0e2e01b

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

测试和验证

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

在托管页面的域中检查 AMCV Cookie。
使用 Adobe 调试器工具在 Analytics 图像请求中检查 MID 值。

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

部署代码

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

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

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

recommendation-more-help

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