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 Unity.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação da AdMob para o 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
- Unity 5.6 ou mais recente
- Plug-in de mediação de anúncios para dispositivos móveis do Google para a Audience Network da Meta 2.11.0 (recomendamos a versão 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 mais recente da Audience Network da Meta geralmente requer a versão mais recente do Xcode.
- Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Conclua o Guia de introdução à mediação.
Etapa 1: configurar as configurações na interface da Meta Audience Network
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 receber uma solicitação para criar uma propriedade para o app. Digite o nome desejado da propriedade para o app e clique em Próxima.
Em seguida, selecione a plataforma para gerar receita.
Adicione os detalhes do app e clique em Próxima.
![](https://developers.google.cn/static/admob/images/mediation/facebook/app_details_Android.png?authuser=0000&hl=pt-br)
![](https://developers.google.cn/static/admob/images/mediation/facebook/app_details_iOS.png?authuser=0000&hl=pt-br)
Clique em Adicionar uma nova conta de pagamento para configurar sua conta de pagamento. Você vai ser redirecionado para uma nova página para inserir as 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 de teste de implementação do Audience Network para conferir instruções detalhadas sobre como ativar anúncios de teste do Audience Network da Meta.
Etapa 2: configurar a demanda da Audience Network da Meta na interface da AdMob
Configurar as configurações de mediação para seu bloco de anúncios
Para instruções, consulte a etapa 2 no guia para Android.
Para ver as instruções, consulte a etapa 2 no guia para iOS.
Adicionar a Meta à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA
Siga as etapas em Configurações de regulamentações europeias e Configurações de regulamentações estaduais dos EUA para adicionar a Meta à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.
Etapa 3: importar o SDK e o adaptador da Meta Audience Network
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da Meta Audience Network para anúncios do Google Mobile em seu projeto executando o comando abaixo no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
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
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads Meta Audience Network Mediation e clique em Install.
Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para a
Meta Audience Network no 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 do Gerenciador de dependências externas
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas para o 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 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 sua 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 necessário
Nenhum código adicional é necessário para a integração com a Audience Network da Meta.
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ê 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
Armazenamento em cache no Android 9
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.
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:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
GADMAdapterFacebook
GADMediationAdapterFacebook
Confira os códigos e as mensagens que acompanham o adaptador da Audience Network da Meta quando um anúncio não é carregado:
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 | Os recursos de anúncios nativos necessários não estão presentes no anúncio carregado. |
109 | Não foi possível criar um anúncio nativo com o payload do 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 do Audience Network do Meta para mais detalhes. |
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 visualização 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 do Audience Network do Meta para mais detalhes. |
Registro de alterações do plug-in de mediação da Audience Network da Meta para Unity
Versão 3.14.0
- Suporte à versão 6.18.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.16.0.0 do adaptador do iOS para a Audience Network da Meta.
- Criado e testado com a versão 9.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.13.1
- Suporte à versão 6.18.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.15.2.1 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 9.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.13.0
- Suporte à versão 6.18.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.15.2.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.12.2
- Suporte à versão 6.17.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.15.2.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.12.1
- Suporte à versão 6.17.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.15.1.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.12.0
- Suporte à versão 6.17.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.15.0.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.11.0
- Suporte à versão 6.15.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 6.14.0.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 8.5.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.10.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Suporte à versão 6.14.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte para a versão 6.12.0.1 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 8.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.9.1
- Suporte à versão 6.12.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte para a versão 6.12.0.1 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 7.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.9.0
- Suporte à versão 6.12.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.12.0.0 do adaptador do iOS para a Audience Network da Meta.
- Criado e testado com a versão 7.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.8.0
- O nome do plug-in de mediação do Unity foi renomeado para "Audience Network da Meta".
- Suporte à versão 6.11.0.1 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.11.1.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 7.0.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.7.0
- Suporte à versão 6.10.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte para a versão 6.10.0.0 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.6.1
- Suporte à versão 6.8.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.9.0.1 do adaptador do iOS da Audience Network da Meta.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.6.0
- Suporte à versão 6.8.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte ao adaptador iOS da Audience Network da Meta versão 6.8.0.0.
Versão 3.5.0
- Suporte à versão 6.7.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.7.0.0 do adaptador do iOS da Audience Network da Meta.
Versão 3.4.0
- Suporte à versão 6.6.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 6.6.0.0 do adaptador do iOS da Audience Network da Meta.
Versão 3.3.2
- Suporte à versão 6.5.1.1 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.5.1.0 do adaptador do iOS para a Audience Network da Meta.
Versão 3.3.1
- Suporte à versão 6.5.1.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.5.1.0 do adaptador do iOS para a Audience Network da Meta.
Versão 3.3.0
- Suporte à versão 6.4.0.0 do adaptador do Audience Network da Meta para Android.
- Suporte à versão 6.4.1.0 do adaptador do iOS da Audience Network da Meta.
Versão 3.2.0
- Suporte à versão 6.2.0.1 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 6.2.1.0 do adaptador do iOS da Audience Network da Meta.
Versão 3.1.0
- Suporte à versão 6.2.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte ao adaptador iOS da Audience Network da Meta versão 6.2.0.0.
Versão 3.0.0
- Suporte à versão 6.1.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 6.0.0.0 do adaptador do iOS da Audience Network da Meta.
Versão 2.12.0
- Suporte à versão 5.11.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.10.1.0 do adaptador do iOS da Audience Network da Meta.
Versão 2.11.1
- Suporte à versão 5.10.1.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 5.10.1.0 do adaptador do iOS da Audience Network da Meta.
Versão 2.11.0
- Suporte à versão 5.10.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte ao adaptador iOS da Audience Network da Meta, versão 5.10.0.0.
Versão 2.10.0
- Suporte à versão 5.9.1.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.9.0.1 do adaptador do iOS da Audience Network da Meta.
Versão 2.9.2
- Compatível com a versão 5.9.0.2 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.9.0.1 do adaptador do iOS da Audience Network da Meta.
Versão 2.9.1
- Suporte à versão 5.9.0.1 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.9.0.1 do adaptador do iOS da Audience Network da Meta.
Versão 2.9.0
- Suporte à versão 5.9.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.9.0.0 do adaptador do iOS da Audience Network da Meta.
Versão 2.8.1
- Suporte à versão 5.8.0.1 do adaptador do Android para o Audience Network da Meta.
- Suporte para a versão 5.8.0.2 do adaptador do iOS para a Audience Network da Meta.
Versão 2.8.0
- Suporte à versão 5.8.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 5.8.0.1 do adaptador do iOS para o Audience Network da Meta.
Versão 2.7.1 (descontinuada, use a 2.8.0 ou mais recente)
- Suporte à versão 5.7.1.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.7.1.1 do adaptador do iOS da Audience Network da Meta.
Versão 2.7.0 (descontinuada, use a 2.8.0 ou mais recente)
- Suporte à versão 5.7.0.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.7.0.0 do adaptador do iOS para a Audience Network da Meta.
Versão 2.6.1 (descontinuada, use a 2.8.0 ou mais recente)
- Suporte à versão 5.6.1.0 do adaptador do Android para a Audience Network da Meta.
- Suporte à versão 5.6.1.0 do adaptador do iOS para a Audience Network da Meta.
Versão 2.6.0
- Suporte à versão 5.6.0.0 do adaptador do Android para o Audience Network da Meta.
- Suporte à versão 5.6.0.0 do adaptador do iOS da Audience Network da Meta.
Versão 2.5.1
- Compatível com a versão 5.5.0.0 do adaptador do Facebook para Android.
- Compatível com a versão 5.5.1.0 do adaptador do Facebook para iOS.
Versão 2.5.0
- Compatível com a versão 5.5.0.0 do adaptador do Facebook para Android.
- Compatível com a versão 5.5.0.0 do adaptador do Facebook para iOS.
Versão 2.4.1
- Suporte ao adaptador do Facebook para Android versão 5.4.1.1.
- Suporte ao adaptador do Facebook para iOS versão 5.4.0.0.
Versão 2.4.0
- Suporte ao adaptador do Facebook para Android versão 5.4.0.0.
- Suporte ao adaptador do Facebook para iOS versão 5.4.0.0.
Versão 2.3.2
- Compatível com a versão 5.3.1.2 do adaptador do Facebook para Android.
- Suporte à versão 5.3.2.0 do adaptador do Facebook para iOS.
Versão 2.3.1
- Compatível com a versão 5.3.1.0 do adaptador do Facebook para Android.
- Suporte à versão 5.3.2.0 do adaptador do Facebook para iOS.
Versão 2.3.0
- Suporte ao adaptador do Facebook para Android versão 5.3.0.0.
- Suporte ao adaptador do Facebook para iOS versão 5.3.0.0.
Versão 2.2.0
- O plug-in foi atualizado para oferecer suporte à nova API Rewarded Beta aberta.
- Suporte ao adaptador do Facebook para Android versão 5.2.0.1.
- Compatível com a versão 5.2.0.1 do adaptador do Facebook para iOS.
Versão 2.1.1
- Compatível com a versão 5.1.0.1 do adaptador do Facebook para Android.
- Suporte ao adaptador do Facebook para iOS versão 5.1.0.0.
Versão 2.1.0
- Compatível com a versão 5.1.0.0 do adaptador do Facebook para Android.
- Suporte ao adaptador do Facebook para iOS versão 5.1.0.0.
Versão 2.0.0
- Compatível com a versão 5.0.1.0 do adaptador do Facebook para Android.
- Suporte ao adaptador do Facebook para iOS versão 5.0.1.0.
Versão 1.2.1
- Compatível com a versão 4.99.3.0 do adaptador do Facebook para Android.
- Compatível com a versão 4.99.3.0 do adaptador do Facebook para iOS.
Versão 1.2.0
- Suporte à versão 4.99.1.1 do adaptador do Facebook para Android.
- Compatível com a versão 4.99.2.0 do adaptador do Facebook para iOS.
Versão 1.1.3
- Suporte ao adaptador do Facebook para Android versão 4.28.2.1.
- Suporte ao adaptador do Facebook para iOS versão 4.28.1.2.
Versão 1.1.2
- Foi corrigido um possível conflito com o plug-in de mediação do Unity Ads para Unity.
Versão 1.1.1
- Compatível com a versão 4.28.2.0 do adaptador do Facebook para Android.
- Compatível com a versão 4.28.1.1 do adaptador do Facebook para iOS.
Versão 1.1.0
- Suporte ao SDK do Facebook para Android versão 4.28.1.
- Suporte ao SDK do Facebook para iOS versão 4.28.1.
Versão 1.0.0
- Primeira versão!
- Suporte ao SDK do Facebook para Android versão 4.27.0.
- Suporte ao SDK do Facebook para iOS versão 4.27.1.