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 Service. 这些函数只能用于管理存储在浏览器中以供特定访客使用的标识。 不能使用它们将信息提交到 Experience Cloud Central Service 直接。
下表概述了库提供的各种功能:
retrieveIdentities
validIds
)中检索到的对象 Privacy Service以及未找到的一组标识(failedIds
)。removeIdentities
validIds
),每个标识都包含 isDeletedClientSide
布尔值,指示此ID是否已删除。retrieveThenRemoveIdentities
validIds
),然后从浏览器中删除这些标识。 虽然此函数类似于 removeIdentities
,当您使用的Adobe解决方案要求先访问请求然后才能删除时(例如,在删除请求中提供标识符之前必须检索唯一标识符时),最好使用此标识符。removeIdentities
和 retrieveThenRemoveIdentities
仅从浏览器中删除支持身份的特定Adobe解决方案的身份。 例如,Adobe Audience Manager不会删除存储在第三方Cookie中的Demdex ID,而Adobe Target会删除存储其ID的所有Cookie。由于所有三个函数都表示异步进程,因此必须使用回调或承诺来处理任何检索到的身份。
安装
要开始使用 Privacy JS Library,您必须使用以下方法之一将其安装到计算机上:
- 通过运行以下命令使用npm安装:
npm install @adobe/adobe-privacy
- 从下载 Experience CloudGitHub存储库
您还可以通过标记扩展来安装库。 请参见 Adobe隐私标记扩展 了解更多信息。
实例化 Privacy JS Library
所有利用 Privacy JS Library 必须实例化新的 AdobePrivacy
对象,必须将其配置为特定的Adobe解决方案。 例如,Adobe Analytics的实例化将类似于以下内容:
var adobePrivacy = new AdobePrivacy({
imsOrgID: "{ORG_ID}",
reportSuite: "{REPORT_SUITE_ID}",
trackingServer: "{SERVER_URL}",
clientCode: "{TARGET_CLIENT_CODE}"
});
有关各种Adobe解决方案支持的参数的完整列表,请参阅附录中受支持的部分 Adobe解决方案配置参数.
代码示例 samples
以下代码示例演示了如何使用 Privacy JS Library 对于多种常见场景,前提是您未使用标记。
Retrieve identities
此示例演示如何从检索标识列表 Experience Cloud.
JavaScript
以下代码定义了一个函数, handleRetrievedIDs
,用作回调或promise以处理检索到的身份 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);
validIds
failedIDs
结果
如果代码执行成功, 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
,用作回调或promise以处理检索到的身份 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
failedIDs
结果
如果代码执行成功, 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解决方案配置参数 config-params
以下是受支持Adobe解决方案所接受的配置参数列表,这些参数用于 实例化AdobePrivacy对象.
所有解决方案
key
Adobe Analytics
cookieDomainPeriods
2
,例如 .domain.com
)。 除非在JavaScript Web信标中指定,否则不要在此处定义它。dataCenter
Adobe数据收集数据中心。 仅当在JavaScript Web信标中指定它时,才应包含它。 潜在值包括:
d1
:圣何塞数据中心d2
:达拉斯数据中心
reportSuite
s_code.js
或 dtm
)。trackingServer
trackingServerSecure
visitorNamespace
Adobe Audience Manager
aamUUIDCookieName
Adobe Experience Cloud Identity服务(ECID)
imsOrgID
Adobe Target
clientCode