Introducing Graph API v20.0 and Marketing API v20.0

Hoje estamos lançando a versão 20.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 uma lista completa de todas a mudanças e detalhes, acesse nosso registro de alterações.

Atualizações gerais

Atualização automática da versão da API de Marketing

Para oferecer uma experiência geral com a API de Marketing ainda mais integrada e eficiente, estamos felizes em anunciar o lançamento do recurso de atualização automática da versão. A partir de hoje, habilitaremos o recurso de atualização automática da versão para os pontos de extremidade da API de Marketing que não forem afetados entre as versões. Isso significa que, entre uma versão prestes a ficar obsoleta e a próxima disponível, se nenhum ponto de extremidade for afetado, a plataforma atualizará automaticamente a chamada para a versão seguinte, em vez de apresentar falha na solicitação diretamente.

Para saber mais sobre esse comportamento, consulte o controle de versões da API de Marketing e o blog de lançamento.

Para verificar os pontos de extremidade afetados em cada versão, consulte nosso registro de alterações.

Para atualizações mais específicas da versão 20.0, continue lendo.

Anúncios com lembrete para a API de Marketing

Antes de 13 de maio de 2024, os desenvolvedores não podiam oferecer suporte à criação de anúncios com lembrete pela API de Marketing do Instagram. Já os clientes deles só podiam criar anúncios com lembrete no Gerenciador de Anúncios da Meta. Essa falta de compatibilidade criou atritos indesejados para nossos parceiros e os clientes deles que queriam veicular anúncios com lembrete.

Depois de receber feedbacks consistentes sobre essa incompatibilidade, passamos a oferecer suporte à criação de anúncios com lembrete pela API de Marketing do Instagram a partir de 13 de maio de 2024.

Agradecemos o feedback recebido da nossa comunidade de desenvolvedores e dos clientes deles e esperamos continuar melhorando a experiência de anúncios com lembrete disponíveis pela API de Marketing.

Sobre os anúncios com lembrete do Instagram

Os anúncios com lembrete do Instagram ajudam os anunciantes a preencher o período entre o momento da promoção e o do lançamento, incentivando as pessoas interessadas a definir lembretes. As pessoas que ativam o recurso recebem lembretes no momento mais importante, antes do evento.

Sobre como criar e editar eventos

Os anúncios com lembrete do Instagram usam a hora e a data de início do evento para determinar quando os lembretes serão enviados. Essa alteração permite que os desenvolvedores criem e editem eventos na Graph API do Instagram. Você pode criar anúncios de lembrete pela API de Marketing do Instagram depois de anexar eventos ao criativo do anúncio.

Nova API no nó da conta de anúncios

A nova atualização do nó da conta de anúncios não é uma alteração significativa, e sim uma adição de API. Ao chamá-la, todas as campanhas dessa conta de anúncios que possuem recomendações de orientação serão listadas, junto com a melhoria esperada e a orientação no custo por ação (CPA).

A nova API permitirá que os anunciantes visualizem as orientações da Meta sobre as próprias campanhas. Esses dados já aparecem na Central de Parceiros para todos os parceiros. No entanto, estão disponíveis por meio da IU, o que exige a seleção manual de uma única conta de anúncios para visualizar a orientação.

Automatizando o acesso a esses dados por meio da API CPA_GUIDANCE, esperamos eliminar o trabalho manual necessário para verificar a orientação por conta de anúncio. Para nossos parceiros, o acesso a essa API permitirá que eles criem visualizações personalizadas internamente e vejam as tendências ao longo do tempo.

Se a sua empresa gerencia centenas ou milhares de contas, é difícil verificar qualquer métrica delas uma por uma, principalmente quando o assunto é urgente (as recomendações RSS são atualizadas todos os dias e consideram as campanhas ativas nos últimos 28 dias). Esta API permitirá às agências identificar as campanhas mais promissoras que podem ser otimizadas a partir das recomendações fornecidas, que serão posteriormente incorporadas nos sistemas delas.

A API CPA_GUIDANCE permite especificamente que as agências forneçam orientação às marcas parceiras delas sobre quais produtos ou categorias têm o maior custo por aquisição (CPA). Ao compartilhar essas informações, as agências podem ajudar as marcas parceiras a otimizar o próprio investimento em publicidade e melhorar o desempenho geral das campanhas colaborativas.

As agências também poderão acompanhar se uma recomendação de orientação foi posta em prática observando uma tendência de melhoria do CPA.

Anúncios com vários anunciantes

Hoje, estamos apresentando a possibilidade de os anunciantes aceitarem anúncios com vários anunciantes pela API de Marketing. Antes dessa atualização, os desenvolvedores não podiam oferecer suporte à criação de anúncios com vários anunciantes pela API. Já os clientes deles só podiam criar anúncios com vários anunciantes no Gerenciador de Anúncios da Meta.

Sobre os anúncios com vários anunciantes

Os anúncios com vários anunciantes podem ajudar as pessoas a descobrir produtos e serviços de várias empresas. Para posicionamentos selecionados no Facebook e no Instagram, anúncios podem aparecer ao lado de outros na mesma unidade de anúncio para ajudar as pessoas a descobrir produtos e serviços de empresas que sejam personalizados para elas. Uma unidade de anúncio é um contêiner que exibe vários anúncios, geralmente na mesma página. Saiba mais na Central de Ajuda para Empresas.

O que isso significa para os desenvolvedores

No momento do lançamento, a veiculação de anúncios com vários anunciantes criados por meio da API de Marketing fica desativada por padrão. Isso significa que os desenvolvedores precisarão implementar alterações no código dos anúncios dos próprios clientes para que possam se qualificar para a experiência. A criação de anúncios com vários anunciantes é compatível com todas as versões da API de Marketing. Porém, as solicitações de criação qualificadas para isso precisam especificar se o anúncio usará a funcionalidade ou não. Em 19 de agosto de 2024, os anúncios com vários anunciantes serão alterados para a definição padrão. Os desenvolvedores que ainda não implementaram alterações de código precisarão fazer isso para fornecer aos clientes a opção de cancelar a experiência.

Recursos criativos de IA generativa chegando à API de Marketing: geração de texto, expansão de imagens e geração de plano de fundo

Em outubro de 2023, anunciamos o lançamento dos nossos primeiros recursos criativos para anúncios com tecnologia de IA generativa para empresas no Gerenciador de Anúncios: a geração de texto, a expansão de imagens e a geração de planos de fundo. Hoje, gostaríamos de compartilhar que estamos trazendo esses recursos criativos de IA generativa aos anunciantes por meio da nossa API de Marketing (MAPI). Assim, parceiros, agências e anunciantes também podem aproveitar as vantagens das ofertas de GenAI da Meta com a MAPI.

Esses recursos permitem a geração de variações criativas de maneira rápida e automática, trazendo uma nova era de criatividade que maximiza a produtividade, a personalização e o desempenho para todos os anunciantes:

• Geração de planos de fundo: cria até quatro planos de fundo para complementar as imagens dos produtos, permitindo uma diversificação criativa para seus públicos. Os planos de fundo gerados serão baseados nas imagens originais do produto e geralmente são simples, com cores e padrões.

• Expansão de imagens: ajusta com perfeição as peças publicitárias de uma imagem para se ajustar a diferentes taxas de proporção em todas as plataformas, começando pelo Feed e, em breve, expandindo para o Reels. Isso permite que você gaste menos tempo e recursos no reaproveitamento de peças publicitárias.

• Geração de texto: gera várias versões de textos de anúncios com base no texto original, destacando os pontos de venda de produtos/serviços e criando múltiplas opções de texto para diversificar seus anúncios para os públicos.

Hoje, estamos trazendo esses recursos para mais anunciantes. Ficamos felizes em oferecer o poder da nossa IA generativa a um público mais amplo.

Em conformidade com nossa abordagem de testar novos produtos que possam estar sujeitos a um controle adicional, certos setores, como os serviços financeiros, farmacêuticos/de saúde e anúncios de moradia, emprego ou serviços financeiros (HEC), temas sociais, eleições ou política (SIEP) podem não ter acesso imediato a todos os recursos da IA generativa.

Como isso vai funcionar?

Hoje, estamos lançando suporte para esses recursos como parte da nossa API de Marketing, mais especificamente das APIs de criativo do anúncio. Os anunciantes poderão usar esses recursos da API, além de visualizar criativos de IA generativa da API.

O exemplo a seguir mostra como incluir seu criativo de anúncio nos recursos de IA generativa da API de Marketing.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Observação: o exemplo acima mostra a Ativação do recurso de geração de planos de fundo. De maneira similar, a expansão de imagens usa a tecla image_uncrop e a geração de texto usa a tecla text_generation em creative_features_spec.

Os anunciantes também poderão visualizar criativos transformados pela IA generativa por meio da API. Confira o link da documentação para desenvolvedores para saber mais sobre como gerar, fornecer o criativo do anúncio e visualizar o conteúdo gerado para cada um dos nossos recursos de GenAI.

API de Vídeo do Instagram: carregamento retomável para a API de Vídeo do Instagram

Iniciado em 15 de maio de 2024, o novo “Protocolo de carregamento retomável” oferecerá suporte à publicação de vídeos do Instagram (ou seja, Reels, Stories de vídeo e Carrossel de vídeos), seja de vídeos locais ou URLs de vídeos hospedados publicamente. Esse novo protocolo permite o carregamento de arquivos locais e de vídeos mais longos somente no Reels (ou seja, até 15 minutos) e a recuperação de uma operação de carregamento após uma interrupção na rede ou outra falha de transmissão.

Anteriormente, para criar vídeos no Instagram, os arquivos de vídeo tinham que ser enviados para um serviço de hospedagem acessível ao público. Nele, um URL compartilhável seria obtido e fornecido à Meta para a publicação do vídeo.

Os detalhes do fluxo de publicação de conteúdo aprimorado podem ser encontrados na documentação para desenvolvedores sobre publicação de conteúdo, além de mais detalhes sobre mídias no Instagram aqui.

Graph API do Instagram: integrando novas métricas

Hoje, seis métricas adicionais para o contêiner de mídia do carrossel serão disponibilizadas para a Graph API. Essas métricas são curtidas, comentários, compartilhamentos, seguidores, atividade no perfil (número de ações realizadas quando um usuário visita seu perfil) e visitas no perfil (o número de vezes que seu perfil foi visitado). Elas já estão disponíveis na Página de Insights do Instagram, mas isso garantirá que também estejam disponíveis pela Graph API.

Adicionando curtidas, comentários, compartilhamentos, seguidores, atividades no perfil e visitas no perfil aos pontos de extremidade da Graph API para publicações em carrossel, essas métricas aparecerão diretamente na chamada de API.

Consulte a lista completa de métricas aqui para adicionar as métricas relevantes à sua chamada GET API para publicações de contêiner de carrossel hoje mesmo.

Cronograma de descontinuação atualizado: API de conversão offline da Meta (OCAPI)

Ano passado, anunciamos que a versão 17 da API de conversões offline não oferecerá mais suporte a eventos offline e previmos que essa API seria descontinuada no terceiro trimestre de 2024. Essa linha do tempo de descontinuação antecipada foi atualizada e estamos confirmando que a API de conversões offline (OCAPI) será descontinuada em maio de 2025. Embora a descontinuação da OCAPI tenha sido adiada do terceiro trimestre de 2024 para maio de 2025, ainda incentivamos que os anunciantes que enviam eventos offline por meio da API de conversões offline (OCAPI) planejem a migração da configuração existente para começar a enviar eventos offline por meio da API de Conversões (CAPI para offline).

Descontinuações e alterações disruptivas

Descontinuação do botão de reserva na API do Messenger

Imediatamente, o botão de reserva não será mais compatível com chamadas da API do Messenger. Essa alteração não afeta outros modelos e botões. As empresas ainda podem gerenciar reservas usando o Meta Business Suite.

Descontinuação da criação do tipo de anúncio "Mensagens patrocinadas" na API de Marketing

A partir de hoje, a criação do tipo de anúncio "Mensagens patrocinadas" não estará mais disponível na versão 20.0 da API de Marketing. O suporte à criação desse tipo de anúncio em versões anteriores da API terminará após 90 dias. Essa alteração não afetará outros tipos de anúncios de mensagem.

Recomendamos revisar as integrações atuais e ajustar os apps conforme necessário para que a transição seja tranquila para os usuários.

Remoção de prazos não críticos para métricas demográficas de insights (pela Graph API externa do Instagram)

Em 21 de maio de 2024, lançamos a versão 20 da Graph API do Instagram.

Noventa dias depois do lançamento (em 19 de agosto de 2024), a Graph API não compartilhará mais métricas demográficas sobre membros do público engajados e alcançados dentro de prazos não críticos para a Graph API do Instagram. Por exemplo, informações de distribuição de países, cidades, idade e gênero nos últimos 14 e 90 dias.

A Graph API do Instagram ainda retornará informações demográficas do mês anterior (“este_mês”) e da semana anterior (“esta_semana”), semelhante ao app do Instagram, a fim de garantir consistência entre as plataformas.

Essa nova atualização reduz qualquer confusão, bem como aumenta a confiabilidade e a qualidade dos nossos relatórios.

Para saber mais, consulte a documentação para desenvolvedores.

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

• 28 de maio de 2024: a versão 13.0 da Graph API será descontinuada e removida da plataforma.

• 17 de setembro de 2024: a versão 14.0 da Graph API será descontinuada e removida da plataforma.

• 20 de novembro de 2024: a versão 15.0 da Graph API será descontinuada e removida da plataforma.

API de Marketing

• 13 de agosto de 2024: a versão 18.0 da API de Marketing será descontinuada e removida da plataforma.

• 4 de fevereiro de 2025: a versão 19.0 da API de Marketing 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.

SDK de Negócios da Meta

Lançamento da versão 20 do SDK de Negócios da Meta

O lançamento da versão 20 SDK de Negócios da Meta será feito logo após o lançamento da versão 20 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 20 da Graph API.

Nesse lançamento, também apresentamos suporte adicional às APIs do Instagram. São elas IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI e IGAccessTokenForIGOnlyAPI. Elas habilitam mais métodos além das APIs existentes do Instagram, que permitem a busca direta de mídia. Nosso objetivo é integrar mais APIs que cubram outros produtos da Meta para enriquecer o ecossistema do SDK de Negócios.

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 2024: a versão 13.0 ou anteriores do SDK da plataforma do Facebook serão desativadas.