Integrar a Audience Network da Meta aos lances

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Meta Audience Network usando mediação, cobrindo integrações de lances. Ele aborda como adicionar a Meta Audience Network à configuração de mediação de um bloco de anúncios e como integrar a Meta Audience Network e o adaptador a um app .

Integrações e formatos de anúncio compatíveis

O adaptador de mediação para a Audience Network da Meta tem os seguintes recursos:

Integração
Lances
Hierarquia  1
Formatos
Banner
Intersticial
Premiado
Intersticial premiado

1 A Audience Network da Meta passou a usar apenas lances em 2021.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Flutter 3.7.0 ou mais recente
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 10.0 ou mais recente
    • O SDK mais recente da Audience Network da Meta geralmente requer a versão mais recente do Xcode.
  • Um projeto em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo da mediação.

Etapa 1: definir as configurações na interface do Audience Network da Meta

Inscreva-se e faça login na página inicial do Gerenciador de empresas.

Clique em Começar e em Criar conta.

Preencha os campos obrigatórios com os detalhes da sua empresa e clique em Próxima.

Criar uma propriedade

Depois de preencher as informações necessárias, você vai precisar criar uma propriedade para o app. Insira o nome desejado para a propriedade e clique em Próxima.

Em seguida, selecione a plataforma para gerar receita.

Adicione os detalhes do app e clique em Próxima.

Android

iOS

Clique em Adicionar uma nova conta de pagamento para configurar sua conta de pagamento. Redirecionaremos você a uma nova página para inserir suas informações de pagamento. Preencha os detalhes necessários e clique em Próxima.

Selecione Google AdMob como a plataforma de mediação e clique em Criar canal.

Selecione um formato, preencha o formulário e clique em Criar.

Anote o ID da posição.

Clique em Concluído.

Ativar o modo de teste

Consulte o guia Como testar a implementação da Audience Network para ver instruções detalhadas sobre como ativar anúncios de teste da Meta Audience Network.

Etapa 2: configurar a demanda da Meta Audience Network na interface

Definir as configurações de mediação para seu bloco de anúncios

Android

Para conferir instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS

Adicionar à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar a Meta à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da Meta Audience Network

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da Meta de público-alvo da rede de anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Meta Audience Network Mediation e clique em Install.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a Meta Audience Network pelo link de download no Changelog e extraia o GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca External Dependency Manager vai executar a resolução do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app Unity.

Forçar resolução

Etapa 4: implementar as configurações de privacidade no SDK da Meta Audience Network

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.

Leia as orientações do Meta para saber mais sobre o GDPR e a publicidade do Meta.

Leis Estaduais de Privacidade dos EUA

As Leis Estaduais de Privacidade dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos na lei) fornecendo uma opção de desativação pelo link "Não vender minhas informações pessoais" na página inicial da parte "vendedora". O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

Para usuários na Califórnia, confira as opções de processamento de dados da Meta.

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração com a Audience Network da Meta.

iOS

Integração da SKAdNetwork

Siga a documentação da Meta Audience Network para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Acompanhamento de publicidade ativado

Se você está criando para iOS 14 ou versões mais recentes, confira as instruções da Meta Audience Network sobre como definir a sinalização de acompanhamento de publicidade.

Etapa 6: testar a implementação

Etapas opcionais

Armazenamento em cache no Android 9

Android

A partir do Android 9 (nível 28 da API), o suporte a texto não criptografado fica desativado por padrão, o que afeta a funcionalidade de armazenamento em cache de mídia do SDK da Meta Audience Network e pode afetar a experiência do usuário e a receita de anúncios. Siga a documentação da Meta para atualizar a configuração de segurança de rede no seu app.

iOS

Não se aplica a integrações com iOS.

Códigos de erro

Se o adaptador não receber um anúncio da Audience Network, verifique o erro subjacente da resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Confira os códigos e as mensagens exibidas pelo adaptador da Audience Network da Meta quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, ID da posição ausente).
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Meta Audience Network.
103 O editor precisa solicitar anúncios com um contexto Activity.
104 O SDK da Audience Network da Meta não foi inicializado.
105 O editor não solicitou anúncios nativos unificados.
106 O anúncio nativo carregado é um objeto diferente do esperado.
107 O objeto Context usado é inválido.
108 O anúncio carregado não tem os recursos de anúncio nativo necessários.
109 Falha ao criar um anúncio nativo a partir do payload de lance.
110 O SDK da Audience Network da Meta não conseguiu apresentar o anúncio intersticial/premiado.
111 Exceção gerada ao criar um objeto AdView da Meta Audience Network.
1000-9999 A Audience Network da Meta retornou um erro específico do SDK. Consulte a documentação do Audience Network do Meta para mais detalhes.

iOS

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, ID da posição ausente).
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Meta Audience Network.
103 Falha ao inicializar o objeto de anúncio da Audience Network da Meta.
104 O SDK do Audience Network da Meta não conseguiu apresentar o anúncio intersticial/premiado.
105 O controlador de vista raiz do anúncio de banner é nil.
106 O SDK da Audience Network da Meta não foi inicializado.
1000-9999 A Meta Audience Network retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para saber mais.

Registro de alterações do adaptador de mediação do Flutter da Meta Audience Network

Próxima versão

  • Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.1.0

  • Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
  • Compatibilidade verificada com o adaptador Meta iOS versão 6.15.2.0
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.0.1

  • Adição de uma classe Dart para permitir a análise de compatibilidade correta com plataformas de hospedagem
  • Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
  • Compatibilidade verificada com o adaptador Meta iOS versão 6.15.0.0
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.0.0

  • Versão inicial.
  • Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
  • Compatibilidade verificada com o adaptador Meta iOS versão 6.15.0.0
  • Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.