Introdução aos Relatórios de atribuição

Veja aqui por onde começar, incluindo a configuração e uma rápida visão geral.

Escolher um tipo de relatório

Com a API Attribution Reporting, é possível gerar dois tipos de relatório: de evento e de resumo. Os relatórios de eventos exigem menos configuração do que os relatórios agregáveis ou resumidos, portanto, podem ser um bom ponto de partida. Os relatórios de resumo exigem integração com o serviço de agregação. os relatórios de eventos não.

É possível configurar relatórios de eventos e de resumo. Elas são complementares.

Relatórios de eventos

Os relatórios de evento associam um determinado clique ou visualização do anúncio (no lado do anúncio) aos dados do lado da conversão. Para preservar a privacidade do usuário limitando a combinação de identidades de usuário entre sites, os dados de conversão são muito limitados e têm ruído.

Relatórios de resumo

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。

Implementação

Para começar, siga as etapas a seguir.

Para uma determinada fonte de evento, é possível gerar um de eventos e um relatório agregável. A demo explica o processo.

Geração de relatórios de eventos

Siga estas etapas mínimas para gerar relatórios de eventos:

  1. Registre uma fonte. Consulte Registrar fontes de atribuição para mais instruções. As etapas são diferentes para cliques e visualizações.

  2. Registre um gatilho. Consulte Registrar acionadores de atribuição para ver as instruções.

  3. Configure um endpoint com o seguinte URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.
    Consulte o exemplo de código em adtech.js para conferir o método POST e a Wikipédia para mais informações sobre .well-known.

Mais detalhes estão disponíveis na explicação do relatório de eventos.

Geração de relatórios de resumo

Para gerar relatórios de resumo, siga estas etapas avançadas:

  1. Registre uma fonte. Consulte Registrar fontes de atribuição para mais instruções. As etapas são diferentes para cliques e visualizações. Confira mais detalhes em Registro da fonte de atribuição.

  2. Registre um gatilho. Consulte Registrar acionadores de atribuição para ver as instruções.

  3. Configure um endpoint para relatórios agregáveis com o seguinte URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.
    Consulte o exemplo de código em adtech.js para conferir o método POST e a Wikipédia para mais informações sobre .well-known.

  4. Agrupar e enviar os relatórios para processamento adicional pelo serviço de agregação, que gera relatórios de resumo. Consulte os relatórios agregáveis em lote.

Saiba mais na explicação sobre o relatório agregável.

Saiba como configurar relatórios de depuração na série de depuração de Relatórios de atribuição.

Conceitos adicionais dos relatórios de resumo

Além de entender as etapas de implementação aqui, os conceitos a seguir ajudarão você a planejar sua estratégia de relatórios resumidos:

Etapas opcionais

  1. Configurar filtros (opcional):
    1. Siga as instruções Defina regras personalizadas usando filtros.
    2. Revise os detalhes específicos dos filtros de relatórios agregáveis em a seção de gatilhos explicação.

Não se esqueça da detecção de recursos

Antes de usar a API, detecte se ela não foi bloqueada na página com uma política de permissões. Para fazer isso, execute este código:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Se essa verificação de detecção de recursos retornar verdadeiro, a API será permitida no contexto (página) em que a verificação é executada.

Essa verificação por si só não é uma garantia de que a API possa ser usada na página. o usuário pode ter desativado a API nas configurações do navegador ou ter outras configurações que impedem o uso da API. Para proteger a privacidade do usuário, não é possível verificar isso de maneira programática.

Próximas etapas

Se você estiver com tudo pronto para começar a implementação, confira estes documentos:

Configuração

Contexto

Demonstrações e ferramentas

Planejamento

Se você ainda estiver na fase de planejamento, confira estes documentos: