Adobe隐私JavaScript库概述

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

Adobe 隐私JavaScript库 ,使数据控制器能够自动检索由特定域的解决方案生成的 Experience Cloud 所有数据主体身份。 使用Adobe Experience Platform Privacy Service提 供的API,这些身份随后可以用于创建对属于这些数据主体的私人数据的访问和删除请求。

注意

通 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解决方案在删除之前需要访问请求时使用此函数(例如,在删除请求中提供唯一标识符之前必须检索该标识符)。
注意

removeIdentities 并且只 retrieveThenRemoveIdentities 从浏览器中删除支持这些身份的特定Adobe解决方案。 例如,Adobe Audience Manager不删除存储在第三方Cookie中的demdex ID,而Adobe Target删除存储其ID的所有Cookie。

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

安装

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

  • 使用npm运行以下命令进行安装: npm install @adobe/adobe-privacy
  • 使用名称下的Adobe启动扩展 AdobePrivacy
  • 从Experience CloudGitHub存 储库下载

实例化 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 不使用或DTM的情况下对几个常见情 Launch 形使用。

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或者找不到其他ID。

结果

如果代码成功执行, 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)…
Variable 描述
validIds 一个JSON对象,其中包含已成功检索的所有ID。
failedIDs 一个JSON对象,包含所有未从中检索的ID, Privacy Service或者找不到其他ID。

结果

如果代码成功执行, 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。 使用库检索身份列表后,您可以使用这些身份创建数据访问和删除对API的请 Privacy Service 求。 有关更多 信息,请参 阅Privacy Service开发人员指南。

附录

本节包含使用的补充信息 Privacy JS Library。

Adobe解配置参数

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

Adobe Analytics

参数 描述
cookieDomainPeriods 域中用于cookie跟踪的句点数(默认为2)。
dataCenter Adobe数据收集数据中心。 仅当在JavaScript Web信标中指定时,才应包含此内容。 潜在值为:
  • "d1":圣何塞数据中心。
  • "d2":达拉斯数据中心。
reportSuite 在JavaScript Web信标中指定的报表包ID(例如,“s_code.js”或“dtm”)。
trackingServer 数据收集域(非SSL)。 仅当在JavaScript Web信标中指定时,才应包含此内容。
trackingServerSecure 数据收集域(SSL)。 仅当在JavaScript Web信标中指定时,才应包含此内容。
visitorNamespace 命名空间用于分组访客。 仅当在JavaScript Web信标中指定时,才应包含此内容。

Adobe Target

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

Adobe Audience Manager

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

Adobe ID服务(ECID)

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

在此页面上