Janelas de atribuição da Meta: como comparar períodos sem se enganar

Uma janela de atribuição é o prazo em que a Meta pode creditar uma ação (compra, lead) a um anúncio depois de alguém clicar ou ver o anúncio. Comparar períodos só faz sentido se a janela e a regra de contagem forem as mesmas nos dois lados. Desde 12 de janeiro de 2026, a API de Insights da Meta não devolve mais dados das janelas 7d_view e 28d_view, então quem compara dezembro com fevereiro sem checar isso pode ver uma queda que não existiu.

O que é uma janela e por que ela muda o número

A documentação da Meta descreve a janela de atribuição como o filtro que combina um prazo (por exemplo, 7 dias) e um tipo de interação (por exemplo, clique) para decidir quais ações entram no relatório. Em 7d_click, entra a ação que aconteceu até 7 dias depois de um clique. Em 1d_view, entra a que aconteceu até 1 dia depois de a pessoa ver o anúncio.

Isso significa que o mesmo anúncio, no mesmo dia, tem mais de um número de compras: um para cada janela. Nenhum é "o certo". Cada um responde a uma pergunta diferente, e o erro começa quando um relatório mistura as respostas.

O que mudou em janeiro de 2026

O registro de mudanças do Marketing API, publicado em 13 de outubro de 2025, avisou que a mudança vale para todas as versões da API em 12 de janeiro de 2026: os dados das janelas de visualização de 7 dias (7d_view) e de 28 dias (28d_view) deixam de estar disponíveis e a consulta retorna sem dados.

O ponto prático: um painel que soma várias janelas, ou que mostra a de visualização de 7 dias, passou a ter uma peça a menos. O que mudou foi o que a API entrega, não o desempenho dos anúncios.

O mesmo aviso trouxe limites de histórico que importam para comparação ano contra ano:

• Todos os detalhamentos (breakdowns) de campos de contagem única, como unique_actions, ficam limitados a 13 meses. Consultas com data inicial mais antiga não retornam dados.
• Os detalhamentos por hora também ficam limitados a 13 meses, em todos os campos.
• Os detalhamentos de frequência ficam limitados a 6 meses.

Além disso, uma regra anterior já vale desde 10 de junho de 2025: o alcance (reach) deixa de ser devolvido em consultas com detalhamento cuja data inicial tenha mais de 13 meses.

Um exemplo hipotético de queda falsa

Os números abaixo são inventados para ilustrar a conta. Uma conta de e-commerce registra, em dezembro, 60 compras na janela 7d_click e 20 na 7d_view. Em fevereiro, com a mesma operação, registra 62 em 7d_click, e a 7d_view não existe mais.

• 7d_click

  Dezembro

  60

  Fevereiro

  62

• 7d_view

  Dezembro

  20

  Fevereiro

  sem dados

• Soma das duas

  Dezembro

  80

  Fevereiro

  62

Quem compara a soma vê 80 → 62, uma queda de 22,5% (18 ÷ 80). Quem compara a mesma janela vê 60 → 62, uma alta de cerca de 3,3% (2 ÷ 60). A conta de anúncios não piorou: o relatório é que perdeu uma coluna.

A regra é simples e vale para qualquer troca de configuração: compare janela com janela. Se uma janela deixou de existir, o período antigo precisa ser recalculado só com as que continuam disponíveis.

A janela vem do conjunto de anúncios

Segundo a página de limites e boas práticas da API de Insights, desde 10 de junho de 2025 os parâmetros use_unified_attribution_setting e action_report_time passaram a ser desconsiderados e as respostas da API passaram a imitar o Gerenciador de Anúncios:

• Os valores atribuídos seguem a configuração de atribuição do conjunto de anúncios, semelhante ao que use_unified_attribution_setting=true fazia.
• Ações dentro do anúncio (inline) entram nos dados das janelas 1d_click ou 1d_view; a janela inline isolada deixou de ser devolvida.

Na prática, dois conjuntos da mesma campanha podem ter configurações diferentes. Se você soma resultados de conjuntos sem olhar isso, está misturando janelas. Antes de consolidar uma campanha, confira a configuração de cada conjunto.

Uma ressalva honesta: a mesma página também afirma que o comportamento padrão da API é diferente do padrão do Gerenciador de Anúncios. Como a documentação descreve os dois pontos, não tire conclusão do padrão. Peça as janelas que você quer e registre.

Peça a janela de forma explícita

A API aceita o parâmetro action_attribution_windows, que define o prazo e o tipo de interação usados como filtro. A referência lista valores como 1d_click, 7d_click, 28d_click e 1d_view, entre outros. Ao consultar, escolha as janelas e guarde junto do relatório a lista usada. Um relatório que não diz a janela não pode ser comparado com nada.

Há uma restrição que pega quem trabalha com detalhamentos: a documentação diz que as métricas ficam indisponíveis quando se tenta agregar entre várias configurações de atribuição, e também com certos detalhamentos (para ações fora da Meta, como região e DMA). A própria documentação indica que consultar com action_attribution_windows=1d_click,7d_click,1d_view,incrementality deixa as métricas disponíveis. Se um total "sumiu" depois de um detalhamento, comece por aqui.

Dentro e fora da Meta: a virada do mês

A página de boas práticas também diz que as ações passaram a ser reportadas com action_report_time=mixed: ações dentro da Meta (como cliques no link) usam o momento da impressão; ações fora da Meta (como compras no site) usam o momento da conversão.

Um exemplo hipotético: alguém vê e clica no anúncio em 30 de dezembro e compra em 3 de janeiro. O clique e o gasto ficam em dezembro; a compra entra em janeiro. Por isso, o custo por compra de um mês fechado mistura gasto de um período com compras de outro, e o fechamento de um mês pode ser parcial nos primeiros dias do seguinte. Isso não é erro: é a regra de datação. Apenas não compare o fechamento parcial de um mês com o fechamento completo de outro.

Como o Relator ajuda

O Relator conecta a conta de anúncios da Meta ao mesmo workspace do Google Ads e do GA4, para que você veja as plataformas lado a lado no relatório do cliente. A decisão de qual janela usar e a anotação da mudança de janeiro continuam sendo suas, e devem ficar no relatório.

Como aplicar

1. 1.Escolha uma janela principal para o relatório do cliente (por exemplo, 7d_click) e escreva isso no cabeçalho.
2. 2.Ao consultar a API, passe action_attribution_windows com as janelas desejadas, em vez de confiar no padrão.
3. 3.Recalcule os períodos anteriores a 12/01/2026 sem 7d_view e 28d_view, para comparar com o que existe hoje.
4. 4.Confira a configuração de atribuição de cada conjunto de anúncios antes de somar resultados.
5. 5.Anote no relatório a data da mudança (12/01/2026) e o que mudou, para explicar a diferença ao cliente.
6. 6.Não compare mês parcial com mês fechado: deixe o fechamento amadurecer alguns dias.
7. 7.Para comparações de mais de 13 meses com campos de contagem única, guarde seus próprios dados mensais em vez de depender da consulta.

Fontes

Todas conferidas em 11 de outubro de 2026. Ficou de fora, por não termos conseguido ler a página de Ajuda da Meta em texto, a lista de janelas disponíveis no Gerenciador de Anúncios, o valor padrão de novas campanhas e a diferença entre as opções de exibição.

• Meta for Developers, Out-of-cycle changes 2025: fim das janelas 7d_view e 28d_view em 12/01/2026 e limites de 13 e 6 meses.
• Meta for Developers, Insights API: Limits & Best Practices: configuração por conjunto de anúncios, action_report_time=mixed e diferença de padrão com o Gerenciador.
• Meta for Developers, Insights API: Breakdowns: restrições de métricas e janelas por detalhamento.
• Meta for Developers, Ad Campaign Group Insights (referência): parâmetro action_attribution_windows e seus valores.