Parte 1 de 3 sobre a depuração dos Relatórios de atribuição. Saiba por que a depuração é importante e quando usar relatórios de depuração em testes.
Por que você precisa de relatórios de depuração
Se você estiver testando a API Attribution Reporting, verifique se a integração está funcionando corretamente, entenda as lacunas nos resultados da medição entre sua implementação baseada em cookies e a implementação da API Attribution Reporting e resolva problemas com sua integração.
Os relatórios de depuração são necessários para concluir essas tarefas. Por isso, recomendamos que você os configure.
Glossário
Principais aspectos dos relatórios de depuração
Dois tipos de relatórios de depuração
Há dois tipos de relatórios de depuração disponíveis. Use os dois, já que eles atendem a casos de uso diferentes.
Relatórios de depuração de conclusão
Os relatórios de depuração de sucesso rastreiam a geração bem-sucedida de um relatório de atribuição. Eles estão diretamente relacionados a um relatório de atribuição.
Os relatórios de depuração de sucesso estão disponíveis desde o Chrome 101 (abril de 2022).
Relatórios de depuração detalhados
Os relatórios de depuração detalhados oferecem mais visibilidade sobre os eventos de origem e acionamento. Assim, você pode garantir que as fontes foram registradas corretamente ou rastrear relatórios ausentes e determinar por que eles não aparecem (falha nos eventos de origem ou acionamento, falha ao enviar ou gerar o relatório). Os relatórios de depuração detalhados indicam:
- Casos em que o navegador registrou uma origem.
- Casos em que o navegador não registrou um evento de origem ou de acionador, o que significa que ele não vai gerar um relatório de atribuição.
- Casos em que um relatório de atribuição não pode ser gerado ou enviado por algum motivo.
Os relatórios de depuração detalhados incluem um campo type que descreve um registro de origem bem-sucedido ou o motivo pelo qual um relatório de origem, acionador ou atribuição não foi gerado.
Os relatórios de depuração detalhados estão disponíveis desde o Chrome 109 (janeiro de 2023), exceto os relatórios de depuração detalhados de sucesso do registro de origem, que foram adicionados depois no Chrome 112.
Confira exemplos de relatórios em Parte 2: configurar relatórios de depuração.
Os relatórios de depuração são baseados em cookies
Para usar relatórios de depuração, a origem de relatórios precisa definir um cookie.
Se a origem configurada para receber relatórios for de terceiros, esse cookie também será de terceiros. Isso significa que os relatórios de depuração só serão gerados se os cookies de terceiros forem permitidos no navegador do usuário.
Os relatórios de depuração são enviados imediatamente
Os relatórios de depuração são enviados imediatamente pelo navegador para a origem de relatórios. Isso é diferente dos relatórios de atribuição, que são enviados com um atraso.
Os relatórios de depuração de sucesso são gerados e enviados assim que o relatório de atribuição correspondente é gerado, ou seja, no registro do gatilho.
Os relatórios de depuração detalhados são enviados imediatamente após o registro da fonte ou do acionador.
Os relatórios de depuração têm caminhos de endpoint diferentes
Assim como os relatórios de atribuição, todos os relatórios de depuração são enviados para a origem de relatórios. Os relatórios de depuração são enviados para três endpoints separados da origem de relatórios:
- Endpoint para relatórios de depuração de sucesso no nível do evento.
- Endpoint para relatórios de depuração de sucesso, agregáveis.
- Endpoint para relatórios de depuração detalhados, no nível do evento e agregáveis.
Saiba mais em Parte 2: configurar relatórios de depuração.
Casos de uso
Verificação básica de integração em tempo real
Os relatórios de depuração são enviados imediatamente para seu endpoint, ao contrário dos relatórios de atribuição, que são atrasados para proteger a privacidade do usuário. Use relatórios de depuração como um indicador em tempo real de que sua integração com a API Attribution Reporting está funcionando.
Saiba como fazer isso na Parte 3: Receitas de depuração.
Análise de perdas
Ao contrário dos cookies de terceiros, a API Attribution Reporting inclui proteções de privacidade integradas, projetadas para encontrar um equilíbrio entre utilidade e privacidade. Isso significa que, com a API Attribution Reporting, talvez não seja possível coletar todos os dados de medição que você conseguiria com cookies. Nem todas as conversões que você pode rastrear com cookies de terceiros geram um relatório de atribuição.
Por exemplo, para relatórios no nível do evento, você pode registrar no máximo uma conversão por impressão. Isso significa que, para uma determinada impressão de anúncio, você só vai receber um relatório de atribuição, não importa quantas vezes o usuário faça uma conversão.
Use relatórios de depuração para ter visibilidade das diferenças entre os resultados da medição baseada em cookies e os resultados que você recebe com a API Attribution Reporting. Identifique quais conversões são informadas, quantas não são e, especificamente, quais e por quê.
Saiba como fazer uma análise de perda na Parte 3: manual de depuração.
Solução de problemas
Embora a perda causada por proteções de privacidade ou recursos seja esperada, outras perdas podem ser não intencionais. Erros de configuração na sua implementação ou bugs no navegador podem fazer com que os relatórios desapareçam.
Você pode usar relatórios de depuração para detectar e corrigir um problema de implementação do seu lado ou para informar um possível bug às equipes de navegadores. Saiba como fazer isso na Parte 3: Receitas de depuração.
Verificação de configuração avançada
Alguns recursos da API Attribution Reporting permitem personalizar os comportamentos da API. Regras de filtragem, de remoção de duplicação e de prioridade são alguns exemplos.
Ao usar esses recursos, use relatórios de depuração para verificar se a lógica leva ao comportamento pretendido em produção, sem esperar pelos relatórios de atribuição. Saiba como fazer isso na Parte 3: Receitas de depuração.
Teste local com relatórios agregáveis
Ao contrário dos relatórios de atribuição agregáveis criptografados, os relatórios de depuração agregáveis incluem o payload não criptografado.
Use relatórios de depuração agregáveis para validar o conteúdo dos relatórios agregáveis e gerar relatórios de resumo com a ferramenta de agregação local para testes.
Reprocessar relatórios do serviço de agregação
Outra vantagem de usar o modo de depuração é que ele permite processar relatórios novamente. Portanto, para processar relatórios mais de uma vez, verifique se os relatórios de depuração estão ativados. Talvez seja necessário reprocessar relatórios quando você:
- tentando depurar o serviço de agregação.
- testando diferentes estratégias de loteamento.
- testando diferentes valores de epsilon.
Recuperação de dados
Recomendamos que as adtechs ativem o modo de depuração para receber relatórios de depuração e recuperar os dados de relatórios. Isso é útil em casos de problemas com o Serviço de agregação, como serviços indisponíveis ou sem resposta que podem causar falha na geração de relatórios de resumo.
Próximo
Parte 2: configurar relatórios de depuração