Meta lança a Marketing API v27: o que muda em anúncios criados por API e ferramentas de terceiros
A Meta lançou em 4 de novembro a Marketing API v27, e ela muda o comportamento padrão de anúncios criados por API e por ferramentas de terceiros. Quatro mudanças pedem revisão: product showcase automático, alcance em outros dispositivos, lookalike sem país e o fim do endpoint /batch do catálogo.
O que a Meta anunciou na v27
O anúncio saiu no blog oficial da Meta for Developers, junto com a Graph API v27.0. Não é uma mudança de produto do Gerenciador de Anúncios. É uma mudança de comportamento na API, e por isso vale para qualquer conta, inclusive no Brasil. A página oficial não cita países.
Quem opera campanhas só pelo Gerenciador de Anúncios sente pouco. Quem usa uma ferramenta de terceiros, um gerenciador de anúncios em massa ou uma integração própria com o catálogo precisa conferir o que o fornecedor já ajustou. Nossa leitura: o risco não está em quebrar o que roda hoje, e sim em criar anúncios novos com configurações que ninguém escolheu.
As quatro mudanças, lado a lado
| Mudança | O que passa a valer | Como manter o comportamento antigo |
|---|---|---|
| Product showcase | A Meta pode ativar product_extensions em anúncios novos, quando tem alta confiança de que um conjunto de produtos combina com o anúncio | Definir enroll_status como OPT_OUT |
| Alcance em outros dispositivos | Conjuntos novos de vendas com segmentação por dispositivo vêm com a opção ligada | Definir o campo device como 0 |
| Lookalike com localização | A API rejeita lookalike_spec com country ou location_spec | Remover os dois campos |
| Catálogo em lote | /{catalog-id}/batch deixa de funcionar na v27.0 | Migrar para /{catalog-id}/items_batch |
Product showcase pode ser ligado sem você pedir
A partir da v27, a Meta pode ativar a apresentação de produtos em anúncios criados com criativos que não trazem essa configuração. A condição, segundo a página oficial, é haver alta confiança de que um conjunto de produtos do catálogo corresponde ao anúncio.
Para desativar, o campo é degrees_of_freedom_spec.creative_features_spec.product_extensions.enroll_status, com o valor OPT_OUT. O exemplo da própria Meta inclui também action_metadata com o tipo MANUAL. Os endpoints citados são os de criação de anúncios e de criativos na conta de anúncios.
Versões anteriores à v27.0 não mudam. Na prática, quem sobe a versão da API sem revisar o código passa a receber o comportamento novo.
Alcançar mais pessoas em outros dispositivos móveis
Desde a v27.0, novos conjuntos de anúncios de vendas, qualificados e direcionados a dispositivos móveis ou sistemas operacionais específicos, vêm com a opção “Alcançar mais pessoas em outros dispositivos móveis” ligada. Isso acontece quando o campo targeting.targeting_automation.individual_setting.device é omitido.
Para manter a veiculação restrita ao direcionamento escolhido, defina device como 0. Conjuntos existentes não mudam. A opção não existe para o local de conversão em app para celular nem para categorias especiais de anúncios.
Para a maioria das empresas, isso importa quando a segmentação por aparelho é uma decisão de negócio: um app que só roda em Android, uma oferta atrelada a iPhone, um teste que compara sistemas. Nesses casos, o padrão novo contraria a intenção.
Lookalike sem país nem location_spec
Na v27.0 ou posterior, a criação de públicos personalizados rejeita um lookalike_spec que inclua country ou location_spec. A Meta não indica campo substituto: a solução é remover os dois campos da chamada.
Os públicos semelhantes que já existem continuam sendo veiculados sem alteração. O impacto recai sobre rotinas automatizadas que criam públicos novos com localização embutida. Se o script falhar, o erro aparece na criação, não na veiculação.
O endpoint /batch do catálogo sai
O endpoint /{catalog-id}/batch deixa de funcionar na v27.0 e nas versões seguintes. O substituto é o /{catalog-id}/items_batch. Ele continua funcionando na v26.0 e anteriores, até o fim do suporte a essas versões. A Meta indica um guia de migração na documentação.
Quem mantém feed de catálogo por integração própria deve testar o novo endpoint antes de subir a versão. Para quem usa uma plataforma de e-commerce com conector, a pergunta é simples: o conector já usa o items_batch? Vale perguntar ao fornecedor. Se o seu catálogo alimenta campanhas de vendas, o nosso panorama de plataformas de tráfego pago ajuda a situar cada ferramenta.
Qual é o prazo para quem não muda de versão?
Segundo a Meta, as mudanças de alcance em outros dispositivos e de lookalike devem chegar às demais versões cerca de 90 dias depois, em fevereiro de 2027, com data a ser confirmada. Tratamos essa data como previsão, não como compromisso.
Há também um calendário de descontinuação de versões da Graph API que afeta a Marketing API: a v21.0 é removida em 21 de janeiro de 2027 e a v22.0 em 20 de maio de 2027. Quem ainda roda nessas versões tem um prazo firme para migrar.
Checklist de revisão para a sua operação
- Descubra qual versão da Marketing API cada ferramenta e integração usa.
- Pergunte ao fornecedor do gerenciador de anúncios quando ele migra para a v27 e o que mudou no padrão.
- Nos anúncios criados por código, defina OPT_OUT em product_extensions se não quiser a apresentação automática de produtos.
- Nos conjuntos de vendas com segmentação por aparelho, defina device como 0 quando a restrição for intencional.
- Remova country e location_spec das rotinas que criam lookalike.
- Troque /batch por /items_batch nos fluxos de catálogo.
Antes de mexer em configuração, vale lembrar que mudanças de API são só uma parte do cenário. A nova cobrança de impostos da Meta altera o custo, e a escolha entre plataformas segue o que explicamos em como escolher entre Google Ads e Meta Ads.
Se você quer uma conta de anúncios revisada por quem acompanha essas mudanças, conheça nossa gestão de mídia paga para leads qualificados.
Fontes lidas em 06/11/2026: Meta for Developers, “Introducing Graph API v27 and Marketing API v27”, 04/11/2026. Os nomes de campos e as datas citados vêm dessa página. Previsões para outras versões estão marcadas como tal.
Perguntas frequentes
A Marketing API v27 afeta quem só usa o Gerenciador de Anúncios?
Em geral, pouco. As mudanças descritas são de comportamento da API. Quem cria campanhas apenas pela interface não escolhe versão da API, mas pode ser afetado indiretamente se uma ferramenta ligada à conta sobe de versão.
Como desativo o product showcase automático?
Defina enroll_status como OPT_OUT em product_extensions, dentro de creative_features_spec. O exemplo oficial da Meta inclui também action_metadata com o tipo MANUAL. Teste em um anúncio novo antes de aplicar em escala.
Os públicos lookalike que já existem vão parar?
Não. Segundo a Meta, os públicos semelhantes existentes continuam sendo veiculados sem alteração. A rejeição vale para a criação de públicos novos com country ou location_spec.
O que faço com o endpoint /batch do catálogo?
Troque por /items_batch antes de migrar para a v27.0. Na v26.0 e anteriores, o /batch continua funcionando até o fim do suporte a essas versões.
Quando as mudanças valem para versões antigas da API?
A Meta fala em cerca de 90 dias, fevereiro de 2027, para alcance em outros dispositivos e lookalike, com data a ser confirmada. Trate como previsão e acompanhe o aviso oficial.
