Diretrizes de criação de trabalho de privacidade
Para simplificar o processamento de solicitações e melhorar os tempos de resposta, considere as seguintes diretrizes ao criar processos de privacidade. Isso se aplica aos métodos da API e da interface do usuário.
- Maximizar titulares de dados por solicitação: Inclua o máximo possível de titulares de dados, até 1000, por solicitação.
- IDs de grupo para eficiência: Agrupe várias IDs para um único titular de dados (até nove) em cada solicitação. As IDs podem vir de diferentes serviços da Adobe na mesma solicitação.
- Combinar trabalhos de acesso e exclusão: Inclua os tipos de trabalho "acesso" e "exclusão" em uma única solicitação, se exigido pelo titular dos dados.
- Incluir somente os produtos necessários: incluir somente os produtos necessários ou licenciados. Outros produtos podem prolongar o tempo de processamento e aumentar os custos.
Monitorar status de trabalhos de privacidade
Para monitorar com eficácia os processos de privacidade e verificar seu status, o Privacy Service fornece três métodos. Os métodos disponíveis são listados abaixo, a fim de monitorar a eficiência e a produtividade. Cada método inclui diretrizes de práticas recomendadas para melhorar a experiência, seguidas por um exemplo de cenário ideal que combina todas as abordagens.
Receber notificações em tempo real
Eventos de E/S oferecem monitoramento de status quase em tempo real por meio de eventos de status. Esse é o método mais eficiente, pois evita a necessidade de implementar mecanismos de polling e gera tráfego de API adicional.
Recommendations:
- Configuração do Webhook: configure webhooks para receber notificações por push quando ocorrerem alterações de status para trabalhos enviados. Isso auxilia na monitoração em tempo real.
- Notificações: use notificações no nível do trabalho e do produto para ajudar a monitorar o progresso das solicitações.
Consulte a documentação sobre assinatura de eventos Privacy Service para obter instruções sobre como configurar um registro de evento para notificações Privacy Service e como interpretar cargas de notificação.
Recuperar todos os trabalhos com base em filtros
Para recuperar todos os seus dados de trabalho de privacidade com base em qualquer filtro especificado, execute uma solicitação GET para o ponto de extremidade /jobs
. Essa chamada de API é útil para fornecer uma exibição de alto nível do status do trabalho atual para grandes conjuntos de IDs de trabalho com apenas uma única solicitação. Não há respostas detalhadas do produto, mas elas podem ser encontradas usando o ponto de extremidade /jobs/{jobID}
.
Uma solicitação GET para o ponto de extremidade /jobs
é melhor usada para coletar ou comparar os dados de status de um grande conjunto de IDs de trabalho, mas não destina-se a atividades de tipo de sondagem regulares.
Recommendations:
- Parâmetros de consulta: Use filtros específicos para restringir seus resultados, por exemplo: intervalos de dados, tipos de regulamentos e status (processamento, conclusão etc.).
Você pode ver uma lista de todos os processos de privacidade atuais em sua organização por meio da interface do Privacy Service. Consulte a documentação de gerenciamento de trabalhos de privacidade na interface para obter informações sobre como filtrar a lista de solicitações de trabalhos. Como alternativa, consulte a documentação sobre o uso do ponto de extremidade /job na API de Privacy Service.
A documentação da API Privacy Service contém detalhes sobre os filtros de parâmetro de consulta disponíveis.
Recuperar respostas detalhadas para um único trabalho
Para recuperar respostas detalhadas para um único trabalho, execute uma solicitação GET para o ponto de extremidade /jobs/{jobID}. Esse método tem como objetivo obter informações mais detalhadas, como respostas específicas a produtos e mensagens de sucesso. Uma chamada para este ponto de extremidade é a melhor maneira de ver quais produtos responderam e quais ainda estão pendentes, embora não seja destinado à atividade de sondagem regular.
Consulte a documentação do ponto de extremidade /jobs/{JOB_ID}
para obter detalhes sobre como verificar o status de um trabalho específico.
Exemplo de cenário ideal
Use um webhook para que o sistema possa atualizar automaticamente os registros e fornecer relatórios ou alertas quando os grupos das IDs de uma solicitação forem concluídos. Se os trabalhos ainda estiverem pendentes, o sistema recuperará esses status de trabalho com uma solicitação GET para o ponto de extremidade da API de Privacy Service /jobs
e fornecerá uma atualização de alto nível da lista.
Se um trabalho específico ainda estiver pendente ou tiver retornado um erro, você poderá recuperar a resposta detalhada com uma solicitação GET para o ponto de extremidade /job/{jobId}
.
Acessar dados de solicitação
Quando as informações do titular dos dados são solicitadas, cada serviço retorna dados em um formato consistente com a maneira como eles armazenam e usam esses dados. Depois que todos os serviços concluírem a solicitação, um URL de arquivo .ZIP será fornecido nos detalhes do trabalho para permitir que esses dados sejam baixados. Consulte o guia de solução de problemas para obter informações sobre como baixar os resultados do trabalho de privacidade.
A seguir, os principais itens de observação relacionados à gestão do arquivo de dados:
- Todos os arquivos são excluídos dos servidores Experience Platform após 30 dias. Não é possível consultar dados do cliente com mais de 30 dias.
- A estrutura do arquivo de arquivamento inclui pastas para cada produto incluído na solicitação e os arquivos de dados contidos nela. Os arquivos ou pastas podem estar vazios se nenhum dado for encontrado para a ID especificada.
- Os dados de trabalhos criados anteriormente só podem ser acessados por 30 dias após a data de conclusão. Depois disso, os dados serão removidos do sistema e uma nova solicitação deverá ser feita.
Recommendations:
- Arquivos de Dados do Protect: O URL e o arquivo .ZIP devem ser protegidos, pois eles podem conter informações de identificação pessoal (PII) do titular dos dados.