Voltar para Notícias para desenvolvedores

Novos requisitos da API de Marketing e da API de Anúncios de Parceiros Gerenciados para anúncios do Facebook e do Instagram na União Europeia

16 de maio de 2023PorAdrian Fine

Última atualização: 7 de agosto de 2023

A Meta segue trabalhando para atender às exigências regulatórias. Como parte dos nossos esforços para gerar transparência entre empresas e pessoas, bem como atender aos regulamentos da União Europeia, exigiremos que anunciantes informem o beneficiário e o pagante por anúncios no Facebook e no Instagram direcionados à União Europeia, a territórios associados ou ao mundo todo.

A partir de 16 de maio, os desenvolvedores que usam a API de Marketing para criar e publicar anúncios poderão informar o beneficiário e o pagante dos anúncios que incluírem a União Europeia, territórios associados ou o mundo todo no direcionamento do Facebook ou Instagram. Consulte a lista completa aqui. Essa informação passará a ser obrigatória em anúncios criados a partir de 16 de agosto. A partir de 17 de agosto de 2023, exibiremos as informações sobre o beneficiário e o pagador para todos os anúncios criados em ou após 22 de junho de 2023 e que veicularam uma impressão para a UE ou territórios associados. Veja mais informações aqui.

O que muda na API de Marketing: incluímos dois novos campos, dsa_payor e dsa_beneficiary, para criar, copiar e editar anúncios com direcionamento para a União Europeia ou territórios associados.

Por conveniência, também fornecemos um recurso para salvar as informações do beneficiário e do pagador no nível da conta de anúncios ("recurso padrão do beneficiário e do pagador"). Depois que o beneficiário e o pagador padrão forem definidos no nível da conta de anúncios, as informações do beneficiário e do pagador serão preenchidas automaticamente com os valores padrão e você não precisará fornecer essas informações para cada conjunto de anúncios. Os anunciantes sempre podem substituir o valor nas solicitações no nível do conjunto de anúncios e alterar os valores padrão no nível da conta de anúncio.

Além disso, estamos oferecendo uma nova API que gera uma lista de strings que identificamos como provavelmente o beneficiário/pagador, com base na atividade recente da conta de anúncios.

Pontos de extremidade afetados pela aplicação de RSD:

  • Criar conjunto de anúncios em RSD: POST /act_<ad_account_id>/adsets
  • Criar anúncio em conjunto de anúncios em RSD: POST /<ad_account_id>/ads
  • Atualizar anúncio em conjunto de anúncios em RSD: POST /<ad_id>
  • Atualizar conjunto de anúncios em RSD: POST /<ad_set_id>
  • Copiar anúncio em anúncio em RSD: POST /{ad_id}/copies
  • Copiar campanha com conjuntos de anúncios em RSD: POST /{campaign_id}/copies
  • Copiar conjunto de anúncios em RSD: POST /{ad_set_id}/copies

Pontos de extremidade afetados por recursos salvos por RSD:

  • Atualizar conta de anúncios: POST /act_<ad_account_id>
  • Obter conta de anúncios: GET /act_<ad_account_id>

Consulte a documentação para desenvolvedores para ver mais informações e a lista completa de alterações.

Aviso para direcionamento de objetos de anúncios na UE:

  1. Para usar o recurso padrão de beneficiário e de pagador, ambos são necessários
  2. Sem a configuração padrão de beneficiário e de pagador, os dois campos são obrigatórios explicitamente. A falta de informações fará com que a solicitação falhe e não tenha efeito em seus objetos de direcionamento.
  3. Nas solicitações de criação/atualização de conjuntos de anúncios, se apenas um, o beneficiário ou o pagador, for informado na solicitação, o outro será automaticamente preenchido com o valor padrão. Ele não usará o mesmo valor fornecido para o outro campo.
  4. A alteração dos valores padrão no nível da conta de anúncios não afeta os conjuntos de anúncios existentes.
  5. Copiar um conjunto de anúncios existente sem configuração de beneficiário e de pagador causará uma falha quando nenhum valor padrão for configurado. Depois que os valores padrão forem configurados, o conjunto de anúncios recém-gerado será preenchido com as informações padrão do beneficiário e do pagador.
  6. Ao criar ou copiar um anúncio em um conjunto de anúncios que não possui beneficiário e pagador definidos, o anúncio será preenchido com os valores padrão. Se os valores padrão não forem definidos, haverá uma falha.

Para mercados que usam a API de Anúncios de Parceiros Gerenciados (MPA, pelas inicias em inglês):

As alterações na API de Criação de Anúncios de Parceiros Gerenciados entraram em vigor em 30 de maio de 2023. Os desenvolvedores do MPA já receberam notificações separadas relacionadas a isso.

O que muda na API de MPA: também introduzimos dois novos campos, dsa_payor e dsa_beneficiary, para criar, copiar e editar campanhas de MPA com direcionamento para a União Europeia ou territórios associados.

Pontos de extremidade afetados:

  • Criar anúncio de vendedor: POST /act_<accound_id>/managed_partner_ads
  • Atualizar anúncio de vendedor: POST /act_<accound_id>/managed_partner_ads

Consulte a documentação para desenvolvedores para ver mais informações e a lista completa de alterações na API de Anúncios de Parceiros Gerenciados.