在隐私服务API中创建具有多个用户和身份类型的隐私请求
本文介绍如何使用Privacy ServiceAPI创建具有多个用户和身份类型的隐私JSON请求。 Privacy ServiceUI只允许每个请求使用单个命名空间类型,但通过API,您可以在单个JSON有效负载中构建具有多个身份类型的请求。 本文包括示例JSON以及如何配置请求的分步说明。
描述 description
环境
Adobe Experience Platform
问题/症状
Privacy Service界面(UI)当前仅支持为每个请求创建具有单一身份类型的请求。 但是,在使用Privacy ServiceAPI时,可以创建一个JSON请求,该请求包含适用于不同用户的多种身份类型。 此方法对于处理涉及单个或多个用户的各种数据源和标识符的隐私请求很有用。
以下是涉及多个用户和身份类型的隐私请求的JSON示例:
{
"companyContexts": [
{
"namespace": "imsOrgID",
"value": "{{IMS ORG}}"
}
] ,
"users": [
{
"key": "dbt26cf6-1942-4c4a-82bd-d790e647cxxx",
"action": [
"access"
] ,
"userIDs": [
{
"namespace": "email",
"value": "dsmith@axxx.com",
"type": "standard"
},
{
"namespace": "ECID",
"type": "standard",
"value": "443636576799758681021090721xxx",
"isDeletedClientSide": false
}
]
},
{
"key": "8dd7e4d8-13d3-442f-85d8-5e2f0779exxx",
"action": [
"access",
"delete"
] ,
"namespace": "email",
"value": "ajones@axxx.com",
"type": "standard"
},
{
"namespace": "CRM ID",
"value": "12AD45FE30xxx",
"type": "analytics"
}
] ,
"include": [
"Analytics",
"AdobeCloudPlatform",
"profileService"
] ,
"regulation": "сра"
}
解决方法 resolution
要使用Privacy ServiceAPI创建新的隐私请求,请执行以下步骤:
-
首先从构建JSON请求开始。 这包括定义
companyContexts,包括用于身份验证的Adobe组织ID。 此ID与您在请求标头中提供的值相匹配。 -
为每个用户分配一个 唯一 键 并在 userIDs 下提供其标识符。 这些标识符应包括 命名空间、类型 和 值。 在示例中,用户具有标识符,如 电子邮件、ECID 和 CRM ID。
-
对于每个用户,包括一个指定要对用户数据执行的操作的 操作 数组,如 访问、删除 或两者。
-
在 include 字段下,列出将处理隐私请求的Adobe Experience Cloud产品(如 Analytics、AdobeCloudPlatform、profileService)。
-
指定提交请求的 条例。 支持的值包括:
- gdpr (欧盟)
- ccpa (加利福尼亚)
- lgpd_bra (巴西)
- nzpa_nzl (新西兰)
- pdpa_tha (泰国)
- apa_aus (澳大利亚)
- cpa (科罗拉多)
- cpra_usa (加利福尼亚)
- ctdpa (康涅狄格州)
- hipaa_usa (美国)
- ucpa_usa (犹他州)
- vcdpa_usa (弗吉尼亚)
-
配置JSON请求后,将其发送到隐私API的作业端点。 成功的响应将返回新创建作业的详细信息,这些信息可进一步跟踪或处理。
通过执行以下步骤,您可以为多个用户和身份类型创建全面的隐私请求,以确保遵守相关隐私法规。