Integrar a Mintegral com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Mintegral usando a 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 Flutter .

Integrações e formatos de anúncio compatíveis

O adaptador de mediação 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 Flutter funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo 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

Navegue até 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 Posições e unidades e clique no botão Adicionar posição, conforme mostrado abaixo, para criar a posição 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 AdMob interface

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 Mintegral à lista de parceiros de publicidade do GDPR e dos regulamentos 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 do app, os IDs do app, os IDs de posição e os IDs de bloco de anúncios fornecidos na página do 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.