这些说明适用于那些想要使用 Experience Cloud Identity 服务而不使用 Dynamic Tag Management (DTM) 的 Analytics 客户。但是,我们强烈建议您使用 DTM 来实施 ID 服务。DTM 可简化实施工作流程,并自动确保代码放置和排序正确无误。
请按照以下步骤为 Adobe Analytics 实施 ID 服务:
ID 服务 要求具备 VisitorAPI.js
代码库。要下载此代码库,请执行以下操作:
转到管理员 > 代码管理器。
在代码管理器中,单击 JavaScript(新版)或 JavaScript(旧版)。
此下载文件对代码库进行了压缩。
解压缩代码文件,并打开 VisitorAPI.js
文件。
第 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
});
在 Visitor.getInstance
函数中,将 INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
替换为您的 Experience Cloud 组织 ID。如果您不知道自己的组织 ID,可以在 Experience Cloud 管理页面上查找。另请参阅管理 - 核心服务。您编辑的函数看起来类似于下面的示例。
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
请不要更改组织 ID 中字符的大小写。这个 ID 是区分大小写的,因此必须严格按照所提供的形式使用。
跟踪服务器可用于 Analytics 数据收集。
第 1 部分:查找您的跟踪服务器 URL
检查您的 s_code.js
或 AppMeasurement.js
文件,以查找跟踪服务器 URL。您将需要由以下变量指定的 URL:
s.trackingServer
s.trackingServerSecure
第 2 部分:设置跟踪服务器变量
要确定要使用的跟踪服务器变量,请执行以下操作:
在使用时,请将 Experience Cloud 服务器 URL 与它们相对应的跟踪服务器 URL 相匹配,如下所示:
如果您不确定如何找到跟踪服务器,请参阅常见问题解答以及正确填充 trackingServer 和 trackingServerSecure 变量。
将这个函数添加到您的 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");
将 VisitorAPI.js
文件放置在每个页面的 <head>
标记之内。在将 VisitorAPI.js
文件放入页面之后,您可以:
<head>
部分的开头处,使其显示在其他解决方案标记之前。在测试和验证后将此代码移入生产环境中。
如果这些用例中的任何一个用例适用于您的情况,请联系客户关怀以设置临时宽限期。宽限期最长可达 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
列之后,就可以中止宽限期。
请参阅点击流数据列引用。
点击流数据获取
您可以按如下方式进行测试和部署。
测试和验证
要测试 ID 服务的实施状况,请检查以下各项:
另请参阅测试和验证 Experience Cloud Identity 服务。
部署代码
在代码通过测试后,部署代码。
如果您在步骤 7 中启用了宽限期: