Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Mintegral usando mediação, cobrindo integrações de leilão e de lances. Ele aborda como adicionar a Mintegral à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Mintegral a um app do Flutter.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação da AdMob para Mintegral tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Abertura do aplicativo | 1 |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado | |
Nativo | 2 |
1 As integrações de lances e hierarquia para o formato de anúncio de abertura do app estão na versão Beta fechada.
2 As integrações de lances e hierarquia para o formato de anúncio nativo estão na versão Beta aberta.
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Flutter 3.7.0 ou mais recente
- [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para Mintegral 1.4.0 ou mais recente (recomenda-se a versão mais recente).
- Para implantar no Android
- API do Android de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes de mediação
Etapa 1: configurar as configurações na interface da Mintegral
Crie ou faça login na sua conta da Mintegral.
Localizar a chave do app
Acesse a guia Configuração do app e anote a chave do app.
Adicionar um novo aplicativo
Na guia APP Setting, clique no botão Add APP.
Selecione a Plataforma e preencha o restante do formulário. Em seguida, clique em Salvar.
Android
iOS
Anote o ID do app.
Android
iOS
Criar uma posição do anúncio
Depois que a aplicação for criada, navegue até a guia Posicionamentos e unidades e clique no botão Adicionar posicionamento, conforme mostrado abaixo, para criar o posicionamento do anúncio.
Android
iOS
Insira um nome do canal e um formato de anúncio.
Lances
Selecione Lances de cabeçalho como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.
Cascata
Selecione Tradicional como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.
Depois que a posição do anúncio for criada, anote o ID da posição.
Android
iOS
Clique no menu suspenso 1 Blocos de anúncios e anote o ID do bloco de anúncios.
Android
iOS
Localizar sua chave da API Mintegral Reporting
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Você vai precisar da chave da API Mintegral Reporting para configurar o ID do bloco de anúncios da AdMob. Navegue até Account > API Tools. Anote a chave S e a chave secreta.
Etapa 2: configurar a demanda da Mintegral na interface da AdMob
Configurar 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 ver as instruções, consulte a etapa 2 no guia para iOS.
Adicionar Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Regulamentações estaduais dos EUA para adicionar a Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface da AdMob.
Etapa 3: importar o SDK e o adaptador da Mintegral
Integração pelo pub.dev
Adicione a dependência abaixo com as versões mais recentes do
SDK e do adaptador Mintegral no
arquivo pubspec.yaml
do pacote:
dependencies:
gma_mediation_mintegral: ^1.0.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
Mintegral,
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_mintegral:
path: path/to/local/package
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração com a Mintegral.
iOS
Integração da SKAdNetwork
Siga a documentação da Mintegral
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist
do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Para receber anúncios de teste da Mintegral para formatos de anúncios de banner, intersticiais, premiados e nativos, a Mintegral recomenda usar as chaves de app, IDs de app, IDs de posicionamento e IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Mintegral, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Mintegral (Mediação) e Mintegral (Hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio da Mintegral, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo
nas seguintes classes:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Confira os códigos e as mensagens associadas gerados pelo adaptador Mintegral quando um anúncio não é carregado:
Android
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.ads.mediation.mintegral | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição ausente). |
102 | com.google.ads.mediation.mintegral | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Mintegral. |
103 | com.google.ads.mediation.mintegral | Resposta de lance ausente ou inválida. |
104 | com.google.ads.mediation.mintegral | O SDK da Mintegral retornou um erro de não preenchimento. |
iOS
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.mediation.mintegral | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição ausente). |
102 | com.google.mediation.mintegral | O SDK da Mintegral retornou um erro de não preenchimento. |
103 | com.google.mediation.mintegral | O SDK da Mintegral não conseguiu mostrar um anúncio. |
104 | com.google.mediation.mintegral | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Mintegral. |
Registro de alterações do adaptador de mediação do Flutter da Mintegral
Próxima versão
- Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
1.1.0
- Compatibilidade verificada com a versão 16.8.31.0 do adaptador Mintegral para Android.
- Compatibilidade verificada com o adaptador Mintegral para iOS versão 7.7.1.0.
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
1.0.0
- Versão inicial.
- Compatibilidade verificada com a versão 16.7.21.0 do adaptador Mintegral para Android.
- Compatibilidade verificada com o adaptador Mintegral para iOS versão 7.6.3.0.
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.