Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google com o objetivo de carregar e mostrar anúncios da Mintegral usando a mediação, abrangendo integrações de hierarquia e 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 Flutter .
Integrações e formatos de anúncio compatíveis
O adaptador de mediação AdMob para a Mintegral tem os seguintes recursos:
Integração | ||
---|---|---|
Lances | 1 | |
Cascata | 2 | |
Formatos | ||
Abertura do aplicativo | 1 2 | |
Banner | ||
Intersticial | ||
Premiado | ||
Intersticial premiado | ||
Nativo | 1 3 |
1 A integração de lances para esse formato está na versão Beta fechada.
2 A integração em hierarquia desse formato está na versão Beta fechada.
3 A integração em hierarquia desse formato está 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 implantar no Android:
- Android API de nível 21 ou mais recente
- Para implantar no iOS:
- Destino de implantação do iOS de 12.0 ou mais recente
- Um projeto Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
- Leia o Guia explicativo de mediação.
Etapa 1: definir as configurações na interface da Mintegral
Inscreva-se ou faça login na sua conta da Mintegral.
Localizar a chave do app
Navegue até a guia Configuração do app e anote a chave do app.
Adicionar um novo aplicativo
Na guia Configuração do aplicativo, clique no botão Adicionar aplicativo.
Selecione a Plataforma e preencha o restante do formulário. Em seguida, clique em Salvar.
Android
iOS
Anote o ID do app do seu aplicativo.
Android
iOS
Criar um posicionamento do anúncio
Depois de criar o aplicativo, navegue até a guia Canais e blocos e clique no botão Adicionar posição, conforme mostrado abaixo, para criar um canal do anúncio.
Android
iOS
Insira um Nome da posição e um Formato do 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 AD Units e anote o ID do bloco de anúncios.
Android
iOS
Localizar sua chave de API de relatórios da Mintegral
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Você vai precisar da sua chave da API Mintegral Reporting para configurar o AdMob ID do bloco de anúncios. Navegue até Conta > Ferramentas de API. Anote o Skey e o Secret.
Etapa 2: configurar a demanda da Mintegral na AdMob interface
Definir as configurações de mediação para seu bloco de anúncios
Android
Para conferir instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
Adicionar Mintegral ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Mintegral à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.
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
Mintegral SDK e do adaptador 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 salvo e adicione a pasta do plug-in extraída (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no seu
arquivo pubspec.yaml
adicionando a seguinte dependência:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Etapa 4: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração da Mintegral.
iOS
Integração com a 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 em AdMob
Para fazer o teste da Mintegral com anúncios de banner, intersticiais, premiados e nativos, a Mintegral recomenda o uso das chaves de app, dos IDs do app, da posição e do bloco de anúncios fornecidos na Página de ID do teste da Mintegral.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Mintegral, ative os testes de uma única origem no Ad Inspector usando as Mintegral (Bidding) and Mintegral (Waterfall) origens de anúncios.
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 classes abaixo:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Mintegral quando um anúncio não é carregado:
Android
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.ads.mediation.mintegral | Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição ausente). |
102 | com.google.ads.mediation.mintegral | O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a Mintegral. |
103 | com.google.ads.mediation.mintegral | A resposta do lance está 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 de servidor inválidos (por exemplo, ID do app ou 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 de 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
1.0.0
- Versão inicial.
- Compatibilidade verificada com o adaptador para Android da Mintegral versão 16.7.21.0.
- Compatibilidade verificada com o adaptador iOS da Mintegral versão 7.6.3.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.