Introducing Graph API v22.0 and Marketing API v22.0
Hoje estamos lançando as versões 22.0 da Graph API e da API de Marketing. Como parte desse lançamento, destacamos abaixo as alterações que acreditamos serem relevantes para parte da nossa comunidade de desenvolvedores. As mudanças incluem anúncios, atualizações de produtos e notificações sobre descontinuações em integrações relevantes de apps com nossa plataforma.
Para ver uma lista completa de todas as mudanças e detalhes, acesse nosso registro de alterações.
Atualizações gerais
Mudanças na versão 22.0 da API de Marketing quanto ao uso dos públicos personalizados da lista de clientes em campanhas de moradia, emprego e produtos e serviços financeiros (incluindo crédito)
Aplica-se à versão 22.0 e posteriores e será implementada a todas as versões em março de 2025
Alguns públicos personalizados de lista de clientes não serão qualificados para uso de campanhas de moradia, emprego e produtos e serviços financeiros (incluindo crédito). Saiba mais sobre a atualização e se as restrições se aplicam a você aqui. Além disso, o campo is_sac_cfca_terms_certified será adicionado ao nível do conjunto de anúncios, consulte o exemplo. Use esse campo para garantir que todos os públicos personalizados de lista de clientes de campanhas em um conjunto de anúncios de moradia, emprego e produtos e serviços financeiros (incluindo crédito) estejam em conformidade com a certificação CLCA da Meta. Começando no início de abril de 2025, as campanhas/os conjuntos de anúncios existentes que usam públicos personalizados de lista de clientes que não seguem os requisitos podem ser pausados. Se isso acontecer, você verá erros no Gerenciador de Anúncios e na API de Marketing com instruções.
Estes pontos de extremidade serão afetados:
API de público personalizado versão 22.0
A partir de 6 de janeiro de 2025, você poderá usar o novo campo is_eligible_for_sac_campaigns para identificar se um público personalizado pode ser usado em conjuntos de anúncios de campanhas de categoria de anúncio especial. Forneça special_ad_categories e special_ad_category_countries da campanha da categoria de anúncio especial que usará o público, além do ad_account_id que usará o público para criar ou editar o conjunto de anúncios.
Estes pontos de extremidade serão afetados:
Alcance pessoas interessadas em cidades e regiões selecionadas
É com prazer que compartilhamos o lançamento de um novo produto para direcionamento por localização que ajuda os anunciantes a expandir a veiculação para além das cidades ou regiões para as quais o direcionamento está sendo feito, melhorando o desempenho. Isso dá ao seu sistema de anúncios a flexibilidade de veicular anúncios às pessoas que demonstraram interesse em uma localização.
Esse recurso expande nosso atual recurso de direcionamento por localização. Ele permite que você alcance pessoas que demonstraram intenção de viajar para um local, fazer compras nele, ou que demonstraram um interesse geral nas cidades e regiões para as quais o direcionamento está sendo feito, dentro do mesmo país.
Durante os testes, clientes que usaram o novo recurso de direcionamento por localização viram uma redução de 6,7% no custo por resultado.
Para saber mais, clique aqui.
Descontinuações e alterações disruptivas
Substituição dos pontos de extremidade Usuário do Instagram, Mídia do Instagram, Carrossel do Instagram e Comentário do Instagram pelos pontos de extremidade Usuário do IG, Mídia do IG e Comentário do IG
Estamos fazendo alterações na Graph API do Instagram e na API de Marketing para ajudar os desenvolvedores a criar soluções para empresas. Com essas alterações, estamos descontinuando os objetos Usuário do Instagram, Mídia do Instagram, Carrossel do Instagram e Comentário do Instagram na Graph API versão 22.0 e vamos começar a usar os objetos Usuário do IG, Mídia do IG que inclui carrosséis, e Comentário do IG. Também adicionamos funcionalidade a esses objetos mais novos para fornecer paridade para a maior parte dos casos de uso.
Os desenvolvedores terão até 21 de janeiro de 2026 para atualizar o uso de pontos de extremidade da API de Marketing e até 21 de abril de 2025 para atualizar o uso de pontos de extremidade da Graph API afetados. Se você estiver atualizando automaticamente as versões da Graph API nas chamadas de API, recomendamos ler essas alterações, pois elas serão aplicadas imediatamente para desenvolvedores que usam a Graph API versão 22.0.
Veja o blog de desenvolvedores para saber mais sobre essa alteração, incluindo quais pontos de extremidade estão mudando, quais casos de uso não são mais compatíveis e qual cronograma se aplica.
Remoção de exclusões de direcionamento detalhado
Como parte de nossos esforços contínuos para ajudar anunciantes a gerar desempenho, estamos removendo exclusões de direcionamento detalhado. Como parte desse processo, continuaremos oferecendo suporte à capacidade de excluir seus empregadores dos controles de público no nível da conta. Para saber mais sobre controles de conta, leia aqui.
Acreditamos que essa mudança ajudará a melhorar o desempenho da campanha. /Um teste do anunciante mostrou que a média de custo por conversão era 22,6% menor quando não eram usadas exclusões de direcionamento detalhado em comparação a quando eram usadas.
Como resultado dessa alteração, os públicos personalizados serão descontinuados no campo de exclusões. Você ainda pode continuar usando as exclusões de público personalizado com o campo excluded_custom_audiences.
A partir de 21 de janeiro de 2025, os desenvolvedores podem começar a implementar as alterações de código e terão até 21 de abril de 2025 para fazer essas atualizações. Essa alteração será lançada na versão 22.0. Consulte o blog de desenvolvedores para ver uma lista de pontos de extremidade afetados relacionados a essa alteração.
Descontinuação do pacote de aprimoramentos padrão da API de Marketing
Impactos da API de Marketing versão 22.0 aos aprimoramentos de criativo Advantage+
Nesta nova versão da API de Marketing, descontinuaremos o pacote de aprimoramentos padrão de criativo Advantage+, substituindo-o pela ativação dos aprimoramentos padrão individuais. Saiba mais sobre o criativo Advantage+ aqui.
Aqui, você pode saber mais sobre o que é relevante para a comunidade de desenvolvedores. Detalhes adicionais podem ser encontrados na nossa documentação para desenvolvedores aqui.
Aprimoramentos padrão não terão mais suporte com estes pontos de extremidade:
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
Apresentamos a métrica de visualizações do Instagram e descontinuação das métricas de impressões e reproduções
Para continuar alinhando a funcionalidade da API do Instagram com o app do Instagram, estamos apresentando a métrica "visualizações" em todas as versões da API tanto para insights de mídia quanto para usuários. Para insights de mídia, os objetos do Feed, Story e Reels retornarão as visualizações. Para insights do usuário, a API oferecerá suporte à métrica "visualizações" com detalhamentos multidimensionais para tipo de seguidor e tipo de produtos de mídia.
Além disso, as seguintes métricas serão descontinuadas a partir da versão 22:
- plays (insights sobre a mídia): o número de vezes que o reel começa a ser reproduzido após uma impressão já ter sido contabilizada.
- clips_replays_count (insights de mídia): o número de vezes que o reel começa a ser reproduzido novamente após uma reprodução inicial. As repetições são contabilizadas quando duram 1ms ou mais na mesma sessão do reel.
- ig_reels_aggregated_all_plays_count (insights de mídia): o número de vezes que o reel começa a ser reproduzido ou é repetido após uma impressão já ter sido contabilizada.
- impressions (insights de mídia e usuário): o total de impressões de um objeto de mídia do Instagram.
A métrica de insights de mídia "impressions" só será descontinuada para mídia criada a partir de 2 de julho de 2024. Para mídia criada antes dessa data, a API continuará a retornar valores como de costume em todas as versões.
Mais informações podem ser encontradas na documentação para desenvolvedores sobre Insights de usuários do Instagram e Insights de mídia do Instagram. Incentive os desenvolvedores a fazer atualizações até 21 de abril de 2025 para evitar problemas.
SDK de Negócios da Meta
Lançamento da versão 22.0 do SDK de Negócios da Meta
O lançamento da versão 22.0 do SDK de Negócios da Meta será feito logo após o lançamento da versão 22.0 da Graph API. Esse lançamento incluirá correções de bugs, atualizações de dependências, novos recursos e, mais importante, uma interface de API atualizada para a versão 22.0 da Graph API.
Como parte da nossa programação de descontinuação em dois anos para SDKs da plataforma, veja as próximas descontinuações e caducidades:
- Maio de 2025: o SDK da plataforma do Facebook versão 17.0 e anteriores será descontinuado.
Descontinuações de versões de API:
Observe a programação para as próximas descontinuações de versões da Graph API e da API de Marketing:
Graph API
- 14 de maio de 2025: a Graph API versão 16.0 será descontinuada e removida da plataforma
- 12 de setembro de 2025: a Graph API versão 17.0 será descontinuada e removida da plataforma
API de Marketing
- 4 de fevereiro de 2025: a API de Marketing versão 19.0 será descontinuada e removida da plataforma
- 6 de maio de 2025: a API de Marketing versão 20 será descontinuada e removida da plataforma
Para evitar inconvenientes à empresa, recomendamos que você migre todas as chamadas para a versão mais recente da API lançada hoje.
Atualizações da API de Insights sobre a Página
