Valores de parâmetros de URL e UTMs dinâmicas do Facebook Ads

Quando você utiliza UTMs dinâmicas nos anúncios do Facebook, o que aparece nos relatórios extraídos pela API são apenas os parâmetros configurados e não os valores reais preenchidos dinamicamente durante a veiculação do anúncio.

Ou seja, em vez de ver algo como:

utm_campaign=campanha_institucional&utm_content=anuncio_x

Você verá algo como:

utm_campaign={{campaign.name}}&utm_content={{ad.name}}

Esses parâmetros são pré-definidos na criação do anúncio e substituídos automaticamente pela plataforma quando o clique acontece. A API não retorna os valores finais preenchidos, pois esse dado só está disponível no ambiente do navegador.

Quais são os parâmetros dinâmicos disponíveis?

O Facebook permite usar os seguintes parâmetros dinâmicos:

{{ad.id}}
{{ad.name}}
{{adset.id}}
{{adset.name}}
{{campaign.id}}
{{campaign.name}}
{{placement}}
{{site_source_name}}

Esses parâmetros são definidos no momento da primeira publicação do anúncio.

Mais informações:

Como filtrar ou cruzar esses dados?

Se quiser analisar ou filtrar campanhas por UTMs, o ideal é trabalhar com os campos de nome ou ID da API, como:

campaign.name
adset.name
ad.name
campaign.id, etc.

Esses campos permitem cruzar com os dados vistos no Google Analytics ou em outras ferramentas de rastreamento que capturam os parâmetros já preenchidos.

Assim, mesmo que a UTM seja dinâmica, é possível saber a qual campanha ou anúncio ela corresponde através do nome ou ID extraído com a Stract.

Exemplo:

Se você usa a seguinte estrutura:

utm_campaign={{campaign.name}}&utm_content={{ad.name}}

Na extração com a Stract, você pode adicionar os campos Campaign Name e Ad Name para ter os dados correspondentes. Isso facilita a comparação com os relatórios do Google Analytics, onde as UTMs aparecem com os valores preenchidos.

Caso os nomes possuam espaço, eventualmente podem aparecer com s caracteres %20. Neste caso utilizar os IDs de campanhas e anúncios pode ser uma alternativa.

Sobre diferenças nos valores do campo de posicionamento

Para identificar onde os anúncios foram exibidos no Facebook e Instagram, a Stract permite extrair os campos:

Publisher Platform (Breakdown)
Platform Position (Breakdown)

Esses campos trazem informações como:

an_classic  
facebook_reels  
facebook_stories  
feed  
instagram_explore  
instagram_stories  
instagram_reels  
marketplace  
search  
video_feeds

No entanto, essas nomenclaturas podem ser diferentes das que você vê nas UTMs geradas automaticamente pelo Facebook e captadas por ferramentas como o ActiveCampaign e Google Analytics, que costumam exibir valores como:

Instagram_Feed  
Instagram_Reels  
Instagram_Stories  
Facebook_Mobile_Feed  
Facebook_Stories  
Others

Essa diferença ocorre por conta da forma que a API do Facebook repassa os valores.

Sobre correspondência do parâmetro com a nomenclatura das UTMs

Atualmente, a API não retorna diretamente o valor da UTM já substituído, tampouco fornece um campo que utilize exatamente os mesmos nomes presentes nas UTMs dinâmicas.

Por isso, pode haver discrepância no cruzamento dos dados se você basear a análise unicamente nas UTMs.

Para resolver isso, recomendamos montar uma tabela de correspondência entre os valores retornados por Platform Position e os valores capturados nas UTMs.

Essa tabela pode ajudar a padronizar os dados e facilitar a comparação entre os relatórios de performance (como os extraídos pela Stract) e os dados de ferramentas como o Google Analytics ou ActiveCampaign.

Se tiver dúvidas sobre como tratar ou comparar esses dados, fale com o suporte.