Janelas de relatórios personalizados

As janelas de relatórios personalizados podem fornecer relatórios a nível de evento mais rápidos e relatórios seletivos para relatórios agregáveis.

Com as janelas de relatórios personalizados para os Relatórios de atribuição (enviados no Chrome 110), é possível instruir o navegador a filtrar as conversões que ocorrem após um determinado período.

  • Para relatórios de eventos, as janelas permitem gerar relatórios mais rapidamente, além de filtrar as conversões que ocorrem após um determinado período. Dependendo da sua meta, outra maneira de analisar isso é como uma compensação: o uso de janelas de relatórios fornece acesso mais rápido aos relatórios, mas sugere que você pode perder algumas conversões. Confira mais detalhes na seção no nível do evento.
  • Para relatórios agregáveis, as janelas de relatórios permitem filtrar as conversões que ocorrem após um determinado período. Confira a seção agregável para mais detalhes.

O que é uma janela de relatório personalizado?

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

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

Pontos principais sobre janelas de relatórios:

  • Se nenhum report_window for definido, ele voltará para expiry.
  • Se nenhum expiry for definido, ele voltará ao padrão de 30 dias.
  • A janela mínima do relatório personalizado é de um dia. Mesmo que você defina uma janela com menos de um dia, o valor será ajustado para um dia. Confira os exemplos de relatórios de eventos.
  • Uma janela de relatório é definida em segundos.

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

Relatórios de eventos: relatórios mais rápidos e seletivos

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

Para relatórios de eventos, as janelas de relatórios personalizados permitem:

  • Receba relatórios com mais rapidez. 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 anteriores ao Chrome 110.
  • Filtre as conversões que ocorrem 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 de origem do Attribution-Reporting-Register-Source.

Os relatórios de eventos são programados para serem enviados logo após a janela de relatórios ser atingida.

Exemplos de programação de relatórios de eventos, cliques

expiração event_report_window Se uma conversão ocorrer um dia após o clique, o navegador vai enviar o relatório: Relatórios filtrados (não enviados) para conversões ocorridas:
Padrão (30 dias) (não definido) Cerca de 2 dias mais 1 hora após o clique
Comportamento padrão dos relatórios: janela integrada 1
Cerca de 30 dias após o clique
Personalizado, definido como cinco dias (não definido) Cerca de 2 dias mais 1 hora após o clique
Comportamento padrão dos relatórios: janela integrada 1
Mais de cinco dias após o clique
Padrão (30 dias) Definir como 1 dia Cerca de 1 dia e 1 hora após o clique

Comportamento personalizado devido à janela do seu relatório personalizado. Isso faz com que você receba esse relatório mais rapidamente do que na primeira linha, em que é necessário aguardar a primeira janela integrada (dois dias).
Mais de 1 dia após o clique
Personalizado, definido como cinco dias Definir como 1 dia Cerca de 1 dia mais 1 hora após o clique

Comportamento personalizado devido à janela do seu relatório personalizado
Mais de 1 dia após o clique
Padrão (30 dias) Definido como 4 horas Cerca de 1 dia e 1 hora após o clique
Comportamento personalizado devido à janela do seu relatório personalizado. Isso ocorre devido a uma restrição: a janela mínima de relatório é de um dia. Mesmo que você configure uma janela de relatório para menos de um dia, por exemplo, quatro horas, o valor será ajustado para um dia.
Mais de 1 dia após o clique

Exemplos de programação para relatórios de eventos, visualizações

expiração event_report_window Se uma conversão ocorrer um dia após o clique, o navegador vai enviar o relatório:
Padrão (30 dias) (não definido) Cerca de 30 dias mais 1 hora depois da visualização
Comportamento padrão dos relatórios
Personalizado, definido como cinco dias (não definido) Cerca de 5 dias mais 1 hora depois da visualização
Comportamento padrão dos relatórios
Padrão (30 dias) Definir como 1 dia Cerca de 1 dia e 1 hora depois da visualização
Comportamento personalizado devido à sua janela de relatórios personalizados
Personalizado, definido como cinco dias Definir como 1 dia Cerca de 1 dia e 1 hora depois da visualização
Comportamento personalizado devido à sua janela de relatórios personalizados

Relatórios agregáveis: relatórios seletivos

Para relatórios agregáveis, a vantagem das janelas de relatório é filtrar as conversões que ocorrem após um determinado período. Não há nenhum benefício em termos de obter relatórios mais rapidamente.

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

Isso filtra as conversões que ocorrem após um determinado período.

Os relatórios agregáveis são enviados dentro de uma hora após o acionamento e têm um atraso aleatório entre 10 minutos e uma hora.

expiração aggregatable_report_window Relatórios filtrados (não enviados) para conversões ocorridas:
Padrão (30 dias) (não definido) Mais de 30 dias após um clique ou uma visualização
Personalizado, definido como cinco dias (não definido) Mais de cinco dias após um clique ou uma visualização
Padrão (30 dias) Definir como 1 dia Mais de 1 dia após um clique ou uma visualização
Personalizado, definido como cinco dias Definir como 1 dia Mais de 1 dia após um clique ou uma 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 a uma restrição: a janela mínima de relatório é de um dia. Mesmo que você configure uma janela de relatório para menos de um dia, por exemplo, quatro horas, o valor será ajustado para um dia.

Interaja e compartilhe feedback

Participe e experimente essa API.