Integrar a Mintegral com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da Mintegral usando mediação, incluindo integrações de lances e em hierarquia. Ele explica 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 aceitos

O adaptador de mediação do Ad Manager para Mintegral tem os seguintes recursos:

Integração
Lances  1
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo
1 A integração de lances está em versão Beta aberta.

Pré-requisitos

Antes de continuar, faça as seguintes verificações:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente do framework do Flutter.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para Mintegral 1.4.0 ou uma versão mais recente (recomendamos usar a última versão).
  • Para implantação no Android
    • Nível da API Android 23 ou mais recente.
  • Para implantação no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Flutter em funcionamento configurado com o Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configurar a mediação.

Etapa 1: definir as configurações na interface da Mintegral

Crie uma conta ou faça login na sua conta da Mintegral.

Localizar a chave do app

Acesse a guia APP Setting (Configuração do app) e anote a APP Key (Chave do app).

Adicionar um novo aplicativo

Na guia APP Setting (Configuração do app), clique no botão Add APP (Adicionar app).

Selecione a Platform (Plataforma) e preencha o restante do formulário. Em seguida, clique em Save (Salvar).

Android

iOS

Anote o APP ID (ID do app) do aplicativo.

Android

iOS

Criar uma posição do anúncio

Depois que o aplicativo for criado, acesse a guia Placements &Units (Posições e blocos) e clique no botão Add Placement (Adicionar posição), conforme mostrado abaixo, para criar a posição do anúncio.

Android

iOS

Insira um Placement Name (Nome da posição) e um AD Format (Formato do anúncio).

Selecione Header Bidding (Lances de cabeçalho) como o Bidding Type (Tipo de lance). Preencha o restante do formulário e clique em Save (Salvar).

Depois que a posição do anúncio for criada, anote o Placement ID (ID da posição).

Android

iOS

Clique no menu suspenso 1 AD Units (1 bloco de anúncios) e anote o AD Unit ID (ID do bloco de anúncios).

Android

iOS

Localizar sua chave da API Reporting da Mintegral

Lances

Essa etapa não é necessária para integrações de lances.

Cascata

Você vai precisar da chave da API Reporting da Mintegral para configurar o ID do bloco de anúncios do Ad Manager. Acesse Account > API Tools (Conta > Ferramentas de API). Anote o Skey (Chave) e a Secret (Senha).

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita dos anúncios, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar app-ads.txt na Mintegral, consulte Como o app-ads.txt pode ajudar a combater a fraude de anúncios.

Etapa 2: configurar a demanda da Mintegral na interface do Ad Manager

Definir 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 instruções, consulte a etapa 2 no guia para iOS.

Adicionar a Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Mobvista/Mintegral à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

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 da Mintegral no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_mintegral: ^2.1.2

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

Certifique-se de registrar seu dispositivo de teste para Ad Manager.

Para receber anúncios de teste da Mintegral para formatos de banner, intersticial, premiado e nativo, a Mintegral recomenda usar as chaves do app, os IDs do app, os IDs da posição e os IDs do 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 originais de anúncios Mintegral (lances) 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 na 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
100 com.mbridge.msdk O SDK da Mintegral retornou um callback de falha.
101 com.google.ads.mediation.mintegral Parâmetros de 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 à solicitação de lance ausente ou inválida.
104 com.google.ads.mediation.mintegral O SDK da Mintegral retornou um erro de preenchimento.
105 com.mbridge.msdk Falha ao inicializar o SDK da Mintegral.
106 com.google.ads.mediation.mintegral Um anúncio para o slot da Mintegral já foi carregado e ainda não foi mostrado.

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 ID da posição ausente).
102 com.google.mediation.mintegral O SDK da Mintegral retornou um erro de 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 da Mintegral para o Flutter

Versão 2.1.3 (em andamento)

  • Atualizado para oferecer suporte à versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
  • Adição de suporte ao Gerenciador de pacotes do Swift.

Versão 2.1.2

  • Oferece suporte à versão 17.1.71.0 do adaptador da Mintegral para Android .
  • Oferece suporte à versão 8.1.6.0 do adaptador da Mintegral para iOS .
  • Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 2.1.1

Versão 2.1.0

  • Versão mínima do Flutter atualizada para 3.38.1.
  • Atualizado para oferecer suporte à versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
  • Oferece suporte à versão 17.1.41.0 do adaptador da Mintegral para Android.
  • Oferece suporte à versão 8.1.1.0 do adaptador da Mintegral para iOS .
  • Criado e testado com a versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 2.0.3

Versão 2.0.2

  • Versão mínima do Flutter atualizada para 3.35.1
  • Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
  • Oferece suporte à versão 17.0.41.0 do adaptador da Mintegral para Android .
  • Oferece suporte à versão 8.0.4.0 do adaptador da Mintegral para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 2.0.1

Versão 2.0.0

Versão 1.2.6

Versão 1.2.5

Versão 1.2.4

Versão 1.2.3

Versão 1.2.2

Versão 1.2.1

Versão 1.2.0

Versão 1.1.0

  • O plug-in do iOS agora é um framework estático.
  • Oferece suporte à versão 16.8.61.0 do adaptador da Mintegral para Android.
  • Oferece suporte à versão 7.7.5.0 do adaptador da Mintegral para iOS .
  • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

  • Versão inicial.
  • Oferece suporte à versão 16.7.21.0 do adaptador da Mintegral para Android .
  • Oferece suporte à versão 7.6.3.0 do adaptador da Mintegral para iOS.
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.