设置选择加入服务 setting-up-opt-in-service

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

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

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

先决条件 section-c39246f45e514c8ea9fdbe6f7ffa3ad0

  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 Experience Platform 中的标记,请利用选择加入扩展配置选择加入服务。

选择加入类别 section-9ab0492ab4414f0ca16dc08d3a905f47

访客的选择加入首选项与 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 后,可以更改访客的权限。请参阅对同意的更改,以获取管理同意函数的列表。

选择加入工作流程 section-70cd243dec834c8ea096488640ae20a5

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

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

请参阅工作流程配置设置

检查访客的选择加入权限 section-f136a9024e054d84881e6667fb7c94eb

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

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 文档,了解有关这些内容以及本文档中提到的所有函数、属性或配置的更多详细信息。

存储访客首选项 section-ef2884ae67e34879bf7c7c3372706c9f

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

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

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