Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios do SDK 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 Flutter.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para o SDK de anúncios 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:
- A versão mais recente do Google Mobile Ads Flutter Plugin.
- Flutter framework versão 3.7.0 ou mais recente.
- Para implantar no Android
- Nível da API Android 23 ou mais recente.
- Para implantar 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 da AdMob.
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 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.
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 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 do SDK do Moloco Ads na interface da AdMob
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 da AdMob.
Etapa 3: importar o SDK e o adaptador da Moloco Ads
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do
SDK e do adaptador do Moloco Ads no arquivo
pubspec.yaml do pacote:
dependencies:
gma_mediation_moloco: ^3.7.0
Integração manual
Baixe a 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 do SDK da Moloco Ads.
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, 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. |
Registro de alterações do adaptador de mediação da Moloco para Flutter
Versão 3.7.0
- Compatível com a versão 4.12.0.0 do adaptador Android da Moloco.
- Compatível com a versão 4.10.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.6.1
- Atualização para oferecer suporte à versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
- Adição de suporte ao Gerenciador de pacotes do Swift.
- Compatível com a versão 4.11.1.0 do adaptador do Android da Moloco.
- Compatível com a versão 4.9.0.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.6.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.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.5.1
- Compatível com a versão 4.10.1.0 do adaptador Android da Moloco.
- Compatível com a versão 4.8.1.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.5.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.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.4.0
- Atualização da versão mínima do Flutter para 3.38.1
- Atualização para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter
- Compatível com a versão 4.7.0.0 do adaptador do Android da Moloco.
- Compatível com a versão 4.5.1.0 do adaptador da Moloco para iOS.
- Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 3.3.0
- Compatível com a versão 4.5.0.0 do adaptador do Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 3.2.0
- Compatível com a versão 4.4.0.0 do adaptador Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 3.1.0
- Atualização da versão mínima do Flutter para 3.35.1
- Compatível com a versão 4.4.0.0 do adaptador Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 3.0.0
- Compatível com a versão 4.3.1.0 do adaptador Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 2.1.0
- Compatível com a versão 4.2.0.0 do adaptador do Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
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.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.6.0
- Compatível com a versão 3.12.0.0 do adaptador do 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 6.0.0 do plug-in do Google Mobile Ads para Flutter.
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 6.0.0 do plug-in do Google Mobile Ads para Flutter.
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.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
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.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.3.0
- Compatível com a versão 3.9.0.0 do adaptador Android da Moloco.
- Compatível com a 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 do Google Mobile Ads para Flutter.
Versão 1.2.0
- 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.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.1.0
- 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 5.3.1 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 3.6.1.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 5.3.1 do plug-in do Google Mobile Ads para Flutter.