Création d’une demande d’accès à des informations personnelles avec plusieurs utilisateurs et types d’identité dans l’API Privacy Service
Cet article explique comment créer une demande JSON d’accès à des informations personnelles avec plusieurs utilisateurs et types d’identité à l’aide de l’API Privacy Service. L’interface utilisateur du Privacy Service n’autorise qu’un seul type d’espace de noms par requête, mais avec l’API, vous pouvez créer une requête avec plusieurs types d’identité dans un seul payload JSON. Cet article comprend un exemple JSON et une explication détaillée de la configuration de la requête.
Description description
Environnement
Adobe Experience Platform
Problème/Symptômes
Actuellement, l’interface du Privacy Service ne prend en charge que la création de requêtes avec un seul type d’identité par requête. Cependant, lors de l’utilisation de l’API du Privacy Service, il est possible de créer une requête JSON qui inclut plusieurs types d’identité pour différents utilisateurs. Cette méthode est utile pour gérer les demandes d’accès à des informations personnelles impliquant plusieurs sources de données et identifiants pour un ou plusieurs utilisateurs.
Voici un exemple JSON pour une demande d’accès à des informations personnelles impliquant plusieurs utilisateurs et types d’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": "сра"
}
Résolution resolution
Pour créer une demande d’accès à des informations personnelles à l’aide de l’API du Privacy Service, procédez comme suit :
-
Commencez par créer la requête JSON. Cela inclut la définition de
companyContexts, qui inclut l’ID d’organisation de votre Adobe pour l’authentification. Cet identifiant correspond à la valeur que vous fournissez dans les en-têtes de requête. -
Pour chaque utilisateur, affectez un unique key et fournissez leurs identifiants sous userIDs. Ces identifiants doivent inclure les namespace, type et value. Dans l’exemple, les utilisateurs ont des identifiants tels que email, ECID et ID de gestion de la relation client.
-
Pour chaque utilisateur, incluez un tableau action spécifiant les actions à effectuer sur les données de l’utilisateur, telles que access, delete, ou les deux.
-
Sous le champ include , répertoriez les produits Adobe Experience Cloud (tels que Analytics, AdobeCloudPlatform et profileService) qui traiteront la demande d’accès à des informations personnelles.
-
Spécifiez la regulation sous laquelle la demande est envoyée. Les valeurs prises en charge sont les suivantes :
- gdpr (Union européenne)
- ccpa (Californie)
- lgpd_bra (Brésil)
- nzpa_nzl (Nouvelle-Zélande)
- pdpa_tha (Thaïlande)
- apa_aus (Australie)
- cpa (Colorado)
- cpra_usa (Californie)
- ctdpa (Connecticut)
- hipaa_usa (États-Unis)
- ucpa_usa (Utah)
- vcdpa_usa (Virginie)
-
Après avoir configuré la requête JSON, envoyez-la au point de terminaison des tâches de l’API Privacy. Une réponse réussie renvoie les détails de la tâche nouvellement créée, qui peuvent être suivis ou traités ultérieurement.
En suivant ces étapes, vous pouvez créer une demande d’accès à des informations personnelles exhaustive pour plusieurs utilisateurs et types d’identité, en veillant à respecter les réglementations de confidentialité appropriées.