Creare una richiesta di privacy con più utenti e tipi di identità nell’API del servizio di privacy
Questo articolo spiega come creare una richiesta JSON per la privacy con più utenti e tipi di identità utilizzando l’API Privacy Service. L’interfaccia utente Privacy Service consente un solo tipo di spazio dei nomi per richiesta, ma con l’API puoi creare una richiesta con più tipi di identità in un singolo payload JSON. Questo articolo include un JSON di esempio e una spiegazione dettagliata di come configurare la richiesta.
Descrizione description
Ambiente
Adobe Experience Platform
Problema/Sintomi
L’interfaccia Privacy Service attualmente supporta solo la creazione di richieste con un singolo tipo di identità per richiesta. Tuttavia, quando utilizzi l’API Privacy Service, è possibile creare una richiesta JSON che includa più tipi di identità per utenti diversi. Questo metodo è utile per gestire le richieste di accesso a dati personali che coinvolgono diverse origini dati e identificatori per uno o più utenti.
Di seguito è riportato un esempio di JSON per una richiesta di privacy che coinvolge più utenti e tipi di identità:
{
"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": "сра"
}
Risoluzione resolution
Per creare una nuova richiesta di accesso a dati personali utilizzando l’API Privacy Service, effettua le seguenti operazioni:
-
Per iniziare, crea la richiesta JSON. Ciò include la definizione di
companyContexts, che include l'ID organizzazione Adobe per l'autenticazione. Questo ID corrisponde al valore fornito nelle intestazioni della richiesta. -
Per ogni utente, assegna un univoco chiave e fornisci i loro identificatori in IDutente. Questi identificatori devono includere namespace, type e value. Nell'esempio sono presenti identificatori quali email, ECID e CRM ID.
-
Per ogni utente, includere un array action specificando le azioni da eseguire sui dati dell'utente, ad esempio access, delete o entrambi.
-
Nel campo include, elenca i prodotti Adobe Experience Cloud (ad esempio Analytics, AdobeCloudPlatform, profileService) che elaboreranno la richiesta di privacy.
-
Specifica il regolamento in cui viene archiviata la richiesta. I valori supportati includono:
- gdpr (Unione Europea)
- ccpa (California)
- lgpd_bra (Brasile)
- nzpa_nzl (Nuova Zelanda)
- pdpa_tha (Thailandia)
- apa_aus (Australia)
- cpa (Colorado)
- cpra_usa (California)
- ctdpa (Connecticut)
- hipaa_usa (Stati Uniti)
- ucpa_usa (Utah)
- vcdpa_usa (Virginia)
-
Dopo aver configurato la richiesta JSON, inviala all’endpoint dei processi dell’API Privacy. In caso di esito positivo, la risposta restituisce i dettagli del processo appena creato, che possono essere tracciati o elaborati ulteriormente.
Seguendo questi passaggi, puoi creare una richiesta di privacy completa per più utenti e tipi di identità, garantendo la conformità alle normative sulla privacy pertinenti.