Privacy Service疑难解答指南

Adobe Experience Platform Privacy Service提供RESTful API和用户界面,帮助公司管理客户数据隐私请求。 借助Privacy Service,您可以提交访问和删除私人或个人客户数据的请求,从而促进自动遵守组织和法律隐私法规。

本文档提供了有关Privacy Service的常见问题解答以及API中常见错误的信息。

在API中提出隐私请求时,用户和用户ID有何区别? user-ids

为了在API中生成新的隐私作业,请求的JSON有效负载必须包含一个users数组,该数组列出了隐私请求适用的每个用户的特定信息。 users数组中的每一项都是表示特定用户的对象,由其key值标识。

反过来,每个用户对象(或key)包含其自己的userIDs数组。 此数组列出了该特定用户​ 的特定ID值

请考虑以下示例users数组:

"users": [
  {
    "key": "DavidSmith",
    "action": ["access"],
    "userIDs": [
      {
        "namespace": "email",
        "value": "dsmith@acme.com",
        "type": "standard"
      }
    ]
  },
  {
    "key": "user12345",
    "action": ["access", "delete"],
    "userIDs": [
      {
        "namespace": "email",
        "value": "ajones@acme.com",
        "type": "standard"
      },
      {
        "namespace": "ECID",
        "type": "standard",
        "value":  "443636576799758681021090721276",
        "isDeletedClientSide": false
      }
    ]
  }
]

数组包含两个对象,分别表示由其key值(“DavidSmith”和“user12345”)标识的单个用户。 “DavidSmith”只有一个列出的ID(电子邮件地址),而“user12345”有两个列出的ID(电子邮件地址和ECID)。

有关提供用户身份信息的详细信息,请参阅隐私请求身份数据的指南

我可以使用Privacy Service来清除意外发送到Platform的数据吗?

Adobe不支持使用Privacy Service清除意外提交到产品的数据。 Privacy Service旨在帮助您履行对数据主体(或消费者)访问或删除请求的义务。 不支持或允许将Privacy Service用于数据清理或维护。

隐私请求对时间敏感,并且是根据适用的隐私法完成的。 提交不是数据主体/消费者访问或删除请求的请求会影响所有Privacy Service客户以及Privacy Service支持适当法定时间线的能力。 现已设定每日硬性上传限制,以防止滥用服务。

请联系您的Adobe客户团队以协调任何PII或数据问题并提供相应的解决措施。

如何获取有关隐私请求或作业状态的信息?

您可以使用Privacy Service API或用户界面检索有关特定作业的详细信息。

使用 API

要使用Privacy Service API检索特定作业的状态,请使用请求路径中作业的ID向根(GET /)端点发出请求。 有关更多详细信息,请参阅Privacy Service API指南中检查作业的状态部分。

使用UI

所有活动的作业请求都列在Privacy Service UI仪表板上的​ 作业请求 ​小部件中。 每个作业请求的状态显示在​ 状态 ​列下。 有关在UI中查看作业请求的更多信息,请参阅Privacy Service用户指南

如何下载已完成的隐私作业的结果?

Privacy Service API和用户界面都提供了以ZIP格式下载已完成作业结果的方法。

使用 API

使用要在请求路径中下载其结果的作业的ID向Privacy Service API中的根(GET /)端点发出请求。 如果作业的状态为“完成”,则API将在响应正文中包含downloadURL属性。 此属性包含一个URL,您可以将其粘贴到浏览器的地址栏来下载ZIP文件。

有关更多详细信息,请参阅Privacy Service API指南中的按作业ID查找作业部分。

使用UI

在Privacy Service UI仪表板上,从​ 作业请求 ​构件中查找要下载的作业。 选择作业的ID以打开“作业详细信息”页。 从此处,选择右上角的​ 下载 ​以下载ZIP文件。 有关更多详细步骤,请参阅Privacy Service用户指南

常见错误消息 common-error-messages

下表概述了Privacy Service中的一些常见错误,并提供了帮助解决其各自问题的说明。

错误消息
描述
未找到用户 ID。
无法找到请求中提供的某些用户ID,已跳过这些ID。 确保在请求有效负载中使用正确的命名空间和ID值。 有关更详细的说明,请参阅上的文档,提供身份数据
命名空间无效
为用户ID提供的身份命名空间无效。 有关接受的命名空间列表,请参阅Privacy Service API指南附录中有关标准身份命名空间的部分。 如果您使用自定义命名空间,请确保将ID的type属性设置为“custom”。
部分完成
作业已成功完成,但某些数据不适用于给定的请求,已跳过。
数据不是要求的格式。
指定应用程序的一个或多个数据值的格式不正确。 有关更多信息,请查看作业详细信息。
已配置 IMS 组织。
当您的组织尚未配置Privacy Service时,会发生此消息。 有关详细信息,请与管理员联系。
需要访问和权限。
要使用Privacy Service,需要访问和权限。 请与管理员联系以获取访问权限。
上载和归档访问数据时出现问题。
发生此错误时,请重新上传访问数据并重试。
工作负载超出了当前的文档速率限制。
发生此错误时,请降低提交率并重试。
请求过多
(HTTP 429错误)
如果您的提交模式超过了受监控的允许数据主体作业限制,您将收到HTTP 429错误,以响应来自组织的持续流量。 Privacy Service用于处理数据主体隐私请求。 不用于数据清理。 如果您收到HTTP 429错误,将实施限制和请求限制以保护Adobe免受可能使合法合规工作面临风险的滥用。
通过设置数据集到期计划并使用记录删除功能提供了用于最小化数据的备用方法。 有关如何应用这些功能的更多信息,请参阅各自的文档。
recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580