在Data Lake中处理隐私请求

Adobe Experience PlatformPrivacy Service处理客户访问、销选择退出售或删除其个人数据的请求，这些请求由法律和组织隐私法规规定。

此文档涵盖与处理存储在Data Lake中的客户数据的隐私请求相关的基本概念。

入门指南

在阅读本指南之前，建议您对以下Experience Platform服务有正确的了解：

Privacy Service:管理跨Adobe Experience Cloud应用程序访问、选择退出销售或删除其个人数据的客户请求。
Catalog Service:数据位置和谱系的记录系统 Experience Platform。提供可用于更新数据集元数据的API。
Experience Data Model (XDM) System:组织客户体验数 Experience Platform 据的标准化框架。
Identity Service:通过跨设备和系统桥接身份，解决客户体验数据碎片化带来的根本挑战。

了解身份命名空间

Adobe Experience PlatformIdentity Service跨系统和设备连接客户身份数据。 Identity Service 使用身份命名空间将身份值与其来源系统关联，从而提供与身份值相关的上下文。命名空间可以表示一个通用概念，如电子邮件地址（“电子邮件”），或将标识与特定应用程序(如Adobe Advertising CloudID(“AdCloud”)或Adobe TargetID(“TNTID”))关联。

Identity Service 维护全局定义（标准）和用户定义（自定义）标识命名空间的存储。标准命名空间适用于所有组织（例如，“电子邮件”和“ECID”），而您的组织也可以创建自定义命名空间以满足其特定需求。

有关Experience Platform中的标识命名空间的详细信息，请参阅标识命名空间概述。

向数据集添加标识数据

为Data Lake创建隐私请求时，必须为每个客户提供有效身份值(及其关联命名空间)，以便找到其数据并相应地处理它们。因此，所有受隐私请求约束的数据集都必须在其关联的XDM模式中包含标识描述符。

注意

当前无法在隐私请求中处理任何基于不支持身份描述符元数据的模式集（如临时数据集）。

本节将逐步介绍向现有数据集的XDM模式添加标识描述符的步骤。如果已有带有标识描述符的数据集，可跳到下一节。

重要

在确定要设置为标识的模式字段时，请牢记使用嵌套映射类型字段](#nested-maps)的[限制。

有两种方法可将标识描述符添加到数据集模式:

使用UI
使用API

使用UI

在Experience Platform用户界面中，模式工作区允许您编辑现有XDM模式。要向模式添加标识描述符，请从列表中选择该模式，然后按照教程中将模式字段设置为标识字段的步骤操作。Schema Editor

在将模式中的相应字段设置为标识字段后，您可以继续执行有关提交隐私请求的下一节。

使用API

注意

本节假定您知道数据集的XDM模式的唯一URI ID值。如果您不知道此值，可以使用Catalog Service API检索它。在阅读开发人员指南的getting started部分后，按照listing或查找 Catalog对象中概述的步骤查找数据集。模式ID位于schemaRef.id下

此部分包括对模式注册表API的调用。有关使用API的重要信息(包括了解您的{TENANT_ID}和容器概念)，请参阅开发人员指南的入门部分。

可以通过向Schema Registry API中的/descriptors端点发出POST请求，将标识描述符添加到数据集的XDM模式。

API格式

POST /descriptors

请求

以下请求在示例模式的“电子邮件地址”字段上定义标识描述符。

curl -X POST \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '
      {
        "@type": "xdm:descriptorIdentity",
        "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
        "xdm:sourceVersion": 1,
        "xdm:sourceProperty": "/personalEmail/address",
        "xdm:namespace": "Email",
        "xdm:property": "xdm:code",
        "xdm:isPrimary": false
      }'

属性	描述
`@type`	所创建描述符的类型。对于标识描述符，该值必须为“xdm:descriptorIdentity”。
`xdm:sourceSchema`	数据集XDM模式的唯一URI ID。
`xdm:sourceVersion`	`xdm:sourceSchema`中指定的XDM模式版本。
`xdm:sourceProperty`	模式符所应用的描述符字段的路径。
`xdm:namespace`	由Privacy Service识别的标准标识命名空间或由您的组织定义的自定义命名空间。
`xdm:property`	根据`xdm:namespace`下使用的命名空间符，可选择“xdm:id”或“xdm:code”。
`xdm:isPrimary`	可选布尔值。如果为true，则表示字段是主标识。模式只能包含一个主标识。如果不包括，则默认为false。

响应

成功的响应返回HTTP状态201（已创建）和新创建描述符的详细信息。

{
  "@type": "xdm:descriptorIdentity",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/personalEmail/address",
  "xdm:namespace": "Email",
  "xdm:property": "xdm:code",
  "xdm:isPrimary": false,
  "meta:containerId": "tenant",
  "@id": "f3a1dfa38a4871cf4442a33074c1f9406a593407"
}

提交请求

注意

本节介绍如何设置Data Lake的隐私请求的格式。强烈建议您查看Privacy Service UI或Privacy Service API文档，了解有关如何提交隐私作业的完整步骤，包括如何在请求负载中正确设置提交的用户身份数据的格式。

以下部分概述了如何使用Privacy Service UI或API向Data Lake发出隐私请求。

重要

无法保证完成隐私请求所花费的时间。如果在请求仍在处理时数据湖中发生更改，则也无法保证是否处理了这些记录。

使用UI

在UI中创建作业请求时，请务必在产品下选择AEP用户档案湖和／或，以分别处理存储在Data Lake或Real-time Customer Profile中的数据的作业。

使用API

在API中创建作业请求时，提供的任何userIDs必须使用特定的namespace和type，具体取决于它们所应用的数据存储。 Data Lake的ID必须对其type值使用“未注册”，并且namespace值与已添加到适用数据集的隐私标签中的一个匹配。

此外，请求有效负荷的include数组必须包含请求所针对的不同数据存储的产品值。向Data Lake发出请求时，阵列必须包含值aepDataLake。

以下请求使用未注册的“email_label”命名空间为Data Lake创建新的隐私作业。它还包括include阵列中Data Lake的产品值：

curl -X POST \
  https://platform.adobe.io/data/core/privacy/jobs \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -d '{
    "companyContexts": [
      {
        "namespace": "imsOrgID",
        "value": "{IMS_ORG}"
      }
    ],
    "users": [
      {
        "key": "user12345",
        "action": ["access","delete"],
        "userIDs": [
          {
            "namespace": "email_label",
            "value": "ajones@acme.com",
            "type": "unregistered"
          },
          {
            "namespace": "email_label",
            "value": "jdoe@example.com",
            "type": "unregistered"
          }
        ]
      }
    ],
    "include": ["aepDataLake"],
    "expandIds": false,
    "priority": "normal",
    "regulation": "ccpa"
}'

删除请求处理

当Experience Platform收到来自Privacy Service的删除请求时，Platform会向Privacy Service发送确认，确认已收到该请求，且受影响的数据已被标记为删除。然后，在七天内从Data Lake中删除记录。在这七天的窗口期间，数据被软删除，因此任何Platform服务都无法访问。

在将来的版本中，Platform将在数据被物理删除后向Privacy Service发送确认信息。