Este guia mostra como usar o GMA Next-Gen SDK para carregar e exibir anúncios de display da Moloco com a Mediação da AdMob, incluindo integrações de lances. Ele explica 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 Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da Moloco tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | |
Pré-requisitos
Antes de continuar, verifique o seguinte:
Versão mais recente do GMA Next-Gen SDK.
Etapa 1: definir as configurações na interface da Moloco
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.
Depois que o app for criado, selecione-o na guia Apps para ver os detalhes e anote a chave do app.
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. Depois 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 da Moloco na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Adicione o SDK de anúncio da Moloco Ads à configuração de mediação do seu bloco de anúncios.
Faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar o SDK de anúncio da Moloco Ads como uma origem de anúncios.
Para criar um novo grupo de mediação, selecione Criar grupo de mediação.
Insira o formato e a plataforma do anúncio, depois clique em Continuar.
Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.
O card "Blocos de anúncios" vai aparecer com os blocos selecionados:
Adicionar o SDK de anúncio da Moloco Ads como uma origem de anúncios
Na seção Origens de anúncios, encontre o card Lances e selecione Adicionar origem de anúncios. Em seguida, selecione SDK de anúncio da Moloco.
Clique em Como assinar um contrato de parceria e configure uma parceria de lances com o SDK de anúncio da Moloco Ads.
Clique em Confirmar e concordar e em Continuar.
Se você já tiver um mapeamento para o SDK de anúncio da Moloco, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira a chave do app e o ID do bloco de anúncios vistos na seção anterior. Em seguida, clique em Concluído.
Adicionar a Moloco Ads à lista de parceiros de publicidade das regulamentações estaduais dos EUA e europeias
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 da AdMob.
Etapa 3: importar o SDK e o adaptador da Moloco
Integração com o Android Studio (recomendada)
No arquivo build.gradle.kts do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador da Moloco:
dependencies {
implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
implementation("com.google.ads.mediation:moloco:4.13.0.0")
}
configurations {
all {
exclude(group = "com.google.android.gms", module = "play-services-ads")
exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}
}
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 3.5.0.0 e mais recentes do adaptador do SDK de anúncio da Moloco para Android aceita a transmissão de 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 de anúncio da Moloco.
Para mais informações, consulte a
documentação do MolocoPrivacy.
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 SDK da Moloco inclui a flag isDoNotSell para transmitir informações de consentimento a esse SDK.
O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Moloco. Se você optar por definir essas flags, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.
Kotlin
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
Java
PrivacySettings privacySettings =
new PrivacySettings(
/* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);
Consulte a documentação do SDK da Moloco para Android para mais informações.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
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, verifique o erro
na resposta do anúncio usando
ResponseInfo.getAdSourceResponses()
nas seguintes classes:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Moloco quando um anúncio não é carregado:
| 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. |
Registro de alterações do adaptador de mediação da Moloco para Android
Versão 4.13.0.0
- Compatibilidade verificada com o SDK da Moloco versão 4.13.0.
Criado e testado com:
- Versão 25.5.0 do SDK do Google Mobile Ads.
- Versão 1.5.0 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.13.0 do SDK da Moloco.
Versão 4.12.0.1
- Fixe a dependência do Kotlin do adaptador em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA NextGen).
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.12.0 do SDK da Moloco.
Versão 4.12.0.0
- Compatibilidade verificada com o SDK 4.12.0 da Moloco.
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.12.0 do SDK da Moloco.
Versão 4.11.1.0
- Atualização para informar uma impressão de anúncio quando um anúncio nativo é exibido.
- Correção dos anúncios de banner para chamar o callback
onAdOpenedquando clicados, em vez de mostrados. - Compatibilidade verificada com a versão 4.11.1 do SDK da Moloco.
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.3.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.11.1 do SDK da Moloco.
Versão 4.11.0.0
- Adicionamos suporte a banners adaptativos ao adaptador de mediação da Moloco.
- Compatibilidade verificada com o SDK 4.11.0 da Moloco.
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.3.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.11.0 do SDK da Moloco.
Versão 4.10.1.0
- Compatibilidade verificada com o SDK 4.10.1 da Moloco.
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.10.1 do SDK da Moloco.
Versão 4.10.0.0
- Associa
AgeRestrictedTreatmentàs configurações de restrição de idade da Moloco. - Compatibilidade verificada com o SDK 4.10.0 da Moloco.
Criado e testado com:
- Versão 25.4.0 do SDK do Google Mobile Ads.
- Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.10.0 do SDK da Moloco.
Versão 4.9.0.0
- Compatibilidade verificada com o SDK 4.9.0 da Moloco.
Criado e testado com:
- Versão 25.3.0 do SDK do Google Mobile Ads.
- Versão 1.1.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.9.0 do SDK da Moloco.
Versão 4.9.0.0 (em andamento)
Versão 4.8.1.0
- Compatibilidade verificada com o SDK da Moloco versão 4.8.1.
Criado e testado com:
- Versão 25.2.0 do SDK do Google Mobile Ads.
- Versão 1.0.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.8.1 do SDK da Moloco.
Versão 4.8.0.0
- Atualização para transmitir o contexto do aplicativo para Moloco.initialize() em vez do contexto da atividade para evitar vazamento de memória.
- Compatibilidade verificada com o SDK 4.8.0 da Moloco.
Criado e testado com:
- Versão 25.2.0 do SDK do Google Mobile Ads.
- Versão 0.25.0-beta01 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.8.0 do SDK da Moloco.
Versão 4.7.0.0
- Adicionamos uma propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
- Compatibilidade verificada com o SDK 4.7.0 da Moloco.
Criado e testado com:
- Versão 25.1.0 do SDK do Google Mobile Ads.
- Versão 0.25.0-beta01 do SDK Next-Gen do Google Mobile Ads.
- Versão 4.7.0 do SDK da Moloco.
Versão 4.6.0.0
- Compatibilidade verificada com o SDK 4.6.0 da Moloco.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 4.6.0 do SDK da Moloco.
Versão 4.5.0.0
- Compatibilidade verificada com o SDK 4.5.0 da Moloco.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 4.5.0 do SDK da Moloco.
Versão 4.4.0.0
- Compatibilidade verificada com o SDK 4.4.0 da Moloco.
Criado e testado com:
- Versão 24.9.0 do SDK do Google Mobile Ads.
- Versão 4.4.0 do SDK da Moloco.
Versão 4.3.1.0
- Compatibilidade verificada com o SDK 4.3.1 da Moloco.
Criado e testado com:
- Versão 24.8.0 do SDK do Google Mobile Ads.
- Versão 4.3.1 do SDK da Moloco.
Versão 4.2.1.0
- Compatibilidade verificada com o SDK 4.2.1 da Moloco.
Criado e testado com:
- Versão 24.7.0 do SDK do Google Mobile Ads.
- Versão 4.2.1 do SDK da Moloco.
Versão 4.2.0.0
- Compatibilidade verificada com o SDK 4.2.0 da Moloco.
Criado e testado com:
- Versão 24.7.0 do SDK do Google Mobile Ads.
- Versão 4.2.0 do SDK da Moloco.
Versão 4.1.1.0
- Compatibilidade verificada com o SDK 4.1.1 da Moloco.
Criado e testado com:
- Versão 24.7.0 do SDK do Google Mobile Ads.
- Versão 4.1.1 do SDK da Moloco.
Versão 4.1.0.0
- Compatibilidade verificada com o SDK 4.1.0 da Moloco.
Criado e testado com:
- Versão 24.6.0 do SDK do Google Mobile Ads.
- Versão 4.1.0 do SDK da Moloco.
Versão 4.0.0.0
- Compatibilidade verificada com o SDK 4.0.0 da Moloco.
Criado e testado com:
- Versão 24.5.0 do SDK do Google Mobile Ads.
- Versão 4.0.0 do SDK da Moloco.
Versão 3.12.1.0
- Compatibilidade verificada com o SDK 3.12.1 da Moloco.
Criado e testado com:
- Versão 24.5.0 do SDK do Google Mobile Ads.
- Versão 3.12.1 do SDK da Moloco.
Versão 3.12.0.0
- Compatibilidade verificada com o SDK 3.12.0 da Moloco.
Criado e testado com:
- Versão 24.4.0 do SDK do Google Mobile Ads.
- Versão 3.12.0 do SDK da Moloco.
Versão 3.11.0.0
- Compatibilidade verificada com a versão 3.11.0 do SDK da Moloco.
Criado e testado com:
- Versão 24.4.0 do SDK do Google Mobile Ads.
- Versão 3.11.0 do SDK da Moloco.
Versão 3.10.0.0
- Compatibilidade verificada com a versão 3.10.0 do SDK da Moloco.
Criado e testado com:
- Versão 24.3.0 do SDK do Google Mobile Ads.
- Versão 3.10.0 do SDK da Moloco.
Versão 3.9.0.0
- Compatibilidade verificada com o SDK 3.9.0 da Moloco.
Criado e testado com:
- Versão 24.2.0 do SDK do Google Mobile Ads.
- Versão 3.9.0 do SDK da Moloco.
Versão 3.8.0.1
- Adicionamos suporte ao tamanho de anúncio de banner de retângulo médio.
Criado e testado com:
- Versão 24.1.0 do SDK do Google Mobile Ads.
- Versão 3.8.0 do SDK da Moloco.
Versão 3.8.0.0
- Suporte a lances disponível para o formato de anúncio nativo.
- Compatibilidade verificada com o SDK 3.8.0 da Moloco.
Criado e testado com:
- Versão 24.1.0 do SDK do Google Mobile Ads.
- Versão 3.8.0 do SDK da Moloco.
Versão 3.7.2.0
- Compatibilidade verificada com o SDK 3.7.2 da Moloco.
Criado e testado com:
- Versão 24.0.0 do SDK do Google Mobile Ads.
- Versão 3.7.2 do SDK da Moloco.
Versão 3.7.1.0
- Atualizamos o nível mínimo necessário da API Android para 23.
- Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 24.0.0.
- Compatibilidade verificada com o SDK 3.7.1 da Moloco.
Criado e testado com:
- Versão 24.0.0 do SDK do Google Mobile Ads.
- Versão 3.7.1 do SDK da Moloco.
Versão 3.7.0.0
- Compatibilidade verificada com o SDK 3.7.0 da Moloco.
Criado e testado com:
- Versão 23.6.0 do SDK do Google Mobile Ads.
- Versão 3.7.0 do SDK da Moloco.
Versão 3.6.1.0
- Compatibilidade verificada com o SDK 3.6.1 da Moloco.
Criado e testado com:
- Versão 23.6.0 do SDK do Google Mobile Ads.
- Versão 3.6.1 do SDK da Moloco.
Versão 3.6.0.0
- Compatibilidade verificada com o SDK 3.6.0 da Moloco.
Criado e testado com:
- Versão 23.6.0 do SDK do Google Mobile Ads.
- Versão 3.6.0 do SDK da Moloco.
Versão 3.5.0.0
- Versão inicial.
- Adicionamos suporte a lances para formatos de anúncio de banner, intersticial e premiado.
- Compatibilidade verificada com o SDK 3.5.0 da Moloco.
Criado e testado com:
- Versão 23.6.0 do SDK do Google Mobile Ads.
- Versão 3.5.0 do SDK da Moloco.