Integrar a Mintegral com a mediação

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.