Show Menu
主题×

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 参数

根据您设置的标记(
true
false
),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