Neste guia, mostramos 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, e abrangendo 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 AdMob adaptador de mediação da Meta Audience Network tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cachoeira 1 | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado |
1 A Meta Audience Network passou a definir lances apenas em 2021.
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Unity 5.6 ou mais recente
- Plug-in de mediação de anúncios para dispositivos móveis do Google para a Meta Audience Network 2.11.0 (última versão recomendada)
- Para implantar no Android
- Android API de nível 21 ou mais recente
- Para implantar no iOS:
- Meta de implantação do iOS 10.0 ou mais recente
- O SDK mais recente da Meta Audience Network geralmente exige a versão mais recente do Xcode.
- Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia de iniciação de mediação
Etapa 1: definir as configurações na interface da Meta Audience Network
Inscreva-se e faça login na página inicial do Business Manager.
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ê precisará criar uma propriedade para o app. Insira 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.
Android
iOS
Configure sua conta para pagamentos clicando em Adicionar uma nova conta para pagamentos. Você será redirecionado para 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 posição.
Selecione um formato, preencha o formulário e clique em Criar.
Anote o ID da posição.
Clique em Concluído.
Ativar modo de teste
Consulte o guia de implementação da Audience Network para testes para ver instruções detalhadas sobre como ativar os anúncios de teste da Meta Audience Network.
Etapa 2: configurar a demanda da Meta Audience Network na AdMob 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 Facebook à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Facebook à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.
Etapa 3: importar o SDK e o adaptador da Audience Network da Meta
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 usando o link de download no
Registro de mudanças e extraia o
GoogleMobileAdsFacebookMediation.unitypackage
do arquivo ZIP.
No editor de projetos do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo GoogleMobileAdsFacebookMediation.unitypackage
que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em
Import.
Selecione Assets > Play Services Resolver > Android Resolver > Force Resolve.
Em seguida, a biblioteca do resolvedor do Play Services do Unity executa a resolução de dependências
do zero e copia 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 o GDPR
De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.
Leia as orientações da Meta (em inglês) para informações sobre o GDPR e a publicidade na 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 definição desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 da Meta.
Etapa 5: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração com a Meta Audience Network.
iOS
Integração da SKAdNetwork
Siga a documentação da Meta Audience Network
para adicionar os identificadores SKAdNetwork ao arquivo Info.plist
do seu projeto.
Acompanhamento de publicidade ativado
Se você estiver criando para o iOS 14 ou versões mais recentes, consulte as instruções da Meta Audience Network sobre como definir a sinalização de acompanhamento de publicidade.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em AdMob e ative o modo de teste na Meta Audience Network interface.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Meta Audience Network, ative os testes de uma única origem no Ad Inspector usando as Meta Audience Network (Bidding) origens de anúncios.
Etapas opcionais
Armazenamento 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 será desativado por padrão, o que vai afetar a funcionalidade de armazenamento em cache de mídia do SDK da rede do público-alvo da Meta e pode afetar a experiência do usuário e a receita de anúncios. Siga a documentação da Meta (link em inglês) para atualizar a configuração de segurança de rede no seu app.
iOS
Não aplicável 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 associadas gerados pelo adaptador da Audience Network da Meta quando um anúncio não é carregado:
Android
Código do erro | Motivo |
---|---|
101 | Parâmetros de servidor inválidos (por exemplo, código 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 | Falha ao inicializar o SDK do Audience Network da Meta. |
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 necessários. |
109 | Falha ao criar um anúncio nativo a partir do payload do lance. |
110 | O SDK do Audience Network da Meta não apresentou 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 da Meta Audience Network para mais detalhes. |
iOS
Código do erro | Motivo |
---|---|
101 | Parâmetros de servidor inválidos (por exemplo, código 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 apresentou o anúncio intersticial/premiado. |
105 | O controlador de visualização raiz do anúncio de banner é nil . |
106 | Falha ao inicializar o SDK do Audience Network da Meta. |
1000-9999 | A Audience Network da Meta retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para mais detalhes. |
Registros de alterações do plug-in de mediação do Unity na Meta Audience Network
Versão 3.12.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.17.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.15.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 3.11.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.15.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.14.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.1.
Versão 3.10.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Compatível com o adaptador Android da Meta Audience Network versão 6.14.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.12.0.1.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.
Versão 3.9.1
- Compatível com a versão 6.12.0.0 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.12.0.1.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.
Versão 3.9.0
- Compatível com a versão 6.12.0.0 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.12.0.0.
- Criada e testada com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.0.
Versão 3.8.0
- O nome do plug-in de mediação do Unity foi renomeado como "Meta Audience Network".
- Compatível com a versão 6.11.0.1 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.11.1.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.
Versão 3.7.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.10.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.10.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 3.6.1
- Compatível com o adaptador Android da Meta Audience Network versão 6.8.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.9.0.1.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 3.6.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.8.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.8.0.0.
Versão 3.5.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.7.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.7.0.0.
Versão 3.4.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.6.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.6.0.0.
Versão 3.3.2
- Compatível com o adaptador Android da Meta Audience Network versão 6.5.1.1 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.5.1.0 (link em inglês).
Versão 3.3.1
- Compatível com o adaptador Android da Meta Audience Network versão 6.5.1.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.5.1.0 (link em inglês).
Versão 3.3.0
- Compatível com a versão 6.4.0.0 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.4.1.0.
Versão 3.2.0
- Compatível com a versão 6.2.0.1 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.2.1.0.
Versão 3.1.0
- Compatível com a versão 6.2.0.0 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 6.2.0.0.
Versão 3.0.0
- Compatível com o adaptador Android da Meta Audience Network versão 6.1.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 6.0.0.0.
Versão 2.12.0
- Compatível com o adaptador Android da Meta Audience Network versão 5.11.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.10.1.0.
Versão 2.11.1
- Compatível com o adaptador Android da Meta Audience Network versão 5.10.1.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.10.1.0.
Versão 2.11.0
- Compatível com o adaptador Android da Meta Audience Network versão 5.10.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.10.0.0.
Versão 2.10.0
- Compatível com o adaptador Android da Meta Audience Network versão 5.9.1.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.9.0.1.
Versão 2.9.2
- Compatível com o adaptador Android da Meta Audience Network versão 5.9.0.2 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.9.0.1.
Versão 2.9.1
- Compatível com a versão 5.9.0.1 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 5.9.0.1.
Versão 2.9.0
- Compatível com o adaptador Android da Meta Audience Network versão 5.9.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.9.0.0.
Versão 2.8.1
- Compatível com o adaptador Android da Meta Audience Network versão 5.8.0.1 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.8.0.2.
Versão 2.8.0
- Compatível com o adaptador Android da Meta Audience Network versão 5.8.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.8.0.1.
Versão 2.7.1 (obsoleta, use 2.8.0 ou mais recente)
- Compatível com o adaptador Android da Meta Audience Network versão 5.7.1.0.
- Compatível com o adaptador iOS da Meta Audience Network versão 5.7.1.1.
Versão 2.7.0 (obsoleta, use 2.8.0 ou mais recente)
- Compatível com o adaptador Android da Meta Audience Network versão 5.7.0.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.7.0.0.
Versão 2.6.1 (obsoleta, use 2.8.0 ou mais recente)
- Compatível com o adaptador Android da Meta Audience Network versão 5.6.1.0 (link em inglês).
- Compatível com o adaptador iOS da Meta Audience Network versão 5.6.1.0.
Versão 2.6.0
- Compatível com a versão 5.6.0.0 do adaptador para Android da Meta Audience Network.
- Compatível com o adaptador iOS da Meta Audience Network versão 5.6.0.0.
Versão 2.5.1
- Compatível com o adaptador para Android do Facebook versão 5.5.0.0.
- Compatível com o adaptador do Facebook para iOS versão 5.5.1.0.
Versão 2.5.0
- Compatível com o adaptador para Android do Facebook versão 5.5.0.0.
- Compatível com o adaptador do Facebook para iOS versão 5.5.0.0.
Versão 2.4.1
- Compatível com o adaptador para Android do Facebook versão 5.4.1.1.
- Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.
Versão 2.4.0
- Compatível com o adaptador para Android do Facebook versão 5.4.0.0.
- Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.
Versão 2.3.2
- Compatível com o adaptador para Android do Facebook versão 5.3.1.2.
- Compatível com o adaptador para iOS do Facebook versão 5.3.2.0.
Versão 2.3.1
- Compatível com o adaptador para Android do Facebook versão 5.3.1.0.
- Compatível com o adaptador para iOS do Facebook versão 5.3.2.0.
Versão 2.3.0
- Compatível com o adaptador para Android do Facebook versão 5.3.0.0.
- Compatível com o adaptador do Facebook para iOS versão 5.3.0.0.
Versão 2.2.0
- Atualização do plug-in para oferecer suporte à nova API Premiada em versão Beta aberta.
- Compatível com o adaptador para Android do Facebook versão 5.2.0.1.
- Compatível com o adaptador do Facebook para iOS versão 5.2.0.1.
Versão 2.1.1
- Compatível com o adaptador para Android do Facebook versão 5.1.0.1.
- Compatível com o adaptador do Facebook para iOS versão 5.1.0.0.
Versão 2.1.0
- Compatível com o adaptador para Android do Facebook versão 5.1.0.0.
- Compatível com o adaptador do Facebook para iOS versão 5.1.0.0.
Versão 2.0.0
- Compatível com o adaptador para Android do Facebook versão 5.0.1.0.
- Compatível com o adaptador do Facebook para iOS versão 5.0.1.0.
Versão 1.2.1
- Compatível com o adaptador para Android do Facebook versão 4.99.3.0.
- Compatível com o adaptador do Facebook para iOS versão 4.99.3.0.
Versão 1.2.0
- Compatível com o adaptador para Android do Facebook versão 4.99.1.1.
- Compatível com o adaptador do Facebook para iOS versão 4.99.2.0.
Versão 1.1.3
- Compatível com o adaptador para Android do Facebook versão 4.28.2.1.
- Compatível com o adaptador do Facebook para iOS versão 4.28.1.2.
Versão 1.1.2
- Correção de um possível conflito com o plug-in de mediação do Unity Ads para Unity
Versão 1.1.1
- Compatível com o adaptador do Facebook para Android versão 4.28.2.0.
- Compatível com o adaptador do Facebook para iOS versão 4.28.1.1.
Versão 1.1.0
- Compatível com o SDK do Facebook para Android versão 4.28.1.
- Compatível com o SDK do Facebook para iOS versão 4.28.1.
Versão 1.0.0
- Primeira versão!
- Compatível com o SDK do Facebook para Android versão 4.27.0.
- Compatível com o SDK do Facebook para iOS versão 4.27.1.