Integrar a Moloco à mediação

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 da AdMob, incluindo as 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

Requisitos

  • API Android nível 23 ou mais recente.

  • Adaptador da Moloco 3.8.0.0 ou mais recente.

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Leia todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface da Moloco

Faça login no Portal do editor 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.

Depois que o app for criado, selecione-o na guia Apps para ver os detalhes e anote a chave do app.

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 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 Blocos de anúncios 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 da Moloco Ads à configuração de mediação do seu bloco de anúncios.

Primeiro, 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 da Moloco Ads como uma origem de anúncios.

Para criar um 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. Clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar o SDK da Moloco Ads como uma origem de anúncios

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione SDK da Moloco Ads.

Clique em Como assinar um contrato de parceria e configure uma parceria de lances com o SDK da Moloco Ads.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para o SDK da Moloco Ads, 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

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.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:moloco:3.12.1.0")
}

Etapa 4: implementar configurações de privacidade no SDK da Moloco

Para cumprir a Política de consentimento de usuários da UE do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

O SDK da Moloco inclui a flag isUserConsent 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 SDK dos anúncios para dispositivos móveis do Google.

Kotlin 

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java 

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         true,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           false);
MolocoPrivacy.setPrivacy(privacySettings);

Consulte a documentação do SDK do Moloco para Android para mais informações.

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 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 SDK dos anúncios para dispositivos móveis do Google.

Kotlin 

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java 

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         false,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           true);
MolocoPrivacy.setPrivacy(privacySettings);

Consulte a documentação do SDK do 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 da Moloco Ads, 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.getAdapterResponses() 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.

Verificação do lado do servidor premiada

Se você validar callbacks de verificação do lado do servidor (SSV, na sigla em inglês), o identificador da origem do anúncio para a Moloco será 8267622065755668722.

Registro de alterações do adaptador de mediação da Moloco para Android

Versão 4.0.0.0 (em andamento)

Versão 3.12.1.0

  • Compatibilidade verificada com o SDK da Moloco 3.12.1.

Criado e testado com:

  • Versão 24.5.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.12.1 do SDK da Moloco.

Versão 3.12.0.0

  • Compatibilidade verificada com o SDK da Moloco 3.12.0.

Criado e testado com:

  • Versão 24.4.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.12.0 do SDK da Moloco.

Versão 3.11.0.0

  • Compatibilidade verificada com o SDK da Moloco 3.11.0.

Criado e testado com:

  • Versão 24.4.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.11.0 do SDK da Moloco.

Versão 3.10.0.0

  • Compatibilidade verificada com o SDK da Moloco 3.10.0.

Criado e testado com:

  • Versão 24.3.0 do SDK dos anúncios para dispositivos móveis do Google.
  • 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 dos anúncios para dispositivos móveis do Google.
  • Versão 3.9.0 do SDK da Moloco.

Versão 3.8.0.1

  • Adicionamos suporte ao tamanho de anúncio de banner retangular médio.

Criado e testado com:

  • Versão 24.1.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.8.0 do SDK da Moloco.

Versão 3.8.0.0

  • Adicionamos suporte a lances para o formato de anúncio nativo.
  • Compatibilidade verificada com o SDK da Moloco 3.8.0.

Criado e testado com:

  • Versão 24.1.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.8.0 do SDK da Moloco.

Versão 3.7.2.0

  • Compatibilidade verificada com o SDK da Moloco 3.7.2.

Criado e testado com:

  • Versão 24.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • 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 dos anúncios para dispositivos móveis do Google para 24.0.0.
  • Compatibilidade verificada com o SDK da Moloco 3.7.1.

Criado e testado com:

  • Versão 24.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.7.1 do SDK da Moloco.

Versão 3.7.0.0

  • Compatibilidade verificada com o SDK da Moloco 3.7.0.

Criado e testado com:

  • Versão 23.6.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.7.0 do SDK da Moloco.

Versão 3.6.1.0

  • Compatibilidade verificada com o SDK da Moloco 3.6.1.

Criado e testado com:

  • Versão 23.6.0 do SDK dos anúncios para dispositivos móveis do Google.
  • 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 dos anúncios para dispositivos móveis do Google.
  • 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 da Moloco 3.5.0.

Criado e testado com:

  • Versão 23.6.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Versão 3.5.0 do SDK da Moloco.