Janelas de relatórios personalizadas

As janelas de relatório personalizadas podem fornecer relatórios de eventos mais rápidos e relatórios seletivos para relatórios agregáveis.

Com janelas de relatórios personalizadas para a API Attribution Reporting (lançada no Chrome 110), você pode instruir o navegador a filtrar as conversões que ocorrem após um determinado período.

  • Para relatórios no nível do evento, as janelas de relatórios permitem que você receba relatórios mais rápido, além de filtrar conversões que ocorrem após um determinado período. Dependendo da sua meta, outra maneira de analisar isso é como uma troca: usar janelas de relatórios dá acesso mais rápido a eles, mas implica a perda de algumas conversões. Consulte a seção no nível do evento para mais detalhes.
  • Para relatórios agregáveis, as janelas de relatório permitem filtrar conversões que ocorrem após um determinado período. Consulte a seção de agregação para mais detalhes.

O que é uma janela de relatório personalizada?

Uma janela de relatório personalizada é o período após o registro da fonte em que relatórios do tipo correspondente (evento ou agregável) podem ser criados para essa fonte.

Para relatórios de eventos, uma janela de relatório também funciona como a última janela em que relatórios do tipo correspondente serão enviados.

Pontos principais sobre os períodos de relatórios:

  • Se nenhum report_window for definido, o padrão será expiry.
  • Se nenhum expiry for definido, o padrão será de 30 dias.
  • A janela mínima de relatório personalizado é de um dia. Mesmo que você defina uma janela de menos de um dia, o valor será fixado em um dia. Confira os exemplos de relatórios no nível do evento.
  • Uma janela de relatório é definida em segundos.

A forma como expiry funciona não muda. O que muda são as impressões ou cliques qualificados para atribuição.expiry

Relatórios no nível do evento: relatórios mais rápidos e seletivos

Por padrão, os relatórios de eventos são enviados de acordo com um cronograma de janelas de relatórios integradas: três janelas para cliques e uma para visualizações.

Para relatórios no nível do evento, as janelas de relatórios personalizados permitem:

  • Receba relatórios mais rápido. Entre outras coisas, as janelas de relatórios personalizados permitem que você receba relatórios um dia após o clique ou a impressão, em vez do limite de dois dias imposto pelas janelas de expiração integradas antes do Chrome 110.
  • Filtre as conversões que acontecem após um determinado período.

Para usar janelas de relatórios de eventos, adicione o campo event_report_window ao cabeçalho de registro da fonte Attribution-Reporting-Register-Source.

Os relatórios de eventos são programados para serem enviados no máximo logo após o fim da janela de relatório.

Exemplos de programação para relatórios no nível do evento, cliques

validade event_report_window Se uma conversão ocorrer um dia após o clique, o navegador enviará o relatório: Relatórios filtrados (não enviados) para conversões que ocorrem:
Padrão (30 dias) (não definido) Cerca de dois dias e uma hora após o clique
Comportamento padrão de geração de relatórios: período integrado nº 1		 Cerca de 30 dias após o clique
Personalizada (definida como 5 dias) (não definido) Cerca de dois dias e uma hora após o clique
Comportamento padrão de geração de relatórios: período integrado nº 1		 Mais de cinco dias após o clique
Padrão (30 dias) Definido como 1 dia Cerca de um dia e uma hora após o clique

Comportamento personalizado devido à sua janela de relatório personalizada. Observe como isso gera o relatório mais rápido do que na primeira linha, em que é necessário esperar a primeira janela integrada (dois dias).		 Mais de um dia após o clique
Personalizada (definida como 5 dias) Definido como 1 dia Cerca de um dia e uma hora após o clique

Comportamento personalizado devido à sua janela de relatório personalizada		 Mais de um dia após o clique
Padrão (30 dias) Definido como 4 horas Cerca de um dia e uma hora após o clique
Comportamento personalizado devido à sua janela de relatório personalizada. Isso ocorre devido ao ajuste: a janela mínima de relatório é de um dia. Mesmo que você defina um período de relatório inferior a um dia, por exemplo, 4 horas, o valor será limitado a um dia.		 Mais de um dia após o clique

Exemplos de programação para relatórios e visualizações no nível do evento

validade event_report_window Se uma conversão ocorrer um dia após o clique, o navegador vai enviar o seguinte relatório:
Padrão (30 dias) (não definido) Cerca de 30 dias e 1 hora após a visualização
Comportamento padrão de geração de relatórios
Personalizada (definida como 5 dias) (não definido) Cerca de 5 dias e 1 hora após a visualização
Comportamento padrão de geração de relatórios
Padrão (30 dias) Definido como 1 dia Cerca de 1 dia e 1 hora após a visualização
Comportamento personalizado devido à sua janela de relatório personalizada
Personalizada (definida como 5 dias) Definido como 1 dia Cerca de 1 dia e 1 hora após a visualização
Comportamento personalizado devido à sua janela de relatório personalizada

Relatórios agregáveis: relatórios seletivos

Para relatórios agregáveis, o benefício das janelas de relatórios é apenas filtrar as conversões que acontecem após um determinado período. Não há benefícios em termos de recebimento mais rápido de relatórios.

Para usar janelas de relatório em relatórios agregáveis, adicione o campo aggregatable_report_window ao cabeçalho de registro da fonte Attribution-Reporting-Register-Source.

Isso vai filtrar as conversões que acontecerem depois de um determinado período.

Os relatórios agregáveis são enviados em até uma hora após o acionamento, com um atraso aleatório entre 10 minutos e uma hora.

validade aggregatable_report_window Relatórios filtrados (não enviados) para conversões que ocorrem:
Padrão (30 dias) (não definido) Mais de 30 dias após o clique ou a visualização
Personalizada (definida como 5 dias) (não definido) Mais de 5 dias após o clique ou a visualização
Padrão (30 dias) Definido como 1 dia Mais de um dia após o clique ou a visualização
Personalizada (definida como 5 dias) Definido como 1 dia Mais de um dia após o clique ou a visualização
Padrão (30 dias) Definido como 4 horas Mais de um dia após o clique ou a visualização. Isso ocorre devido ao ajuste: a janela mínima de relatório é de um dia. Mesmo que você defina um período de relatório inferior a um dia, por exemplo, 4 horas, o valor será limitado a um dia.

Engajamento e como compartilhar feedback

Participe e teste essa API.