Privacy Service guide de dépannage

Adobe Experience Platform Privacy Service fournit une API RESTful et une interface utilisateur pour aider les sociétés à gérer les demandes de confidentialité des données client. Avec Privacy Service, vous pouvez envoyer des demandes d'accès et de suppression de données personnelles ou privées sur vos clients, ce qui facilite la conformité automatisée aux réglementations en matière de confidentialité organisationnelle et juridique.

Ce document fournit des réponses aux questions fréquentes sur Privacy Service, ainsi que des informations sur les erreurs courantes de l'API.

Lors de la création de requêtes de confidentialité dans l’API, quelle est la différence entre un utilisateur et un identifiant utilisateur ?

Pour effectuer une nouvelle tâche de confidentialité dans l’API, le payload JSON de la requête doit contenir un tableau users contenant des informations spécifiques pour chaque utilisateur concerné par la requête de confidentialité. Chaque élément du tableau users est un objet qui représente un utilisateur spécifique identifié par sa valeur key.

De même, chaque objet utilisateur (ou key) contient son propre tableau userIDs. Ce tableau indique les valeurs d’identifiant spécifiques pour cet utilisateur.

Consultez l’exemple de tableau users suivant :

"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
      }
    ]
  }
]

Le tableau contient deux objets représentant des utilisateurs individuels identifiés par leurs valeurs key (« DavidSmith » et « user12345 »). « DavidSmith » n’a qu’un identifiant (son adresse électronique), tandis que « user12345 » en a deux (son adresse électronique et son ECID).

Pour plus d’informations sur la fourniture des informations d’identité des utilisateurs, consultez le guide sur les données d’identité pour les demandes d’accès à des informations personnelles.

Puis-je utiliser Privacy Service pour nettoyer les données qui ont été envoyées accidentellement à Platform ?

Adobe ne prend pas en charge l'utilisation de Privacy Service pour effacer les données qui ont été envoyées accidentellement à un produit. Privacy Service est conçu pour vous aider à remplir vos obligations en matière de requêtes d’accès ou de suppression des titulaires de données (ou consommateurs). Ces requêtes sont sensibles au facteur temps et sont effectuées en fonction des lois de confidentialité applicables. La présentation de demandes qui ne sont pas des demandes d'accès aux données/aux consommateurs ou de suppression a un impact sur tous les clients Privacy Service et sur la capacité de Privacy Service de prendre en charge les délais légaux appropriés.

Veuillez contacter votre gestionnaire de compte (CDM) pour coordonner vos efforts et fournir un niveau de service adéquat en matière de suppression des données personnelles identifiables (PII) ou des problèmes relatifs aux données.

Comment puis-je obtenir des informations sur l’état d’une requête ou d’une tâche de confidentialité ?

Vous pouvez récupérer des détails sur une tâche particulière à l’aide de l’API Privacy Service ou de l’interface utilisateur.

Utilisation de l’API

Pour récupérer l’état d’une tâche particulière à l’aide de l’API Privacy Service, envoyez une requête au point de terminaison racine (GET /) en utilisant l’ID de la tâche dans le chemin de requête. Pour plus d’informations, consultez la section relative à la vérification de l’état d’une tâche dans le guide de développement de Privacy Service

Utilisation de l’interface utilisateur

Toutes les requêtes de tâche actives sont répertoriées dans le widget Requêtes de tâche accessible depuis le tableau de bord de l’interface utilisateur de Privacy Service L’état de chaque requête de tâche est affiché sous la colonne État. Pour plus d’informations sur l’affichage des requêtes de tâche dans l’interface utilisateur, consultez le guide d’utilisation de Privacy Service.

Comment télécharger les résultats de tâches de confidentialité terminées ?

L'API Privacy Service et l'interface utilisateur fournissent toutes deux des méthodes pour télécharger les résultats des tâches terminées au format ZIP.

Utilisation de l’API

Envoyez une requête au point de terminaison racine (GET /) de l’API en indiquant l’identifiant de la tâche dont vous souhaitez télécharger les résultats dans le chemin d’accès de la requête. Privacy Service Si l’état de la tâche est terminé, l’API inclut un attribut downloadURL dans le corps de la réponse. Cet attribut contient une URL que vous pouvez coller dans la barre d’adresse de votre navigateur pour télécharger le fichier ZIP.

Pour plus d’informations, reportez-vous à la section relative à la recherche d’une tâche par son identifiant dans le guide de développement de Privacy Service

Utilisation de l’interface utilisateur

Sur le tableau de bord d'interface utilisateur Privacy Service, recherchez la tâche que vous souhaitez télécharger à partir du widget Demandes de tâche. Sélectionnez l’ID de la tâche pour ouvrir la page Détails de la tâche. À partir de là, sélectionnez Télécharger dans le coin supérieur droit pour télécharger le fichier ZIP. Consultez le guide d’utilisation de Privacy Service pour obtenir des instructions plus détaillées.

Messages d’erreur courants

Le tableau suivant présente quelques erreurs courantes dans Privacy Service, avec des descriptions pour aider à résoudre leurs problèmes respectifs.

Message d’erreur Description
ID utilisateur introuvable. Certains des ID utilisateur fournis dans la demande sont introuvables et ont été ignorés. Assurez-vous d’utiliser les espaces de nommage et les valeurs d’ID corrects dans la charge utile de la demande. Voir le document sur la fourniture de données d'identité pour une explication plus détaillée.
Espace de nommage non valide Un espace de nommage d'identité fourni pour un ID d'utilisateur n'était pas valide. Voir la section espaces de nommage d'identité standard dans l'annexe du guide du développeur Privacy Service pour une liste d'espaces de nommage acceptés. Si vous utilisez un espace de nommage personnalisé, veillez à définir la propriété type de l’identifiant sur "personnalisé".
Partiellement terminé La tâche s'est terminée correctement, mais certaines données n'étaient pas applicables à la demande donnée et ont été ignorées.
Les données ne sont pas au format requis. Une ou plusieurs valeurs de données pour l’application spécifiée étaient incorrectement formatées. Pour plus d’informations, consultez les détails de la tâche.
L'organisation IMS n'a pas été configurée. Ce message se produit lorsque votre organisation IMS n'a pas été configurée pour Privacy Service. Contactez votre administrateur pour plus d’informations.
L’accès et les autorisations sont requis. L'accès et les autorisations sont nécessaires pour utiliser Privacy Service. Contactez votre administrateur pour obtenir un accès.
Un problème est survenu lors du transfert et de l'archivage des données d'accès. Lorsque cette erreur se produit, rechargez les données d’accès et réessayez.
La charge de travail a été dépassée pour la limite de taux de document actuelle. Lorsque cette erreur se produit, réduisez le taux d’envoi et réessayez.

Sur cette page