设置选择加入服务

将选择加入服务作为 Experience Cloud 解决方案(在选择加入中称为类别)使用单个引用点实施,以确定是否在访客的设备上创建 Cookie。

选择加入服务是一个与 Experience Cloud ID (ECID) 捆绑在一起的 JavaScript 库,并且在全局 adobe 对象的访客 JS 中作为 adobe.optIn 对象存在。您可以通过已安装的选择加入服务,指定让访客立即选择加入 Adobe 解决方案,还是按照顺序显示解决方案,让访客逐个授予权限。借助选择加入服务同意管理功能,您可以根据特定的隐私要求使用各种配置来进行实施。

您可以通过选择加入服务,指定让访客立即选择加入 Adobe 解决方案,还是按照顺序显示解决方案,让访客逐个授予权限。批准流程完成并由客户记录后,所有 Adobe 解决方案均可以检索 CMP 访客的批准信息,以响应相关的同意调用。

先决条件

  1. ECID 版本 4.0。

    下载最新 ECID 版本。

  2. 支持的库:

    • ECID 4.0 或更高版本
    • AppMeasurement 2.11 或更高版本
    • DIL 9.0
    • AT.js 版本 1.7.0
    • AT.js Launch 扩展版本 9.0
    • 对于 Analytics,带扩展 1.6 的 App Measurement 2.11
    • 对于 Target,扩展 0.9.1
  3. 精通您将与选择加入配合使用的意见征求管理框架,并了解所有其他先决条件。

  4. 贵公司的隐私权要求将特定于您以何种方式选择符合 GDPR 规定。知道您的公司隐私团队可以在同意前使用哪些库。

如果使用 Adobe Launch,请利用选择加入扩展配置选择加入服务。

选择加入类别

访客的选择加入首选项与 Adobe Experience Cloud 解决方案相关,其中每个解决方案都表示为一个类别。类别由 adobe.OptInCategories 对象提供,例如,其中 ECID 组件称为 adobe.OptInCategoriesECID。以下是 adobe.OptInCategories 的定义:

选择加入设置按类别都进行维护,其中每个 Experience Cloud 解决方案都由一个类别表示:

adobe.OptInCategories = { 
    AAM: "aam", 
    TARGET: "target",  
    ANALYTICS: "aa", 
    ECID: "ecid", 
     
};

选择加入服务允许您根据网站上使用的每个 Adobe 解决方案来设置访客的权限首选项。它包括一个用于按已批准的类别保存访客设置的库,并且支持顺序化的工作流程,其中批准流程每次只接收每个类别的“确认”或“拒绝”首选项。您可以将解决方案/类别设置为作为整体或作为单个解决方案选择加入。所有 Adobe 解决方案客户端库都依赖于选择加入服务,除非该解决方案已被授予权限,否则不会生成 Cookie。选择加入支持为当前访客提供和更新同意设置的各种方法。本节提供了设置选择加入服务首选项的示例。请参阅选择加入 API 引用,以获取函数和参数的完整列表。

选择加入服务配置在访客 JS getInstance() 函数中提供,该函数可实例化全局 adobe 对象。下面列出了选择加入服务的访客 JS 配置设置

初始化全局 Visitor 对象的选择加入配置示例

// FORMAT: Object<adobe.OptInCategories enum: boolean> 
var preOptInApprovalsConfig = {}; 
preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true; 
  
// FORMAT: Object<adobe.OptInCategories enum: boolean> 
// If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP), 
// you have to provide those permissions through the previousPermissions config. 
// previousPermissions will overwrite preOptInApprovals. 
var previousPermissionsConfig = {}; 
previousPermissionsConfig[adobe.OptInCategories.AAM] = true; 
previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false; 
  
Visitor.getInstance("YOUR_ORG_ID", { 
    "doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false. 
    "preOptInApprovals": preOptInApprovalsConfig, 
    "previousPermissions": previousPermissionsConfig, 
    "isOptInStorageEnabled": true 
});

处理征求同意的更改

在访客访问您网站期间的任意时刻,他们可以首次设置偏好设置,也可以使用您的 CMP 更改其偏好设置。使用初始设置初始化访客 JS 后,可以更改访客的权限。请参阅对同意的更改,以获取管理同意函数的列表。

选择加入工作流程

选择加入服务支持可以通过多个请求周期收集权限的工作流程,并且一次提供一个首选项。如果使用以下函数并将 ** 设置为 shouldWaitForCompletetrue,您的解决方案便能够收集一个解决方案或总类别子集的同意情况,然后收集下一个解决方案或类别子集的同意情况。从第一次调用开始,adobe.optIn.status 属性将处于 pending 状态,直到在工作流程结束时调用 adobe.optIn.complete() 为止。调用后,状态将设置为 complete

adobe.optIn.approve(['AAM', 'ECID'], true); 
adobe.optIn.deny(['ANALYTICS'], true); 
adobe.optIn.complete();

请参阅工作流程配置设置

检查访客的选择加入权限

当访客对其权限进行更改时,您需要洞悉由此产生的权限,以便将您的同意存储与选择加入服务中所做的更改同步。例如,使用权限函数检查访客的偏好设置,例如:

fetchPermissions 示例

optIn.fetchPermissions(function (permissions) { 
    // Here you can check if your category has been approved or not. 
    // We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like. 
    if (adobe.optIn.isApproved(MY_CATEGORY) { 
        sendBeacon(); // Or something 
    } 
});

OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward:

function callback() { 
    if (adobe.optIn.isApproved(MY_CATEGORY) { 
        sendBeacon(); // Or something 
    } 
}

optIn.fetchPermissions(callback, true);

请参阅 API 文档,了解有关这些内容以及本文档中提到的所有函数、属性或配置的更多详细信息。

存储访客首选项

选择加入服务提供了一个选项,可用于存储适合开发人员环境或无法使用 CRM 的环境的同意首选项。将配置属性 isOptInStorageEnabled 指定为 true 会触发选择加入服务,以在域中访客系统上创建 Cookie。

adobe.optIn 对象是无状态的,并且不提供存储机制。它旨在让您可以在现有的 Consent Management Platform (CMP) 中管理 Adobe 同意设置(如果它允许存储自定义数据)。或者,您也可以在访客浏览器上的 Cookie 中存储访客偏好设置。您有两个选项可用于将用户首选项提供给选择加入服务:

  • 无论您的同意持久性解决方案是 CMP 还是访客浏览器上的 Cookie,如果允许及时检索访客首选项,则可以在访客初始化期间将这些首选项提供给选择加入服务。
  • 但是,如果检索是一个非常漫长的过程,或者最好作为异步流程进行,您可以在成功加载设置后,使用服务的 approve() 函数来提供这些设置。

On this page

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