Este guia mostra como usar o Google Mobile Ads Unity Plugin para carregar e exibir anúncios da BidMachine com a Mediação da AdMob, incluindo as integrações de lances. Ele explica como adicionar a BidMachine à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da BidMachine a um app Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para BidMachine tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | 1 |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
1 A integração em hierarquia está na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
Pré-requisitos
Antes de continuar, verifique o seguinte:
- Versão mais recente do Google Mobile Ads Unity Plugin.
- Unity Editor versão 2019.4 ou mais recente.
- Para implantar no Android
- API Android nível 24 ou mais recente.
- Para implantar no iOS
- Destino de implantação do iOS 13.0 ou mais recente.
- Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Começar para mais detalhes.
Etapa 1: definir as configurações na interface da BidMachine
Faça login no painel da sua conta da BidMachine.
Criar canais
Navegue até a guia Origem e, na tabela Origens, selecione o botão Editar.
Uma lista com todas as suas posições será mostrada. Para criar uma nova posição, clique no botão Adicionar posição na caixa de diálogo.
Selecione Lances como o Tipo de canal. Preencha o formulário e clique em Salvar.
Android
iOS
Por fim, anote o ID de lugar.
Android
iOS
Atualizar o app-ads.txt
Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt.
Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.
Para implementar o app-ads.txt para a BidMachine, acesse a guia app-ads.txt
no painel. Em seguida, copie a lista e
adicione-a ao arquivo app-ads.txt do seu site.
Etapa 2: configurar a demanda da BidMachine na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
Adicionar a BidMachine à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a BidMachine à 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 BidMachine
OpenUPM-CLI
Se a CLI do OpenUPM estiver instalada, você poderá instalar o plug-in de mediação da BidMachine dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.bidmachineOpenUPM
No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.
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, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads BidMachine Mediation e clique em Install.
Pacote do Unity
Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a BidMachine no link de download do registro de alterações e extraia o GoogleMobileAdsBidMachineMediation.unitypackage do arquivo ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsBidMachineMediation.unitypackage
que você baixou. Verifique se todos os arquivos estão selecionados e clique em
Importar.
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 no diretório Assets/Plugins/Android do seu
app Unity.
Etapa 4: implementar configurações de privacidade no SDK da BidMachine
Consentimento para a UE e o GDPR
Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.
A BidMachine lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento, incluindo o SDK da UMP. Para mais informações, consulte o guia da BidMachine sobre o GDPR para Android e iOS.
Leis Estaduais de Privacidade dos EUA
As leis de privacidade dos estados 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). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento 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, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.
A BidMachine lê automaticamente o consentimento da GPP definido por plataformas de gestão de consentimento, incluindo o SDK da UMP. Para mais informações, consulte o guia da GPP da BidMachine para Android e iOS.
Etapa 5: adicionar o código necessário
Android
Não é necessário nenhum código adicional para a integração da BidMachine.
iOS
Integração da SKAdNetwork
Siga a documentação da BidMachine sobre a
compatibilidade com a SKAdNetwork
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Siga as instruções na documentação da BidMachine para Android e iOS para ativar o modo de teste da BidMachine.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da BidMachine, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios BidMachine (lances).
Códigos de erro
Se o adaptador não receber um anúncio da BidMachine, os publishers poderão verificar
o erro subjacente na resposta do anúncio usando
ResponseInfo nas
seguintes classes:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da BidMachine quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | O ID de lugar recebido é inválido ou está vazio. |
| 101 | com.google.ads.mediation.bidmachine | Erro durante a coleta de indicadores: nenhuma configuração de dados de indicador foi encontrada. |
| 102 | com.google.ads.mediation.bidmachine | O formato do anúncio recebido durante a coleta de indicadores é inválido. |
| 103 | com.google.ads.mediation.bidmachine | Não foi possível mapear o tamanho de anúncio solicitado para bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | A solicitação de anúncio da BidMachine carregada expirou. |
| 105 | com.google.ads.mediation.bidmachine | Não foi possível mostrar o anúncio em tela cheia. |
| 106 | com.google.ads.mediation.bidmachine | O SDK da BidMachine retornou um callback onAdLoaded() com dados de anúncio null. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.mediation.bidmachine | A configuração do servidor não tem um ID de publisher obrigatório. |
| 102 | com.google.mediation.bidmachine | A solicitação de coleta de indicadores de lances falhou porque os parâmetros de RTB não contêm o formato do anúncio ou o formato especificado não é compatível. |
| 103 | com.google.mediation.bidmachine | Configuração inválida para carregar um anúncio. |
| 104 | com.google.mediation.bidmachine | O SDK da BidMachine retornou um anúncio que não é de banner para o método delegado BidMachineAdProtocol didLoadAd do anúncio de banner. Isso nunca deve acontecer. |
| 105 | com.google.mediation.bidmachine | O anúncio de tela cheia não está pronto para ser exibido. |
| 106 | com.google.mediation.bidmachine | O SDK da Bid Machine retornou um anúncio não nativo para o método delegado BidMachineAdProtocol didLoadAd do anúncio nativo. Isso nunca deve acontecer. |
| 107 | com.google.mediation.bidmachine | Falha ao carregar uma das origens de imagem do anúncio nativo. |
| 108 | com.google.mediation.bidmachine | A BidMachine não é compatível com esse tamanho de anúncio de banner. |
Registro de alterações do plug-in de mediação da BidMachine para Unity
Versão 1.5.2
- Compatível com a versão 3.8.0.1 do adaptador da BidMachine para Android.
- Compatível com a versão 3.8.1.0 do adaptador do BidMachine para iOS.
- Criada e testada com a versão 11.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.1
- Compatível com a versão 3.8.0.1 do adaptador da BidMachine para Android.
- Compatível com a versão 3.8.0.0 do adaptador da BidMachine para iOS.
- Criada e testada com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.0
- Compatível com a versão 3.8.0.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.8.0.0 do adaptador da BidMachine para iOS.
- Criada e testada com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.4.2
- Compatível com a versão 3.7.1.1 do adaptador da BidMachine para Android.
- Compatível com a versão 3.7.1.0.1 do adaptador da BidMachine para iOS.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.4.1
- Compatível com a versão 3.7.0.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.7.1.0 do adaptador da BidMachine para iOS.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.4.0
- Compatível com a versão 3.7.0.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.7.0.0 do adaptador da BidMachine para iOS.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.0
- Compatível com a versão 3.7.0.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.6.1.1 do adaptador do BidMachine para iOS.
- Criada e testada com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.1
- Compatível com a versão 3.6.1.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.6.1.0 do adaptador da BidMachine para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.0
- Compatível com a versão 3.6.1.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.6.0.0 do adaptador do BidMachine para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.0
- Compatível com a versão 3.5.1.2 do adaptador da BidMachine para Android.
- Compatível com a versão 3.6.0.0 do adaptador do BidMachine para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.0.2
- Compatível com a versão 3.5.1.2 do adaptador da BidMachine para Android.
- Compatível com a versão 3.5.1.2 do adaptador do BidMachine para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.0.1
- Compatível com a versão 3.5.1.1 do adaptador da BidMachine para Android.
- Compatível com a versão 3.5.1.0 do adaptador do BidMachine para iOS.
- Criada e testada com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.0.0
- Versão inicial!
- Compatível com a versão 3.5.1.0 do adaptador da BidMachine para Android.
- Compatível com a versão 3.5.1.0 do adaptador do BidMachine para iOS.
- Criada e testada com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.