在Privacy Service API中建立包含多個使用者和身分型別的隱私權請求
本文說明如何使用Privacy ServiceAPI建立包含多個使用者和身分型別的隱私權JSON請求。 Privacy ServiceUI僅允許每個請求使用單一名稱空間型別,但透過API,您可以在單一JSON裝載中建立包含多個身分型別的請求。 本文包含範例JSON,並逐步說明如何設定請求。
說明 description
環境
Adobe Experience Platform
問題/症狀
Privacy Service介面(UI)目前僅支援為每個請求建立單一身分型別的請求。 不過,使用Privacy Service API時,可建立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 Service API建立新的隱私權請求,請遵循下列步驟:
-
從編撰JSON請求開始。 這包括定義
companyContexts,其中包含用於驗證的Adobe組織ID。 此ID符合您在請求標頭中提供的值。 -
為每位使用者指派一個唯一 key,並在 userIDs 下提供其識別碼。 這些識別碼應包含名稱空間、型別和值。 在範例中,使用者有識別碼,例如電子郵件、ECID和CRM ID。
-
針對每個使用者,加入指定要針對使用者資料執行的動作的 動作 陣列,例如存取、刪除,或兩者皆執行。
-
在 包含 欄位下,列出將處理隱私權請求的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的作業端點。 成功的回應將傳回新建立工作的詳細資料,以便進一步追蹤或處理。
依照這些步驟,您可以為多個使用者和身分型別建立完整的隱私權請求,以確保符合相關的隱私權法規。