Integrar a Moloco à mediação

Selecione a plataforma: Android (Beta) Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da Moloco usando a mediação, 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 Unity.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para Moloco tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado

Requisitos

  • Mais recente Google Mobile Ads Unity Plugin
  • Unity 5.6 ou mais recente
  • Plug-in da Moloco para Unity 1.2.0 ou mais recente
  • Para implantação no Android
    • API Android nível 23 ou mais recente
  • Para implantação 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 Google Mobile Ads Unity Plugin para mais detalhes.
  • Configurar a 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 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 > Ad Units, selecione o app no menu suspenso e clique em New Ad Unit.

Selecione In-app bidding como o Auction method e preencha o restante do formulário. Em seguida, clique em Create.

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 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 o 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 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 e o adaptador da Moloco

OpenUPM-CLI

Se você tiver OpenUPM-CLI instalado, poderá instalar o Plug-in de mediação do SDK da Moloco Ads 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.moloco

OpenUPM

No editor de projetos do Unity, selecione Edit > Project Settings > 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

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o gerenciador de pacotes do Unity e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Moloco Mediation e clique em Install.

Instalar pelo OpenUPM

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 da Moloco Ads no link de download em o registro de alterações e extraia o GoogleMobileAdsMolocoMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e encontre o GoogleMobileAdsMolocoMediation.unitypackage arquivo que você baixou. Verifique se todos os arquivos estão selecionados e clique Import.

Importar do Unity

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.

Forçar resolução

Etapa 4: adicionar o código necessário

Nenhum código adicional é necessário para a integração da Moloco.

Etapa 5: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste para 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 Moloco (lances) origens de anúncios.

Códigos de erro

Se o adaptador não receber um anúncio da Moloco, os editores 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.

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 Plug-in de mediação da Moloco para Unity

Versão 3.3.1 (em andamento)

Versão 3.3.0

Versão 3.2.0

Versão 3.1.0

Versão 3.0.0

Versão 2.2.1

Versão 2.2.0

Versão 2.1.0

Versão 2.0.0

Versão 1.6.1

Versão 1.6.0

Versão 1.5.0

Versão 1.4.0

Versão 1.3.1

Versão 1.3.0

Versão 1.2.1

Versão 1.2.0

Versão 1.1.0

Versão 1.0.0