Guia de solução de problemas do Privacy Service

O Adobe Experience Platform Privacy Service fornece uma API RESTful e uma interface para ajudar as empresas a gerenciar solicitações de privacidade de dados do cliente. Com o Privacy Service, você pode enviar solicitações para acessar e excluir dados pessoais ou privados do cliente, facilitando a conformidade automatizada com as regulamentações organizacionais e legais de privacidade.

Este documento fornece respostas a perguntas frequentes sobre o Privacy Service, bem como informações sobre erros encontrados com frequência na API.

Ao fazer solicitações de privacidade na API, qual é a diferença entre um usuário e uma ID de usuário? user-ids

Para fazer um novo trabalho de privacidade na API, a carga JSON da solicitação deve conter uma matriz users que lista informações específicas de cada usuário ao qual a solicitação de privacidade se aplica. Cada item na matriz users é um objeto que representa um usuário específico, identificado por seu valor key.

Por sua vez, cada objeto de usuário (ou key) contém sua própria matriz userIDs. Esta matriz lista valores de ID específicos para esse usuário específico.

Considere o exemplo de matriz users a seguir:

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

A matriz contém dois objetos, representando usuários individuais identificados por seus valores key ("DavidSmith" e "user12345"). "DavidSmith" tem apenas uma ID listada (seu endereço de email), enquanto "user12345" tem duas (seu endereço de email e ECID).

Para obter mais informações sobre como fornecer informações de identidade do usuário, consulte o manual em dados de identidade para solicitações de privacidade.

Posso usar o Privacy Service para limpar dados que foram enviados por acidente para Platform?

O Adobe não oferece suporte ao uso de Privacy Service para limpeza de dados enviados por acidente a um produto. O Privacy Service foi projetado para ajudá-lo a cumprir suas obrigações de acesso ao titular dos dados (ou consumidor) ou de exclusão de solicitações. Qualquer outro uso do Privacy Service para limpeza ou manutenção de dados não é suportado ou permitido.

As solicitações de privacidade são sensíveis ao tempo e são concluídas em relação à lei de privacidade aplicável. o envio de solicitações que não são acesso ao titular dos dados/consumidor ou solicitações de exclusão afeta todos os clientes do Privacy Service e a capacidade do Privacy Service de oferecer suporte às linhas do tempo legais apropriadas. Um limite rígido de upload diário está em vigor para ajudar a evitar o abuso do serviço.

Entre em contato com a equipe de conta do Adobe para coordenar e realizar um nível de esforço para remover qualquer problema de PII ou dados.

Como posso obter informações sobre o status da minha solicitação de privacidade ou do meu trabalho?

Você pode recuperar detalhes sobre um trabalho específico usando a API Privacy Service ou a interface do usuário.

Uso da API

Para recuperar o status de um trabalho específico usando a API Privacy Service, faça uma solicitação para o ponto de extremidade raiz (GET /) usando a ID do trabalho no caminho da solicitação. Para obter mais detalhes, consulte a seção sobre verificação do status de um trabalho no guia de API Privacy Service.

Uso da interface

Todas as solicitações de trabalho ativas estão listadas no widget Solicitações de trabalho, no painel da interface do usuário Privacy Service. O status de cada solicitação de trabalho é exibido abaixo da coluna Status. Para obter mais informações sobre como exibir solicitações de trabalho na interface, consulte o guia do usuário do Privacy Service.

Como baixar os resultados dos meus processos de privacidade concluídos?

A API Privacy Service e a interface do usuário fornecem métodos para baixar os resultados de trabalhos concluídos no formato ZIP.

Uso da API

Faça uma solicitação para o ponto de extremidade raiz (GET /) na API Privacy Service, usando a ID do trabalho cujos resultados você deseja baixar no caminho da solicitação. Se o status do trabalho for concluído, a API incluirá um atributo downloadURL no corpo da resposta. Este atributo contém um URL que você pode colar na barra de endereços do navegador para baixar o arquivo ZIP.

Para obter mais detalhes, consulte a seção sobre procurando um trabalho pela sua ID no guia de API Privacy Service.

Uso da interface

No painel da interface do usuário do Privacy Service, encontre o trabalho que deseja baixar no widget Solicitações de trabalho. Selecione a ID do trabalho para abrir a página Detalhes do trabalho. Aqui, selecione Baixar no canto superior direito para baixar o arquivo ZIP. Consulte o guia do usuário do Privacy Service para obter etapas mais detalhadas.

Mensagens de erro comuns common-error-messages

A tabela a seguir descreve alguns erros comuns em Privacy Service, com descrições para ajudar a resolver seus respectivos problemas.