Integrar a Mintegral com a mediação

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

Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da Mintegral usando a 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 do Flutter.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para a 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, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente do framework do Flutter.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar 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 o Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configure a 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

    Acesse a guia Configuração do app e anote a chave do app.

    Adicionar um novo aplicativo

    Na guia Configuração do APP, clique no botão Adicionar APP.

    Selecione a Plataforma e preencha o restante do formulário. Depois, clique em Salvar.

    Android

    iOS

    Anote o ID do app.

    Android

    iOS

    Crie uma posição do anúncio

    Depois que o aplicativo for criado, acesse a guia Placements & Units e clique no botão Add Placement, conforme mostrado abaixo, para criar o posicionamento do anúncio.

    Android

    iOS

    Insira um Nome do canal e um Formato do anúncio.

    Selecione Lances de cabeçalho como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

    Depois de criar a posição de anúncio, anote o ID da posição.

    Android

    iOS

    Clique no menu suspenso 1 bloco de anúncios e anote o ID do bloco de anúncios.

    Android

    iOS

    Localizar sua chave de API Reporting da Mintegral

    Lances

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

    Cascata

    Você vai precisar da chave de API Reporting da Mintegral para configurar o ID do bloco de anúncios do Ad Manager. Acesse Conta > Ferramentas de API. Anote sua Skey e sua Secret.

    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 de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

    Para implementar o app-ads.txt para a 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 ver as 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

    (Somente Android) Adicione os seguintes repositórios ao arquivo build.gradle no diretório android do seu projeto:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
      }
  }

    Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Mintegral no arquivo pubspec.yaml do seu pacote:

    dependencies:
  gma_mediation_mintegral: ^2.1.4

    Integração manual

    Baixe a 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: implementar configurações de privacidade no SDK da Mintegral

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro armazenamento local quando exigido por lei e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

    A versão 2.1.1 e mais recentes do adaptador do Flutter da Mintegral aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK da Mintegral. Para mais informações, consulte a documentação da Declaração de Conformidade de Privacidade do SDK da Mintegral para Android e iOS.

    Etapa 5: 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 6: testar a implementação

    Ativar anúncios de teste

    Registre seu dispositivo de teste no Ad Manager.

    Para receber anúncios de teste da Mintegral para formatos de anúncio nativo, premiado, intersticial e de banner, a Mintegral recomenda usar as chaves de app, os IDs de app, os IDs de posição e os IDs de 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 origens de anúncios Mintegral (lances) e Mintegral (hierarquia).

    Códigos de erro

    Se o adaptador não receber um anúncio da Mintegral, verifique 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 de posição ausente).
    102 com.google.ads.mediation.mintegral O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Mintegral.
    103 com.google.ads.mediation.mintegral A resposta à solicitação de lance está 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 espaço da Mintegral já foi carregado e ainda não foi exibido.

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

    Versão 2.1.5 (em andamento)

    Versão 2.1.4

    Versão 2.1.3

    Versão 2.1.2

    Versão 2.1.1

    Versão 2.1.0

    Versão 2.0.3

    Versão 2.0.2

    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

    Versão 1.0.0