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

Hoje estamos lançando a versão 17.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 que podem ser relevantes para a integração dos seus aplicativos à nossa plataforma.

Para ver a lista completa de alterações e detalhes, consulte o Registro de alterações.

Descontinuações e alterações disruptivas

Descontinuação de Estratégias para anúncios

Em 28 de outubro de 2022, o produto beta Estratégias para anúncios ficou obsoleto. Por isso, estamos descontinuando os campos ad_strategy_id e ad_strategy_group_id no ponto de extremidade de campanhas com o lançamento da versão 17.0 da API de Marketing.

Descontinuação da API de Conversões Offline

Em fevereiro de 2023, a API de Conversões se tornou compatível com eventos offline, incorporando os recursos de paridade que eram fornecidos pelo ponto de extremidade da API de Conversões Offline. Ao unificar as APIs para eventos da web e offline, esperamos simplificar e melhorar o uso de dados de marketing entre canais por anunciantes, além de aprimorar a otimização de anúncios, os públicos personalizados e a mensuração.

No lançamento da versão 17 da Graph API em 23 de maio de 2023, a API de Conversões Offline deixará de ser compatível com eventos offline. Recomendamos aos anunciantes que têm integrações da API de Conversões Offline que as convertam em integrações da API de Conversões e que não atualizem a API de Conversões Offline até que esse processo seja concluído.

Descontinuação da criação com objetivos antigos

Conforme anunciado em dezembro de 2021, reformulamos a experiência de escolha do objetivo a fim de guiar anunciantes à configuração de campanhas que aprimorem o alcance dos objetivos de marketing de maneira efetiva. As novas experiências de anúncios orientadas a resultados geraram mudanças na API de Marketing.

Com o lançamento da versão 17.0 da API de Marketing, começaremos a descontinuar a experiência e os objetivos antigos. Na versão 17.0 da API de Marketing, as campanhas só poderão ser criadas com objetivos da experiência de anúncio orientada por resultados. Além disso, os objetivos antigos ficarão obsoletos. As campanhas existentes e as respectivas duplicações continuarão compatíveis e não serão afetadas. Saiba mais nesta publicação recente do nosso blog.

Obrigatoriedade do campo de aprimoramentos padrão de Criativo Advantage+

Neste ano, lançamos os aprimoramentos padrão de Criativo Advantage+ na API de Marketing. A partir de 23 de maio de 2023, os usuários da API de Marketing precisarão especificar a inscrição de um anúncio nos aprimoramentos padrão de Criativo Advantage+ com "OPT_IN" ou "OPT_OUT" no campo "enroll_status". Se o campo ficar em branco, o usuário receberá um erro e será orientado a preenchê-lo. Para saber mais sobre aprimoramentos padrão de Criativo Advantage+ na API de Marketing, confira esta publicação no Blog do Desenvolvedor.

Estes pontos de extremidade serão afetados:

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

Descontinuação de Anúncios de Catálogo Advantage+ para streaming

Com o lançamento da versão 17 da API de Marketing, descontinuamos o uso de Anúncios de Catálogo Advantage+ (A+CA) para streaming. Como alternativa, recomendamos o uso de anúncios do Catálogo de Comércio. Consulte Criar um catálogo no Gerenciador de Comércio. Os seguintes pontos de extremidade ficarão obsoletos:

• Criar catálogo A+CA para streaming: borda owned_product_catalogs com verticais de media_titles
• Carregar feeds de títulos de mídia: borda product_feeds com catálogo A+CA para streaming
• Criar item de título de mídia: borda media_titles com catálogo A+CA para streaming
• Criar campanha com um catálogo A+CA para streaming: borda campaigns com um catálogo DAS em L3, L2 ou L1

A partir de 21 de agosto de 2023, as mudanças acima serão aplicadas a todas as versões da API de Marketing. Pausaremos todas as campanhas que tiverem catálogos A+CA para streaming anexadas aos níveis L3, L2 ou L.

Descontinuação da API de Instant Articles

Como o produto Instant Articles ficou obsoleto em 20 de abril de 2023, a API para gerenciá-los também ficará.

Imposição da permissão de gerenciar empresas para contas do usuário

Anteriormente, as páginas adicionais gerenciadas por empresas eram retornadas sem o acesso à permissão business_management. A partir de 23 de maio de 2023, você precisará da permissão business_management para manter o acesso a esse tipo de página. Consulte business_management para ver mais informações sobre a permissão.

Descontinuações de versões de API:

Veja as versões da Graph API e da API de Marketing que ficarão obsoletas:

Graph API

• 8 de junho de 2023: a Graph API v10.0 ficará obsoleta e será removida da plataforma
• 14 de setembro de 2023: a Graph API v11.0 ficará obsoleta e será removida da plataforma
• 8 de fevereiro de 2024: a Graph API v12.0 ficará obsoleta e será removida da plataforma

API de Marketing

• 15 de agosto de 2023: a API de Marketing v14.0 ficará obsoleta e será removida da plataforma
• 15 de agosto de 2023: a API de Marketing v15.0 ficará obsoleta e será removida da plataforma

Para evitar interrupção dos negócios, recomendamos fazer a migração de todas as chamadas para a versão mais recente da API lançada hoje.

SDK da plataforma do Facebook

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

• Junho de 2023: o SDK da plataforma do Facebook v9.0 ou anterior será interrompido
• Outubro de 2023: o SDK da plataforma do Facebook v11.0 ou anterior será interrompido
• Fevereiro de 2024: o SDK da plataforma do Facebook v12.0 ou anterior será interrompido