Blog

Atualização das APIs: Novembro de 2025

Listamos aqui as mudanças mais relevantes nas APIs do Google Ads, Meta Ads e Facebook Insights. As métricas descontinuadas estão marcadas como (Deprecated) na lista de campos da Sidebar e do Looker Studio.

Em alguns casos, há novos campos correspondentes indicados pela documentação das plataformas. Em outros, os campos são removidos sem substituições diretas.

Meta Ads: novas métricas no Facebook Ads

A API da Meta trouxe novos campos, incluindo alguns dos mais pedidos no suporte da Stract, como Visitas ao perfil e Resultados. Com isso, os usuários agora conseguem avaliar o desempenho de campanhas que direcionam para o perfil do Instagram, o que antes não era possível.

Além disso, foi incluída a métrica de Visualizações de página por clique no link, que mostra a relação entre cliques no anúncio e carregamentos da página de destino (também conhecida como connect rate).

Métricas mais relevantes:

Campo	Nome do Campo (Sidebar e Looker)
Visitas ao perfil do Instagram	Instagram Profile Visits
Resultados	Results
Taxa de resultado	Result Rate
Custo por resultado	Cost Per Result
Visualizações de página por clique no link	Landing Page View per Link Click

Fonte: Meta Ads – Mudanças de Outubro 2025

Facebook Insights: novas métricas para impressões

As atualizações mais recentes da API do Facebook Insights trazem mudanças nas métricas de impressões. Assim como no Instagram Insights, muitas delas foram substituídas por métricas baseadas em views. Para mais detalhes e a lista completa de alterações, acesse a publicação oficial da Meta.

A partir de 15 de novembro de 2025, diversas métricas antigas serão descontinuadas em todas as versões da API. O uso destes campos vai retornar erro de métrica inválida.

Métricas deprecadas (com alternativas sugeridas):

Campo Antigo	Novo Campo	Observações
Post Insights Impressions Nonviral	—	—
Page Insights Fans	Page Insights Follows	page_follows
Page Insights Fans Locale	—	—
Page Insights Fans City	Page Insights Follows City	page_follows_city
Page Insights Fans Country	Page Insights Follows Country	page_follows_country
Page Insights Fan Adds	—	—
Page Insights Fan Adds Unique	—	—
Page Insights Fan Removes	—	—
Page Insights Fan Removes Unique	—	—
Page Insights Impressions	Page Insights Media View	page_media_view
Page Insights Impressions Paid	Page Insights Media View	page_media_view com detalhamento is_from_ads
Page Insights Impressions Viral	—	—
Page Insights Impressions Nonviral	—	—
Post Insights Impressions	Post Insights Media View	post_media_view
Post Insights Impressions Paid	Post Insights Media View	post_media_view com detalhamento is_from_ads
Post Insights Impressions Fan	Post Insights Media View	post_media_view com detalhamento is_from_followers
Post Insights Impressions Organic	Post Insights Media View	post_media_view com detalhamento is_from_ads
Post Insights Impressions Viral	—	—

Fonte: Changelog – Facebook Insights

Google Ads: novos campos e substituições

A versão 22 da API do Google Ads trouxe ajustes importantes, principalmente nas métricas relacionadas a vídeos. Abaixo são listadas as métricas que serão removidas e as novas métricas correspondentes:

Campo Antigo	Novo Campo
Average CPV	Trueview Average CPV
Video View Rate	Video Trueview View Rate
Video Views	Video Trueview Views
Video View Rate In Feed	Video Trueview View Rate In Feed
Video View Rate In Stream	Video Trueview View Rate In Stream
Video View Rate Short	Video Trueview View Rate Shorts

Fonte: Update v21 para v22 e Google Ads API v22 – Métricas

O que precisa ser feito

Se você já usa essas métricas em suas planilhas ou dashboards, é importante atualizar os campos para evitar problemas com extrações futuras. No Google Sheets será necessário editar suas extrações salvas, já no looker será necessário atualizar a fonte de dados para carregar os novos campos.

Veja como atualizar a fonte de dados no Looker Studio

Seguimos acompanhando todas essas mudanças para manter a Stract atualizada.

Se tiver dúvidas entre em contato com o suporte.