Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Moloco usando a mediação, incluindo integrações de lances. Ele aborda como adicionar a Moloco à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Moloco a um app Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do Ad Manager para a Moloco tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Unity 5.6 ou mais recente
- Plug-in do Unity da Moloco 1.2.0 ou mais recente
- Para fazer a implantação no Android,
- API do Android de nível 23 ou mais recente
- Para fazer a implantação no iOS:
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Conclua o guia de primeiros passos da mediação.
Etapa 1: configurar as configurações na interface da Moloco
Faça login no portal de editores da Moloco.
Navegue até a guia Visão geral > Apps e clique no botão Adicionar app para criar um novo app.
Selecione o SO e as Configurações de privacidade do app, preencha o restante do formulário e clique em Criar.
Android
iOS
Depois que o app for criado, selecione-o na guia Apps para ver os detalhes e anote a chave do app.
Android
iOS
Acesse a guia Visão geral > Blocos de anúncios, selecione o app no menu suspenso e clique em Novo bloco de anúncios.
Selecione Lances no app como o Método de leilão e preencha o restante do formulário. Em seguida, clique em Criar.
Acesse o bloco de anúncios recém-criado na guia Blocos de anúncios para conferir os detalhes dele. Anote o ID do bloco de anúncios.
Etapa 2: configurar a demanda da Moloco na interface do Ad Manager
Configurar 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 Moloco Ads à 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 os Anúncios da Moloco à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.
Etapa 3: importar o SDK e o adaptador da Moloco
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação do SDK de anúncios da Moloco para Unity:
openupm add com.google.ads.mobile.mediation.molocoOpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.
Na guia Registros com escopo, 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 Mediação do Google Mobile Ads Moloco 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 o SDK de anúncios da Moloco no link de download do Registro de alterações e extraia o GoogleMobileAdsMolocoMediation.unitypackage do arquivo ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsMolocoMediation.unitypackage
que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager
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: adicionar o código necessário
Nenhum código adicional é necessário para a integração com a Moloco.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste no Ad Manager.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do SDK da Moloco Ads, ative o teste de uma única origem de anúncios no Ad inspector usando as origens de anúncios Moloco (Bidding).
Códigos de erro
Se o adaptador não receber um anúncio da Moloco, os editores poderão verificar o erro
subjacente na resposta do anúncio usando
ResponseInfo nas seguintes classes:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Confira os códigos e as mensagens acompanhantes gerados pelo adaptador da Moloco quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Chave de app da Moloco ausente ou inválida. |
| 102 | com.google.ads.mediation.moloco | O ID do bloco de anúncios da Moloco está ausente ou é inválido. |
| 103 | com.google.ads.mediation.moloco | O objeto de anúncio da Moloco retornado era nulo. |
| -1 a 5000 | com.moloco.sdk | O SDK da Moloco retornou um erro. Consulte a documentação da Moloco para mais detalhes. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | O SDK da Moloco não oferece suporte à veiculação de anúncios no iOS 12 e em versões anteriores. |
| 102 | com.google.ads.mediation.moloco | Chave de app da Moloco ausente ou inválida. |
| 103 | com.google.ads.mediation.moloco | O ID do bloco de anúncios da Moloco está ausente ou é inválido. |
| 104 | com.google.ads.mediation.moloco | O anúncio não está pronto para ser exibido. |
| 105 | com.google.ads.mediation.moloco | O anúncio não foi exibido. |
| 106 | com.google.ads.mediation.moloco | Os dados de renderização não estão disponíveis para renderizar o anúncio. |
| -1 a 5000 | Enviado pelo SDK da Moloco. | O SDK da Moloco retornou um erro. Consulte a documentação da Moloco para mais detalhes. |
Verificação do lado do servidor premiada
Se você
Validar callbacks de verificação do lado do servidor (SSV),
o identificador da origem do anúncio para a Moloco será 8267622065755668722.
Registro de alterações do plug-in de mediação do Unity da Moloco
Versão 1.5.0
- Compatível com a versão 3.11.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.11.0.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.3.0.
Versão 1.4.0
- Compatível com a versão 3.10.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.10.0.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.2.0.
Versão 1.3.1
- Compatível com a versão 3.9.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.9.1.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.
Versão 1.3.0
- Compatível com a versão 3.9.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.9.0.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.
Versão 1.2.1
- Compatível com a versão 3.8.0.1 do adaptador do Android da Moloco.
- Compatível com a versão 3.8.0.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.
Versão 1.2.0
- Compatível com a versão 3.8.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.8.0.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.
Versão 1.1.0
- Compatível com a versão 3.7.2.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.7.2.0 do adaptador do iOS da Moloco.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.
Versão 1.0.0
- Versão inicial!
- Compatível com a versão 3.7.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.6.0.0 do adaptador do Moloco para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.6.0.