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.metaaudiencenetworkOpenUPM
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
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
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.
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.
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.
Etapa 4: implementar as configurações de privacidade no SDK da Meta Audience Network
Consentimento da UE e GDPR
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.