As janelas personalizadas podem gerar relatórios mais rápidos no nível do evento 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), você pode 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 com mais rapidez, além de filtrar as conversões que ocorrem após um determinado período. Dependendo do seu objetivo, outra maneira de analisar isso é como uma compensação: o uso de janelas de relatórios oferece acesso mais rápido aos relatórios, mas sugere que você pode perder algumas conversões. Consulte a seção de evento para mais detalhes.
- Para relatórios agregáveis, as janelas permitem filtrar as conversões que ocorrem após um determinado período. Consulte a seção agregável para conferir 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 relatórios do tipo correspondente (evento ou agregável) podem ser criados para ela.
Para relatórios de evento, uma janela de relatório também atua como a última janela em que relatórios do tipo correspondente serão enviados.
Pontos principais sobre janelas de relatórios:
- Se nenhum
report_window
for definido, ele vai voltar paraexpiry
. - Se nenhum
expiry
for definido, o valor padrão será de 30 dias. - A janela mínima de relatório personalizado é de um dia. Mesmo que você defina uma janela com menos de um dia, o valor será definido como um dia. Veja os exemplos de relatórios de eventos.
- Uma janela de relatórios é definida em segundos.
A forma como expiry
funciona não é a mesma. O expiry
muda quais impressões ou cliques se qualificam para a 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ório integradas: três janelas para cliques e uma para visualizações.
Para relatórios de evento, as janelas de relatórios personalizados permitem que você:
- 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 que era imposto por janelas de expiração integradas antes do 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 da fonte do Attribution-Reporting-Register-Source
.
event_report_window
Os relatórios de eventos estão programados para serem enviados no máximo pouco depois que a janela de relatórios for alcançada.
Exemplos de programação para relatórios de eventos, cliques
vencimento | 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) de conversões ocorridas: |
---|---|---|---|
Padrão (30 dias) | (não definido) | Cerca de dois dias mais uma hora após o clique Comportamento padrão do relatório: janela integrada 1 |
Cerca de 30 dias após o clique |
Personalizado, definido como cinco dias | (não definido) | Cerca de dois dias mais uma hora após o clique Comportamento padrão do relatório: janela integrada 1 |
Mais de cinco dias após o clique |
Padrão (30 dias) | Definir como 1 dia | Cerca de 1 dia mais 1 hora após o clique Comportamento personalizado devido à sua janela de relatório personalizado. Observe como isso gera este relatório mais rápido do que na primeira linha, onde é necessário aguardar a primeira janela integrada (dois dias) |
Mais de um 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 relatório personalizado |
Mais de um dia após o clique |
Padrão (30 dias) | Definido como 4 horas | Cerca de um dia mais 1 hora após o clique Comportamento personalizado devido à sua janela de relatório personalizado. Isso se deve ao limite: a janela mínima de relatório é de um dia. Mesmo que você defina uma janela de relatório para menos de 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 visualizações e relatórios de eventos
vencimento | event_report_window | Se uma conversão ocorrer um dia após o clique, o navegador 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 do relatório |
Personalizado, definido como cinco dias | (não definido) | Cerca de 5 dias mais 1 hora após a visualização Comportamento padrão do relatório |
Padrão (30 dias) | Definir como 1 dia | Cerca de 1 dia mais 1 hora após a visualização Comportamento personalizado devido à janela do relatório personalizado |
Personalizado, definido como cinco dias | Definir como 1 dia | Cerca de 1 dia mais 1 hora após a visualização Comportamento personalizado devido à janela do relatório personalizado |
Relatórios agregáveis: relatórios seletivos
Para relatórios agregáveis, a vantagem das janelas de relatório é apenas filtrar as conversões que ocorrem após um determinado período. Não há nenhuma vantagem em termos de gerar relatórios mais rapidamente.
Se quiser usar janelas para relatórios agregáveis, adicione o campo a seguir ao cabeçalho de registro da fonte do Attribution-Reporting-Register-Source
:
aggregatable_report_window
Isso filtra as conversões que ocorrem após um determinado período.
Os relatórios agregáveis são enviados até uma hora após o acionamento e têm um atraso aleatório entre 10 minutos e uma hora.
vencimento | aggregatable_report_window |
Relatórios filtrados (não enviados) de conversões ocorridas: |
---|---|---|
Padrão (30 dias) | (não definido) | Mais de 30 dias após o clique ou a visualização |
Personalizado, definido como cinco dias | (não definido) | Mais de cinco 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 |
Personalizado, definido como cinco dias | Definir 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 se deve ao limite: a janela mínima de relatório é de um dia. Mesmo que você defina uma janela de relatório para menos de um dia, por exemplo, 4 horas, o valor será limitado a um dia. |
Interaja e compartilhe feedback
Participe e experimente essa API.
- Leia sobre os relatórios agregáveis e o serviço de agregação, faça perguntas e sugira feedback.
- Leia os guias de Relatórios de atribuição.
- Faça perguntas e participe de discussões no repositório de suporte para desenvolvedores do Sandbox de privacidade.