Janelas de relatórios personalizados

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

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

  • Para relatórios de eventos, as janelas permitem que você receba 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 um trade-off: usar janelas de relatório dá acesso mais rápido aos relatórios, mas implica que você pode perder 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 as conversões que ocorrem após um determinado período. Consulte a seção "Agregável" para mais detalhes.

O que é uma janela de relatório personalizado?

Uma janela de relatório personalizada é 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 essa fonte.

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

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

  • Se nenhum report_window for definido, ele vai voltar para 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 de eventos.
  • Uma janela de relatório é definida em segundos.

O funcionamento de expiry não muda. expiry muda quais impressões ou cliques são qualificados para atribuição.

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 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 mais rapidamente. Entre outras coisas, as janelas de relatórios personalizadas 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 vencimento integradas anteriores ao Chrome 110.
  • Filtrar as conversões que ocorrem após um determinado período.

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

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

Exemplos de programação para relatórios e cliques 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 relatório: Relatórios filtrados (não enviados) para conversões que ocorrem:
Padrão (30 dias) (não definido) Cerca de 2 dias e 1 hora após o clique
Comportamento padrão dos relatórios: janela integrada 1
Cerca de 30 dias após o clique
Personalizada, definida como 5 dias (não definido) Cerca de 2 dias e 1 hora após o clique
Comportamento padrão dos relatórios: janela integrada 1
Mais de 5 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 de relatório personalizada. Observe como isso gera o relatório mais rápido do que na primeira linha, em que você precisa esperar pela primeira janela integrada (dois dias).
Mais de um dia após o clique
Personalizada, definida como 5 dias Definir como 1 dia Cerca de 1 dia e 1 hora após o clique

Comportamento personalizado devido à janela de relatório personalizado
Mais de um dia após o clique
Padrão (30 dias) Definir como 4 horas Cerca de 1 dia e 1 hora após o clique
Comportamento personalizado devido à janela de relatório personalizada. Isso ocorre devido à fixação: a janela mínima de relatório é de um dia. Mesmo que você defina uma janela de relatório com menos de um dia, por exemplo, 4 horas, o valor será fixado em 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 relatório:
Padrão (30 dias) (não definido) Cerca de 30 dias mais 1 hora após a visualização
Comportamento padrão dos 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 dos relatórios
Padrão (30 dias) Definir como 1 dia Cerca de 1 dia e 1 hora após a visualização
Comportamento personalizado devido à janela de relatório personalizada
Personalizada, definida como 5 dias Definir como 1 dia Cerca de 1 dia e 1 hora após a visualização
Comportamento personalizado devido à janela de relatório personalizada

Relatórios agregáveis: relatórios seletivos

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

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

Isso vai filtrar as conversões que acontecem após um determinado período.

Os relatórios agregáveis são enviados em até uma hora após o acionamento e têm atraso aleatório de 10 minutos a 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 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) Definir 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) Definir como 4 horas Mais de um dia após o clique ou a visualização. Isso ocorre devido à fixação: a janela mínima de relatório é de um dia. Mesmo que você defina uma janela de relatório com menos de um dia, por exemplo, 4 horas, o valor será fixado em um dia.

Interaja e compartilhe feedback

Participe e experimente essa API.