isCoopSafe

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

要求

要使用isCoopSafe,您必须:

  • 使用DIL v6.11或更高版本。

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

  • 请与Adobe顾问合作,在您的设允许列表备协作帐阻止列表户上设置或标志。 没有自助路径可启用这些标志。

用例

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

用例 描述

经过身份验证的访客

isCoopSafe 添加到DIL代码,以控制设备合作社如何使用已验证的访客(具有或尚未接受使用期限协议)的数据来构建设备图。

第三方网站上的 DIL

isCoopSafe 添加到DIL代码中,以便在以下站点上使用:

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

语法和代码示例

语法:isCoopSafe: true | false

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

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

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

代码示例

当DIL实例化时设置此值。

var dilInstance = DIL.create({ 
     ... 
     isCoopSafe: true 
});

事件调用 POST 参数

根据您设置的标志(truefalse),DIL将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 描述

dilInstance.api.setAsCoopSafe();

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

dilInstance.api.setAsCoopUnsafe();

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

在此页面上

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