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
    • API do Android de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 10.0 ou mais recente
    • O SDK da Meta Audience Network mais recente geralmente requer a versão mais recente do Xcode.
  • Um projeto funcional 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 empresa.

Clique em Começar e em Criar nova 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 das regulamentações estaduais dos EUA e do GDPR 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 Audience Network do Google Mobile Ads para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

OpenUPM

No editor de projetos do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

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

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

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

Registros do Unity

Selecione o pacote Mediação da rede de público-alvo na Meta de anúncios para dispositivos móveis do Google e clique em Instalar.

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 Import.

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 buscar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e 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

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 lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade 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, consulte as opções de processamento de dados do Meta.

Etapa 5: adicionar o código obrigatório

Android

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

iOS

Integração com a 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ê estiver criando para o iOS 14 ou mais recente, consulte as instruções da Meta Audience Network sobre como definir a flag de rastreamento de publicidade.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative o modo de teste na interface da Meta Audience Network.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Meta Audience Network, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Meta Audience Network (Lances).

Etapas opcionais

Como armazenar em cache no Android 9

Android

No Android 9 (nível 28 da API) e versões mais recentes, o suporte a texto não criptografado é 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 publicidade. 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 Audience Network da Meta.
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 do 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 Meta Audience Network retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para saber mais.

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 Audience Network da Meta.
103 Não foi possível 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 Audience Network da Meta retornou um erro específico do SDK. Consulte a documentação do Audience Network do Meta para mais detalhes.

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 para 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.