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
Cascata
Formatos
Abertura do aplicativo	^1
Banner
Intersticial
Premiado
Intersticial premiado
Nativo	^2

¹ As integrações de lances e hierarquia para o formato de anúncio de abertura do app estão na versão Beta fechada.

² As integrações de lances e hierarquia para formato de anúncio nativo estão na versão Beta aberta.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google
• 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 Começar para mais detalhes.
• Concluir 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 de 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 um posicionamento do anúncio

Depois que seu aplicativo for criado, acesse a guia Canais e blocos e clique no botão Adicionar posicionamento, conforme mostrado abaixo, para criar o posicionamento do anúncio.

Android

iOS

Insira um Nome da posição e um Formato do anúncio.

Importante: para o formato de anúncio nativo, selecione Nativo (Renderização personalizada) como 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 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ê 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

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

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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

Observação :a não integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e da Mintegral pode levar a problemas de criação.

Integração pelo pub.dev

Adicione a dependência a seguir com as versões mais recentes da Mintegral O SDK e o adaptador na Arquivo pubspec.yaml:

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, extrair o arquivo baixado e adicionar a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto Flutter. Em seguida, consulte o plug-in 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.

Importante: desative o modo de teste para AdMob e Mintegral antes de lançar o app.

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 seguintes classes:

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 do servidor inválidos (por exemplo, ID do app ou ID 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	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 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 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

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 o adaptador para Android da Mintegral versão 16.8.31.0.
• Compatibilidade verificada com o adaptador iOS da Mintegral versão 7.7.1.0.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.

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 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.