Show Menu
主题×

isCoopSafe

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

要求

To use isCoopSafe you must:
  • 使 DIL 用v6.11或更高版本。
  • 参与 Experience Cloud 设备协作 。潜在的协作成员也应查阅此文档,以确定 isCoopSafe 是否可以解决可能与如何使用数据来创建设备图有关的问题。
  • Work with your Adobe consultant to set an allowlist or a denylist flag on your Device Co-op account. 没有自助路径可启用这些标志。

用例

isCoopSafe 可帮助解决以下 2 个与设备协作的当前成员或潜在成员进行的收集数据有关的用例。这两个用例与如何将网站访客数据传递到设备协作以帮助构建设备图有关。下表描述了 isCoopSafe 如何在这两个用例中使用,以阻止数据发送至设备图或将数据发送至设备图。
用例 描述
经过身份验证的访客
Add isCoopSafe to your DIL code to control how data for authenticated visitors who have or have not accepted term-of-use agreements is used by the Device Co-op to build the device graph.
第三方网站上的 DIL
Add isCoopSafe to your DIL code for use on third-party sites where you:
  • 您无法确保经过身份验证的访客是否已接受使用条款协议。
  • 您需要控制设备协作如何使用该数据来构建设备图。

语法和代码示例

语法: isCoopSafe: true | false
布尔选项可确定设备协作是否可以使用客户数据。
  • isCoopSafe: true :通过 Mobile SDK 或网站收集的访客数据​ 可以 ​用来帮助构建设备图。
  • isCoopSafe: false :通过 Mobile SDK 或网站收集的访客数据​ 不能 ​用来帮助构建设备图。
代码示例
在DIL实例化时设置此设置。
var dilInstance = DIL.create({ 
     ... 
     isCoopSafe: true 
});

事件调用 POST 参数

Depending on the flag you set ( true or false ), DIL translates isCoopSafe into these POST parameters and sends them to Adobe in an event call:
  • 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 描述
dilInstance.api.setAsCoopSafe();
Sets POST parameter d_coop_safe=1 in all subsequent event calls.
dilInstance.api.setAsCoopUnsafe();
Sets POST parameter d_coop_unsafe=1 in all subsequent event calls.