Apresentamos a versão 19.0 da Graph API e da API de Marketing do Facebook

Hoje estamos lançando a versão 19.0 da Graph API e da API de Marketing do Facebook. 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 a lista completa e detalhada das mudanças, consulte o registro de alterações.

Atualizações gerais

Ativando o direcionamento detalhado Advantage para todos os objetivos e otimizações de campanha

Como parte do nosso esforço contínuo para ajudar os anunciantes a aprimorar o desempenho, estamos expandindo a disponibilidade do nosso produto de direcionamento detalhado Advantage para todos os objetivos e otimizações de campanha.

O direcionamento detalhado Advantage faz parte do nosso conjunto de produtos Advantage que usa automação avançada e tecnologia de aprendizado de máquina para ajudar a melhorar o desempenho da campanha dos anunciantes. Especificamente, o direcionamento detalhado Advantage pode ajudar a melhorar o desempenho da campanha permitindo que nosso sistema alcance um grupo maior de pessoas do que o definido nas seleções de direcionamento detalhado iniciais de um anunciante, caso nosso sistema preveja que há probabilidade de aprimorar o desempenho.

Em 23 de janeiro de 2024, implementaremos as seguintes alterações para anunciantes e parceiros que usam a API de Marketing:

• As campanhas otimizadas para impressões, visualizações do vídeo, alcance, engajamento ou incrementalidade na lembrança do anúncio agora terão a opção de ativar o direcionamento detalhado Advantage.
• As campanhas otimizadas para cadastros terão o direcionamento detalhado Advantage aplicado automaticamente, com a opção de desativação.
  • Observação: a opção de ativação será ligada para campanhas/conjuntos de anúncios novos e duplicados, e você poderá desativá-la se desejar.
• As campanhas otimizadas para cliques no link ou visualizações da página de destino terão o direcionamento detalhado Advantage aplicado automaticamente, sem a opção de desativação.

Para anunciantes e parceiros que usam a API de Marketing, essas mudanças serão uma alteração disruptiva. A partir de 23 de janeiro de 2024, os desenvolvedores podem começar a implementar as alterações de código e terão até 22 de abril de 2024 para fazer as atualizações. Essa alteração será lançada na nova versão V19 da API.

<Impacted endpoints>

Novos anúncios, conjuntos de anúncios e campanhas da API de Marketing que usam os objetivos originais

Começando pela API de Marketing v19.0, novos anúncios, conjuntos de anúncios e campanhas que usam os objetivos originais (listados abaixo) não podem mais ser criados por meio do texto do anúncio. Os objetivos do anúncio precisarão ser atualizados para refletir nossos objetivos simplificados.

A partir da versão 20 da API de Marketing, não haverá mais suporte para a criação de anúncios e conjuntos de anúncios em campanhas com objetivos originais. No entanto, as versões da API anteriores à v20 (por exemplo, v19, v18) ainda permitirão o uso dessa funcionalidade. Não é necessário realizar nenhuma ação para os anúncios existentes que usam os objetivos originais.

Objetivos originais afetados

• BRAND_AWARENESS
• CONVERSIONS
• EVENT_RESPONSES
• LEAD_GENERATION
• LINK_CLICKS
• LOCAL_AWARENESS
• MESSAGES
• OFFER_CLAIMS
• PAGE_LIKES
• POST_ENGAGEMENT
• REACH
• STORE_VISITS
• VIDEO_VIEWS

Pontos de extremidade POST afetados

• /{ad_id}/copies
• /{campaign_id}/copies
• /{adset_id}/copies

Para referência, esta é a publicação anterior do blog de desenvolvedores a respeito das alterações feitas na API na criação de campanhas que usam os objetivos originais.

Perguntas frequentes

P: Esta alteração exige uma atualização no código?

R: Sim, há várias chamadas de API para a V18 que não funcionarão na V19 (ou seja, novos anúncios, conjuntos de anúncios e campanhas que usam os objetivos originais não poderão ser criados por meio do texto do anúncio).

P: Qual é o comportamento esperado antes e depois da alteração?

R: Antes, as chamadas de API feitas para duplicar um anúncio, conjunto de anúncios ou campanha que usava os objetivos originais funcionavam. Agora elas falharão.

P: Qual é o prazo para implementar as alterações no código?

R: Até a descontinuação da v18.0, que deve acontecer provisoriamente em setembro de 2024.

Documentação adicional para desenvolvedores

• https://developers.facebook.com/docs/marketing-api/reference/adgroup/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/copies/

Artigos de ajuda

• Mudanças nos objetivos no Gerenciador de Anúncios da Meta
• Como escolher o objetivo do anúncio certo do Gerenciador de Anúncios da Meta

PPCA (permissão de acesso ao conteúdo público da página)

O caso de uso para dados coletados com o uso da PPCA (permissão de acesso ao conteúdo público da página) mudou. Para mais detalhes, consulte o link a seguir.

Apresentamos a API de público Advantage+

Em outubro do ano passado, lançamos o público Advantage+, uma experiência de criação de público nova e simplificada. Ela ajuda a melhorar o desempenho da campanha ampliando o público ao qual um anúncio possivelmente será veiculado, ao mesmo tempo que continua veiculando o anúncio às pessoas que os anunciantes mais querem alcançar.

Agora estamos lançando o público Advantage+ na API de Marketing.

• Para ativá-lo, configure o parâmetro targeting_automation em advantage_audience como 1.
• Para ativá-lo, configure o parâmetro targeting_automation em advantage_audience como 0.

Descontinuações e alterações disruptivas

Descontinuação da API de Grupos do Facebook

A API de Grupos do Facebook foi descontinuada na v19 e, em 90 dias, será removida de todas as versões. Essa descontinuação inclui todas as permissões (publish_to_groups, groups_access_member_info) e recursos analisáveis (API de Grupos) associados à API de Grupos do Facebook.

Um caso de uso importante para a API de Grupos eram as respostas privadas em grupos. Estamos implementando outra alteração na v19 que permitirá esse caso de uso sem que os desenvolvedores precisem usar a API de Grupos. Para a maioria dos desenvolvedores de respostas privadas, não haverá alterações para fazer na v19. No caso dos desenvolvedores que usavam chamadas para os pontos de extremidade de publicação em grupos por meio da API de Grupos depois de receber um webhook de respostas privadas, eles precisarão usar um token de acesso à Página para essas solicitações.

Os desenvolvedores que não têm certeza se os seus pontos de extremidade usam uma permissão obsoleta podem verificar isso testando os pontos de extremidade na versão 19.0

Alterações na API de Insights sobre a Página: descontinuação de métricas

À medida que migramos das Páginas clássicas para a nova experiência de Páginas no Facebook, descontinuaremos diversas métricas da API de Insights sobre a Página. Para mais informações, consulte este link.

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

• 8 de fevereiro de 2024: a Graph API v12.0 ficará obsoleta e será removida da plataforma
• 28 de maio de 2024: a Graph API v13.0 ficará obsoleta e será removida da plataforma
• 17 de setembro de 2024: a Graph API v14.0 ficará obsoleta e será removida da plataforma

API de Marketing

• 6 de fevereiro de 2024: a API de Marketing v16.0 ficará obsoleta e será removida da plataforma
• 14 de maio de 2024: a API de Marketing v17.0 ficará obsoleta e será removida da plataforma

Para evitar inconvenientes à sua empresa, recomendamos que você migre todas as chamadas para a versão mais recente da API lançada hoje.

SDK de Negócios da Meta

Lançamento do SDK de Negócios da Meta v19

O lançamento do SDK de Negócios da Meta v19 será feito logo depois do lançamento da Graph API v19. 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 Graph API v19. No futuro, planejamos ter lançamentos mais frequentes do SDK para alinhamento com a cadência das atualizações da API. Isso permitirá que os desenvolvedores se mantenham atualizados com os últimos recursos, APIs e funcionalidades.

Como parte da nossa programação de descontinuação em dois anos para SDKs da plataforma, veja as próximas descontinuações e caducidades:

• Fevereiro de 2024: o SDK da plataforma do Facebook v12.0 e anteriores serão descontinuados