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

Hoje estamos lançando a versão 15.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 à integração do seu aplicativo à nossa plataforma.

Para ver uma lista completa de todas as mudanças e detalhes, acesse o nosso registro de alterações.

Atualizações e anúncios gerais

Simplificando os critérios para a criação de conversão personalizada

Para simplificar o processo de criação de campanhas para os anunciantes, as conversões personalizadas recém-criadas precisarão de pelo menos uma regra associada no lançamento da Graph API v15.0. As conversões personalizadas que não exigem regras devem usar a otimização de evento personalizado, que permite às campanhas de anúncios serem otimizadas diretamente no evento. Estamos trabalhando ativamente na transição das conversões personalizadas existentes de uma oferta única e integrada para vários produtos de valor específico. Com isso, esperamos atender melhor às necessidades e casos de uso dos anunciantes. Essa alteração fará com que mais anunciantes adotem a otimização de evento personalizado, em vez de conversões personalizadas baseadas em eventos personalizados.

Atualizações dos Termos da Plataforma

Estamos atualizando os Termos da Plataforma para alterar a seção sobre a remoção do acesso de um app a qualquer API, permissão ou recurso da Plataforma que ele não tenha usado ou acessado dentro de certo período. A partir de 15 de dezembro de 2022, os Termos da Plataforma exigirão atividade dentro de um período de 28 dias para o app ser considerado ativo.

Caso você receba um aviso de que ele está inativo, acesse a sua função de administrador e reestabeleça o app se desejar.

Consulte os Termos da Plataforma para ter uma visualização completa dessas mudanças aqui.

Descontinuações e alterações disruptivas

Apresentamos o público personalizado Advantage

A partir de 19 de setembro de 2022, começaremos a introdução do público personalizado Advantage. O público personalizado Advantage usa um público personalizado do anunciante para orientar a veiculação e ajudar a encontrar mais pessoas que possam atingir as metas de otimização informadas. Isso significa que veicularemos anúncios para outros públicos, além do personalizado, caso isso ajude a melhorar o desempenho. O público personalizado Advantage faz parte do nosso pacote de produtos de Direcionamento Advantage, incluindo o Direcionamento Detalhado Advantage e semelhantes. Nossos produtos de Direcionamento Advantage impulsionam a automação avançada e a tecnologia de aprendizado de máquina, o que ajuda a melhorar o desempenho da campanha do anunciante com menos esforço manual.

Os anunciantes que usam públicos personalizados poderão selecionar públicos personalizados Advantage. Com os públicos personalizados Advantage, os anunciantes continuarão a criar público personalizado (site, atividade do app, lista de cliente ou engajamento) e aplicar as inclusões/exclusões relevantes, ao mesmo tempo que se beneficiam da nossa tecnologia de aprendizado de máquina e automação avançada. Essa tecnologia usa o seu público personalizado como uma fonte para orientar a veiculação a fim de atingir mais usuários que provavelmente alcançarão a meta de otimização informada.

Os públicos personalizados Advantage serão ativados automaticamente se você criar uma nova campanha que inclua um público personalizado do site, de dispositivos móveis ou de engajamento. É possível desativar o uso desse produto. Basta desmarcar a caixa de seleção "Públicos Personalizados Advantage" na seção de público personalizado da nossa ferramenta de criação de anúncio.

Descontinuação dos públicos de anúncio especial

Como parte do nosso acordo com o U.S. Department of Housing and Urban Development (HUD), descontinuaremos os públicos de anúncio especial, uma ferramenta que permite aos anunciantes expandir os públicos para conjuntos de anúncios relacionados a moradia, emprego e crédito. A partir de 15 de setembro de 2022, removeremos a habilidade de criar públicos de anúncio especial pela API de Marketing.

Para anunciantes e parceiros, o bloqueio da criação de novos públicos de anúncio especial em 15 de setembro de 2022 será uma alteração disruptiva, já que com essa mudança sem versão, os valores anteriores serão descontinuados. Em 2019, além da eliminação de determinadas opções de direcionamento para anúncios de moradia, emprego e crédito, apresentamos os públicos de anúncio especial como alternativa aos públicos semelhantes. Porém, o campo de imparcialidade no aprendizado de máquina é dinâmico e está evoluindo, por isso, uma forma inicial de abordar preocupações foi com o uso dos públicos de anúncio especial. Agora, o nosso foco é desenvolver novas abordagens para melhorar da imparcialidade, incluindo o método anunciado anteriormente.

Veja abaixo a lista dos pontos de extremidade afetados por essa descontinuação:

Para público de leitura:

• endpoint gr:get:AdAccount/customaudiences
• field operation_status

Para criação de conjuntos de anúncios:

• endpoint gr:post:AdAccount/adsets
• field subtype

Para edição de conjuntos de anúncios:

• endpoint gr:post:AdCampaign
• field subtype

Para criação de público personalizado:

• endpoint gr:post:AdAccount/customaudiences
• field subtype

Para edição de público personalizado:

• endpoint gr:post:CustomAudience

Consulte a publicação de blog anterior e a documentação para desenvolvedores para mais informações de suporte relacionadas à implementação de código.

Direcionamento Detalhado Advantage/Paridade de semelhantes Advantage

Este projeto traz paridade para o Direcionamento Detalhado como um Sinal (Direcionamento Detalhado Advantage) para usuários de API que usam conjuntos de anúncios com Mensagens/Instalações do app como objetivos (após o lançamento do Gerenciador de Anúncios). Anteriormente, lançamos o Direcionamento Detalhado Advantage para API aos conjuntos de anúncios com conversões como objetivo e conversões/valor como metas de otimização (conjuntos de anúncios VO/OC).

Atualmente, quando os anunciantes criam conjuntos de anúncios pela API com mensagens ou instalações do app como um objetivo, eles passam duas coisas como parte do critério de direcionamento (L2). É passada uma lista detalhada de entradas de direcionamento (por exemplo: críquete, futebol, cachorros, entre outros) e uma sinalização indicando se o anunciante quer expandir além dessas entradas (chamada de Direcionamento Detalhado Advantage). Se a sinalização for habilitada, os nossos sistemas entregarão além das seleções de direcionamento detalhadas caso isso possa melhorar o desempenho. Se for desabilitada, os sistemas limitarão a entrega à lista de seleções que os anunciantes forneceram.

No futuro (após o lançamento do Gerenciador de Anúncios), quando os anunciantes criarem novas campanhas com mensagens ou instalações do app como objetivos, as inclusões detalhadas de direcionamento serão usadas como uma entrada (e não uma restrição) para orientar a veiculação de anúncio. Dessa forma, estamos descontinuando a sinalização DTE para esses objetivos e tornando a expansão de direcionamento um comportamento-padrão das seleções detalhadas de direcionamento. Ao fazer isso, podemos ir além das inclusões detalhadas de direcionamento caso isso possa melhorar o desempenho. Todas as outras seleções e exclusões de direcionamento permanecerão inalteradas. Essa alteração não será aplicada a categorias especiais.

Como funciona:

Anteriormente, os anunciantes passariam a sinalização targeting_optimization com um valor de expansion_all ou nenhum para habilitar ou desabilitar a expansão detalhada de direcionamento. Com a mudança na semântica de como o direcionamento detalhado será operado para esses conjuntos de anúncios, os anunciantes não precisam passar essa sinalização ao criar conjuntos com mensagens ou instalações do app como um objetivo, já que isso não afetará os conjuntos recém-criados. Todos esses conjuntos recém-criados sempre usarão as inclusões de direcionamento detalhado como um sinal para nossos sistemas de backend, que pode decidir veicular anúncios além dessas seleções caso isso melhore o desempenho para os anunciantes.

Como a sinalização targeting_optimization não terá efeito nos conjuntos de anúncios recém-criados, estamos planejando descontinuar esse campo para novas campanhas com mensagens e/ou instalações do app como objetivo.

• Para isso, se o anunciante passar a sinalização targeting_optimization ao criar novos conjuntos de anúncios de MAI/mensagens ou ao solicitar estimativas de veiculação sobre esses conjuntos recém-criados, exibiremos uma mensagem de erro pedido que esse parâmetro não seja mais enviado.
• Um novo campo chamado targeting_as_signal será definido no backend durante a criação de novos conjuntos de anúncios de instalação do app/mensagens. Esse campo está disponível em comandos GET somente para ajudar os anunciantes a verificar se os conjuntos de anúncios vão além das inclusões de direcionamento detalhado.

OBSERVAÇÃO: essas alterações ao direcionamento detalhado como um sinal se aplicam somente a conjuntos de anúncios recém-criados com mensagens e/ou instalação do app como objetivo.

Pontos de extremidade de API no escopo:

• gr:post:/act_XXXX/ adsets
• gr:get:/<adset_id>/delivery_estimate

Descontinuação das abas de Páginas

Anunciamos que os recursos da API da Aba Personalizada de Páginas não estarão mais disponíveis pela GraphAPI. Conforme lançamos a nova experiência de Páginas, alguns recursos da API de Páginas serão descontinuados. Os recursos da Aba Personalizada de Páginas não estarão disponíveis na nova experiência, por isso descontinuaremos o suporte à API para esses recursos. Compartilhamos essas atualizações agora a fim de dar aos desenvolvedores e os respectivos clientes tempo suficiente para comunicar a descontinuação dos recursos das próprias páginas e realizar as mudanças necessárias. Esse recurso será totalmente descontinuado em 14/12/2022.

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

• 1º de novembro de 2022: a Graph API v8.0 será descontinuada e removida da plataforma
• 23 de fevereiro de 2023: a Graph API v9.0 será descontinuada e removida da plataforma
• 8 de junho de 2023: a Graph API v10.0 será descontinuada e 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 da plataforma do Facebook

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

• Janeiro de 2023: o SDK da plataforma do Facebook v8.0 ou inferior caducará
• Junho de 2023: o SDK da plataforma do Facebook v9.0 ou inferior caducará
• Outubro de 2023: o SDK da plataforma do Facebook v11.0 ou inferior caducará