Adobe隐私JavaScript库概述

作为数据处理者,Adobe会根据贵公司授予的权限和指示处理个人数据。 作为“数据控制者”,您可以决定 Adobe 代表您处理和存储的个人数据。根据您选择通过Adobe Experience Cloud解决方案发送的信息,Adobe可以存储适用于隐私法规(例如 General Data Protection Regulation (GDPR)和 California Consumer Privacy Act (CCPA)。 请参阅 Adobe Experience Cloud中的隐私 有关Experience Cloud解决方案如何收集私有数据的更多信息。

Adobe隐私JavaScript库 允许数据控制者自动检索由 Experience Cloud 特定域的解决方案。 使用由提供的API Adobe Experience Platform Privacy Service,则可以使用这些标识为属于这些数据主体的私有数据创建访问和删除请求。

注意

的 Privacy JS Library 通常只需要在与隐私相关的页面上安装,也不需要在网站或域的所有页面上安装。

函数

的 Privacy JS Library 提供了在 Privacy Service. 这些函数只能用于管理存储在浏览器中的特定访客身份。 它们不能用于向 Experience Cloud Central Service 直接。

下表概述了库提供的不同功能:

函数 描述
retrieveIdentities 返回匹配标识的数组(validIds),检索自 Privacy Service,以及一组未找到的身份(failedIds)。
removeIdentities 从浏览器中删除每个匹配(有效)的标识。 返回匹配标识的数组(validIds),其中每个标识包含 isDeletedClientSide 布尔值,指示此ID是否已删除。
retrieveThenRemoveIdentities 检索匹配身份的数组(validIds),然后从浏览器中删除这些身份。 此函数类似于 removeIdentities,当您使用的Adobe解决方案在可能删除之前需要访问请求时(例如,在删除请求中提供唯一标识符之前必须检索到该唯一标识符),最好使用该标识符。
注意

removeIdentitiesretrieveThenRemoveIdentities 仅从浏览器中删除支持特定Adobe解决方案的身份。 例如,Adobe Audience Manager不会删除存储在第三方Cookie中的Demdex ID,而Adobe Target会删除存储其ID的所有Cookie。

由于所有三个函数都表示异步进程,因此任何检索到的身份都必须使用回调或承诺进行处理。

安装

开始使用 Privacy JS Library,则必须使用以下方法之一将其安装到计算机上:

您还可以通过数据收集UI中的标记扩展来安装库。 请参阅 Adobe隐私标记扩展 以了解更多信息。

实例化 Privacy JS Library

所有利用 Privacy JS Library 必须实例化新 AdobePrivacy 对象,必须将其配置为特定的Adobe解决方案。 例如,Adobe Analytics的实例化如下所示:

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

有关不同Adobe解决方案支持的参数的完整列表,请参阅附录中的“受支持”部分 Adobe解决方案配置参数.

代码示例

以下代码示例演示了如何使用 Privacy JS Library 对于一些常见情况,前提是您未使用标记。

Retrieve identities

此示例演示如何从中检索标识列表 Experience Cloud.

JavaScript

以下代码定义一个函数, handleRetrievedIDs,用作回调或承诺处理 retrieveIdentities.

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);
Variable 描述
validIds 一个JSON对象,其中包含已成功检索的所有ID。
failedIDs 一个JSON对象,其中包含未从中检索的所有ID Privacy Service,或找不到其他内容。

结果

如果代码成功执行, validIDs 中填充了已检索身份的列表。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

Remove identities

此示例演示了如何从浏览器中删除标识列表。

JavaScript

以下代码定义一个函数, handleRemovedIDs,用作回调或承诺处理 removeIdentities 从浏览器中删除后,才会删除这些区段。

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…
变量 描述
validIds 一个JSON对象,其中包含已成功检索的所有ID。
failedIDs 一个JSON对象,其中包含未从中检索的所有ID Privacy Service,或找不到其他内容。

结果

如果代码成功执行, validIDs 中填充了已检索身份的列表。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

后续步骤

通过阅读本文档,您了解了 Privacy JS Library. 使用库检索标识列表后,您可以使用这些标识创建数据访问和删除 Privacy Service API。 请参阅 Privacy ServiceAPI指南 以了解更多信息。

附录

本节包含有关使用 Privacy JS Library.

Adobe解决方案配置参数

以下是受支持Adobe解决方案的已接受配置参数列表,在 实例化AdobePrivacy对象.

所有解决方案

参数 描述
key 标识用户或数据主体的唯一ID。 此属性专门用于您自己的内部跟踪目的,不供Adobe使用。

Adobe Analytics

参数 描述
cookieDomainPeriods 域中用于Cookie跟踪的句点数(默认为 2,例如 .domain.com)。 除非在JavaScript网站信标中指定,否则请勿在此处定义它。
dataCenter Adobe数据收集数据中心。 仅当在JavaScript网站信标中指定时,才应包含此内容。 潜在值包括:
  • d1:圣何塞数据中心
  • d2:达拉斯数据中心
reportSuite 在JavaScript网站信标中指定的报表包ID(例如, s_code.jsdtm)。
trackingServer 非SSL数据收集域。 仅当在JavaScript网站信标中指定时,才应包含此内容。
trackingServerSecure SSL数据收集域。 仅当在JavaScript网站信标中指定时,才应包含此内容。
visitorNamespace 用于对访客进行分组的命名空间。 仅当在JavaScript网站信标中指定时,才应包含此内容。

Adobe Audience Manager

参数 描述
aamUUIDCookieName 包含从Adobe Audience Manager返回的唯一用户ID的第一方Cookie的名称。

Adobe Experience Cloud Identity Service(ECID)

参数 描述
imsOrgID 您的IMS组织ID。

Adobe Target

参数 描述
clientCode 在Adobe Target系统中标识客户端的客户端代码。

在此页面上