isCoopSafe

这是一个可选的布尔型配置,用于确定 ID 服务是否会将数据发送到 Adobe Experience Cloud 设备协作。

目录:

要求

要使用 isCoopSafe,您必须满足以下条件:

  • 使用 ID 服务代码版本 2.4 或更高版本。

  • 参与 Experience Cloud 设备协作。潜在的协作成员也应查阅此文档,以确定 isCoopSafe 是否可以解决可能与如何使用数据来创建设备图有关的问题。

  • 与您的 Adobe 顾问合作,在您的设备协作帐户中设置一个白名单或黑名单标记。不存在启用这些标记的自助途径。

用例

isCoopSafe 可帮助解决以下 2 个与设备协作的当前成员或潜在成员进行的收集数据有关的用例。这两个用例与如何将网站访客数据传递到设备协作以帮助构建设备图有关。下表描述了 isCoopSafe 如何在这两个用例中使用,以阻止数据发送至设备图或将数据发送至设备图。

用例 描述

已通过身份验证的访客

isCoopSafe 添加到您的 ID 服务代码,以控制设备协作如何使用经过身份验证的访客(已接受或未接受使用条款协议)的数据来构建设备图。

第三方网站上的 DIL

isCoopSafe 添加到您的 ID 服务代码以供在第三方网站上使用,在这些网站中:

  • 无法确保已通过身份验证的访客是否接受了使用条款协议。
  • 需要控制设备协作如何使用该数据来构建设备图。

语法和代码示例

语法:isCoopSafe: true | false

布尔选项可确定设备协作是否可以使用客户数据。

  • isCoopSafe: true:通过 Mobile SDK 或网站收集的访客数据​可以​用来帮助构建设备图。

  • isCoopSafe: false:通过 Mobile SDK 或网站收集的访客数据​不能​用来帮助构建设备图。

代码示例

在 ID 服务代码实例化时进行此设置:

var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here",{ 
     ... 
     isCoopSafe: true 
});

事件调用 POST 参数

根据您设置的标记(truefalse),ID 服务会将 isCoopSafe 转换为以下 POST 参数,并在事件调用中将它们发送至 Adobe:

  • d_coop_safe=1
  • d_coop_unsafe=1

这两个 POST 参数告知 Experience Cloud 设备协作是否可以在设备图中包含用户数据。下表定义了 isCoopSafe 布尔标记与在事件调用中传入的 POST 参数之间的关系。如果您没有使用 isCoopSafe,则无法在事件调用中传递这两个参数。

配置状态 POST 参数

isCoopSafe: true

d_coop_safe=1

设备协作可以使用访客数据来帮助构建设备图。

isCoopSafe: false

d_coop_unsafe=1

设备协作不能使用访客数据来帮助构建设备图。

实例化后 API

这些 API 允许您覆盖 isCoopSafe 状态。这些 API 是必需的,因为它们允许您在网站或页面不刷新的单页应用程序中更改访客的实例化后/登录后状态。例如,如果用户在您的网站或应用程序中进行身份验证,并且稍后接受允许设备协作使用其数据的使用条款策略,则您需要调用这些 API。

API 描述

visitor.setAsCoopSafe();

在所有后续事件调用中设置 POST 参数 d_coop_safe=1

visitor.setAsCoopUnsafe();

在所有后续事件调用中设置 POST 参数 d_coop_unsafe=1

在此页面上