Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da Moloco usando 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 Flutter.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para Moloco tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | |
Requisitos
- Mais recente Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 ou mais recente
- Para implantação no Android
- Nível 23 ou mais recente da API Android
- Para implantação no iOS
- Destino de implantação do iOS 13.0 ou mais recente
- Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter 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 método de leilão 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 do guia para Android.
iOS
Para instruções, consulte a etapa 2 do 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
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Moloco Ads no arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_moloco: ^3.3.0
Integração manual
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,
extraia o arquivo baixado e adicione a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
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 de anúncios para a Moloco será 8267622065755668722.
Registro de alterações do adaptador de mediação da Moloco para o Flutter
Versão 3.4.0 (em andamento)
Versão 3.3.0
- Oferece suporte à versão 4.5.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 4.3.0.2 do adaptador da Moloco para iOS .
- Criado e testado com a versão 7.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 3.2.0
- Oferece suporte à versão 4.4.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 4.2.0.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 7.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 3.1.0
- Atualizou a versão mínima do Flutter para 3.35.1
- Oferece suporte à versão 4.4.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 4.1.2.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 7.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 3.0.0
- Oferece suporte à versão 4.3.1.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 4.1.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 2.1.0
- Oferece suporte à versão 4.2.0.0 do adaptador da Moloco para Android.
- Oferece suporte à versão 3.13.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 2.0.0
- Oferece suporte à versão 4.0.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.13.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.6.0
- Oferece suporte à versão 3.12.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.12.0.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.5.0
- Oferece suporte à versão 3.11.0.0 do adaptador da Moloco para Android.
- Oferece suporte à versão 3.11.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.4.0
- Oferece suporte à versão 3.10.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.10.0.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.3.1
- Oferece suporte à versão 3.9.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.9.1.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.3.0
- Oferece suporte à versão 3.9.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.9.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.2.0
- Oferece suporte à versão 3.8.0.1 do adaptador da Moloco para Android.
- Oferece suporte à versão 3.8.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 6.0.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.1.0
- Oferece suporte à versão 3.7.0.0 do adaptador da Moloco para Android .
- Oferece suporte à versão 3.6.0.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 5.3.1 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.
Versão 1.0.0
- Versão inicial.
- Oferece suporte à versão 3.6.1.0 do adaptador da Moloco para Android.
- Oferece suporte à versão 3.6.0.0 do adaptador da Moloco para iOS .
- Criado e testado com a versão 5.3.1 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Flutter.