实施适用于 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.jsAppMeasurement.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.jss_code.js 文件:

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

将这个代码放置在包含 linkInternalFilterscharSettrackDownloads 等配置的相同部分中。

**(可选,但是推荐)​创建自定义 prop **

AppMeasurement.jss_code.js 中设置自定义 prop 以测量覆盖范围。将此自定义 prop 添加到 AppMeasurement.jss_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_highvisid_low 列的流程中的数据发送至内部系统,则需要设置宽限期。

当您的数据获取流程可以使用 post_visid_highpost_visid_low 列之后,就可以中止宽限期。

请参阅点击流数据列引用

点击流数据获取

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

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

测试和验证

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

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

部署代码

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

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

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now