Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios de display do SDK de anúncio da Moloco Ads usando a mediação, incluindo as integrações de lances. Ele explica como adicionar o SDK da Moloco Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Moloco Ads a um app Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do Ad Manager para o SDK de anúncio da Moloco tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
Pré-requisitos
Antes de continuar, verifique o seguinte:
- Versão mais recente do Google Mobile Ads Unity Plugin.
- Unity Editor versão 5.6 ou mais recente.
- Plug-in do Unity da Moloco 1.2.0 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 Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
Etapa 1: definir as configurações na interface do SDK do Moloco Ads
Faça login no Portal do editor da Moloco.
Navegue até a guia Overview > Apps e clique no botão Add 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 Create.
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 Overview > Blocos de anúncios, selecione o app no menu suspenso e clique em Novo bloco de anúncios.
Selecione In-app bidding como o Auction method e preencha o restante do formulário. Em seguida, clique em Criar.
Acesse o bloco de anúncios recém-criado na guia Ad Units para ver os detalhes dele. Anote o ID do bloco de anúncios.
Etapa 2: configurar a demanda do SDK de anúncio da Moloco Ads na interface do Ad Manager
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 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 a Moloco Ads à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.
Etapa 3: importar o SDK de anúncio e o adaptador da Moloco Ads
OpenUPM-CLI
Se a CLI do OpenUPM estiver instalada, você poderá instalar o plug-in de mediação do SDK de anúncio da Moloco Ads para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.molocoOpenUPM
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 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 do Google Mobile Ads para o SDK de anúncio do Moloco no link de download do Changelog 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em
Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Forçar resolução. 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: implementar configurações de privacidade no SDK da Moloco
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 versão 1.0.0 e mais recentes do adaptador do SDK do Unity para anúncios da Moloco permitem transmitir indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK do SDK de anúncios da Moloco.
Para mais informações, consulte a
documentação do MolocoPrivacy
para Android e a
string de consentimento da TCF
para 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.
O plug-in de mediação do Unity dos Anúncios para Dispositivos Móveis do Google para o SDK de anúncios da Moloco inclui o método
Moloco.SetDoNotSell(bool) para transmitir informações de consentimento ao
SDK de anúncios da Moloco. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK de anúncio da Moloco Ads. Se você optar por definir essas flags, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Unity Plugin.
using GoogleMobileAds.Api.Mediation.Moloco;
// ...
Moloco.SetDoNotSell(true);
Consulte as instruções de implementação recomendadas do SDK de anúncio da Moloco para Android e iOS para mais detalhes.
Etapa 5: adicionar o código necessário
Não é necessário nenhum código adicional para a integração do SDK da Moloco Ads.
Etapa 6: 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 de anúncio da Moloco, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Moloco (lances).
Códigos de erro
Se o adaptador não receber um anúncio da Moloco, os publishers poderão verificar o erro
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 correspondentes 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 | A chave do app da Moloco está 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 empresa 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 | A chave do app da Moloco está 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 empresa para mais detalhes. |
Registro de alterações do plug-in de mediação da Moloco para Unity
Versão 3.11.0 (em andamento)
Versão 3.10.1
- Compatível com a versão 4.12.0.1 do adaptador da Moloco para Android.
- Compatível com a versão 4.10.0.0 do adaptador da Moloco 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 3.10.0
- Compatível com a versão 4.12.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.10.0.0 do adaptador da Moloco 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 3.9.1
- Compatível com a versão 4.11.1.0 do adaptador do Android da Moloco.
- Compatível com a versão 4.9.1.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 11.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.9.0
- Compatível com a versão 4.11.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.9.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 11.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.8.1
- Compatível com a versão 4.10.1.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.8.1.0 do adaptador da Moloco 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 3.8.0
- Compatível com a versão 4.10.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.8.0.0 do adaptador da Moloco 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 3.7.0
- Compatível com a versão 4.9.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.6.1.1.1 do adaptador da Moloco 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 3.6.1
- Compatível com a versão 4.8.1.0 do adaptador do Android da Moloco.
- Compatível com a versão 4.6.1.1 do adaptador da Moloco para iOS.
- Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.6.0
- Compatível com a versão 4.8.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.6.0.0 do adaptador da Moloco 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 3.5.1
- Compatível com a versão 4.7.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.5.1.0 do adaptador do Moloco 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 3.5.0
- Compatível com a versão 4.7.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.5.0.0 do adaptador da Moloco 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 3.4.1
- Compatível com a versão 4.6.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.4.1.0 do adaptador da Moloco 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 3.4.0
- Compatível com a versão 4.6.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.4.0.0 do adaptador da Moloco 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 3.3.1
- Compatível com a versão 4.5.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.3.0.2 do adaptador da Moloco 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 3.3.0
- Compatível com a versão 4.5.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.3.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.2.0
- Compatível com a versão 4.4.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.2.0.0 do adaptador da Moloco 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 3.1.0
- Compatível com a versão 4.4.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.1.2.0 do adaptador da Moloco 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.
Versão 3.0.0
- Compatível com a versão 4.3.1.0 do adaptador da Moloco para Android.
- Compatível com a versão 4.1.0.0 do adaptador da Moloco 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.
Versão 2.2.1
- Compatível com a versão 4.2.1.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.2.0
- Compatível com a versão 4.2.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.13.0.0 do adaptador da Moloco 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.
Versão 2.1.0
- Compatível com a versão 4.1.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.0.0
- Compatível com a versão 4.0.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.13.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.4.2 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.6.1
- Oferece suporte à versão 3.12.1.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.12.1.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.6.0
- Compatível com a versão 3.12.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.12.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 10.3.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.11.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 3.11.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 10.3.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.10.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.10.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.1
- Compatível com a versão 3.9.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.9.1.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.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.9.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.9.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.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.8.0.1 do adaptador do Android da Moloco.
- Compatível com a versão 3.8.0.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.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.8.0.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.8.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.0
- Oferece suporte à versão 3.7.2.0 do adaptador da Moloco para Android.
- Compatível com a versão 3.7.2.0 do adaptador da Moloco para iOS.
- Criada e testada com a versão 10.0.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.7.0.0 do adaptador Android da Moloco.
- Compatível com a versão 3.6.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 9.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.