这是一个可选的布尔型配置,用于确定 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
});
根据您设置的标记(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 允许您覆盖 isCoopSafe
状态。这些 API 是必需的,因为它们允许您在网站或页面不刷新的单页应用程序中更改访客的实例化后/登录后状态。例如,如果用户在您的网站或应用程序中进行身份验证,并且稍后接受允许设备协作使用其数据的使用条款策略,则您需要调用这些 API。
API | 描述 |
---|---|
visitor.setAsCoopSafe(); |
在所有后续事件调用中设置 POST 参数 d_coop_safe=1。 |
visitor.setAsCoopUnsafe(); |
在所有后续事件调用中设置 POST 参数 d_coop_unsafe=1。 |