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 exibir anúncios da Mintegral usando a Mediação da AdMob, cobrindo 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 Android.

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

O adaptador de mediação 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

  • API do Android de nível 21 ou mais recente

  • [Para lances]: para integrar todos os formatos de anúncio compatíveis nos lances, use o adaptador Mintegral 16.5.91.1 ou mais recente (recomendamos a versão mais recente)

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o Guia para iniciantes 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.

Anote o ID do app.

Criar uma posição de anúncio

Depois que a aplicação for criada, navegue até a guia Posicionamentos e unidades e clique no botão Adicionar posicionamento, conforme mostrado abaixo, para criar o posicionamento do anúncio.

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.

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

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

Configurar as configurações de mediação do bloco de anúncios

É necessário adicionar a Mintegral à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar a Mintegral como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio e clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar a Mintegral como uma origem de anúncios

Lances


No card Lances, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Mintegral.
Clique em Como assinar um contrato de parceria e configure uma parceria de lances com a Mintegral.
Clique em Concordar e continuar e em Continuar.
Se você já tiver um mapeamento para a Mintegral, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira a chave do app, o ID do app, o ID da posição e o ID do bloco de anúncios obtidos na seção anterior. Em seguida, clique em Concluído.

Cascata


No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Mintegral.

Selecione Mintegral. Em seguida, insira um valor de eCPM para Mintegral e clique em Continuar.



Se você já tiver um mapeamento para Mintegral, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira a chave do app, o ID do app, o ID da posição e o ID do bloco de anúncios obtidos na seção anterior. Em seguida, clique em Concluído.


Adição da Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações 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

No arquivo settings.gradle.kts do projeto, adicione os seguintes repositórios:

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

Em seguida, no arquivo build.gradle.kts do app, adicione as dependências e configurações de implementação abaixo. Use as versões mais recentes do SDK e do adaptador Mintegral:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

Integração manual

  1. Para incluir o SDK Mintegral, acesse o SDK Mintegral para Android.

  2. Navegue até os artefatos do adaptador Mintegral no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador Mintegral e adicione-o ao projeto.

Etapa 4: implementar as configurações de privacidade no SDK da Mintegral

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.

O SDK Mintegral inclui o método setConsentStatus para transmitir informações de consentimento ao SDK Mintegral.

O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da Mintegral. Essas opções precisam ser definidas antes de você inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK da Mintegral.

Java 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

Kotlin 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

Consulte a documentação de privacidade da Mintegral para mais informações.

Leis Estaduais de Privacidade dos EUA

Leis estaduais de privacidade dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição legal desses termos). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

O SDK Mintegral inclui o método setDoNotTrackStatus para transmitir informações de consentimento ao SDK Mintegral.

O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da Mintegral. Se você precisar chamar esse método, faça isso após inicializar o SDK dos anúncios para dispositivos móveis do Google, mas antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

Java 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

Kotlin 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

Consulte a documentação de privacidade da Mintegral para mais informações.

Etapa 5: adicionar o código necessário

Nenhum código adicional é necessário para a integração com a Mintegral.

Etapa 6: 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 de app, IDs de app, IDs de posicionamento e 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 (Mediação) e Mintegral (Hierarquia).

Etapas opcionais

Adicionar a Mintegral à lista de parceiros de anúncios da CCPA

Siga as etapas em Configurações da CCPA para adicionar a Mintegral à lista de parceiros de publicidade da CCPA na interface da AdMob.

Anúncios nativos

Renderização do anúncio

O adaptador Mintegral retorna os anúncios nativos como objetos NativeAd. Ele preenche os seguintes campos para um NativeAd.

Campo Recursos sempre incluídos pelo adaptador Mintegral
Título
Imagem 1
Corpo
Ícone
Call-to-action
Star rating
Loja
Preço
Advertiser

1 O adaptador Mintegral não oferece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o adaptador preenche o MediaView com um vídeo ou uma imagem.

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, você poderá verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

Confira os códigos e as mensagens associadas gerados pelo adaptador Mintegral quando um anúncio não é carregado:

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.

Registro de alterações do adaptador de mediação Mintegral para Android

Próxima versão

  • Inicialização do SDK Mintegral em uma linha de execução em segundo plano (para corrigir ANRs).

Versão 16.8.61.0

  • Compatibilidade verificada com o SDK Mintegral 16.8.61.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
  • SDK Mintegral versão 16.8.61.

Versão 16.8.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.8.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
  • SDK Mintegral versão 16.8.51.

Versão 16.8.41.0

  • Compatibilidade verificada com o SDK Mintegral 16.8.41.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
  • SDK do Mintegral versão 16.8.41.

Versão 16.8.31.0

  • Compatibilidade verificada com o SDK Mintegral 16.8.31.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
  • SDK Mintegral versão 16.8.31.

Versão 16.8.11.0

  • Compatibilidade verificada com o SDK Mintegral 16.8.11.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
  • SDK Mintegral versão 16.8.11.

Versão 16.7.91.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.91.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
  • SDK Mintegral versão 16.7.91.

Versão 16.7.81.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.81.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
  • SDK Mintegral versão 16.7.81.

Versão 16.7.71.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.71.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
  • SDK Mintegral versão 16.7.71.

Versão 16.7.61.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.61.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
  • SDK Mintegral versão 16.7.61.

Versão 16.7.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
  • SDK Mintegral versão 16.7.51.

Versão 16.7.41.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.41.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
  • SDK da Mintegral versão 16.7.41.

Versão 16.7.31.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.31.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
  • SDK Mintegral versão 16.7.31.

Versão 16.7.21.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.21.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
  • SDK da Mintegral versão 16.7.21.

Versão 16.7.11.0

  • Compatibilidade verificada com o SDK Mintegral 16.7.11.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
  • SDK Mintegral versão 16.7.11.

Versão 16.6.71.0

  • Compatibilidade verificada com o SDK Mintegral 16.6.71.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
  • SDK Mintegral versão 16.6.71.

Versão 16.6.61.0

  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.
  • Compatibilidade verificada com o SDK Mintegral 16.6.61.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
  • SDK Mintegral versão 16.6.61.

Versão 16.6.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.6.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.6.51.

Versão 16.6.41.0

  • Compatibilidade verificada com o SDK Mintegral 16.6.41.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.6.41.

Versão 16.6.34.0

  • Compatibilidade verificada com o SDK Mintegral 16.6.34.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.6.34.

Versão 16.6.21.0

  • Compatibilidade verificada com o SDK Mintegral 16.6.21.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.6.21.

Versão 16.5.91.1

  • Adição de suporte a lances para o formato de anúncio de abertura de app.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.5.91.

Versão 16.5.91.0

  • Compatibilidade verificada com o SDK Mintegral 16.5.91.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.6.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
  • SDK Mintegral versão 16.5.91.

Versão 16.5.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.5.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
  • SDK Mintegral versão 16.5.51.

Versão 16.5.41.0

  • Compatibilidade verificada com o SDK Mintegral 16.5.41.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
  • SDK Mintegral versão 16.5.41.

Versão 16.5.31.0

  • Compatibilidade verificada com o SDK Mintegral 16.5.31.
  • O adaptador foi revertido para depender da versão 22.3.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Adição de suporte à hierarquia para o formato de anúncio de abertura de app.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
  • SDK Mintegral versão 16.5.31.

Versão 16.5.21.0

  • Compatibilidade verificada com o SDK Mintegral 16.5.21.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.4.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.4.0.
  • SDK Mintegral versão 16.5.21.

Versão 16.5.11.0

  • Suporte adicionado para marca d'água em anúncios de lances.
  • Compatibilidade verificada com o SDK Mintegral 16.5.11.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
  • SDK Mintegral versão 16.5.11.

Versão 16.4.91.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.91.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
  • SDK Mintegral versão 16.4.91.

Versão 16.4.81.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.81.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
  • SDK Mintegral versão 16.4.81.

Versão 16.4.71.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.71.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
  • SDK Mintegral versão 16.4.71.

Versão 16.4.61.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.61.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
  • SDK Mintegral versão 16.4.61.

Versão 16.4.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
  • SDK Mintegral versão 16.4.51.

Versão 16.4.41.0

  • Correção de um problema em que os anúncios de banner eram renderizados com tamanhos incorretos.
  • Compatibilidade verificada com o SDK Mintegral 16.4.41.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK da Mintegral versão 16.4.41.

Versão 16.4.31.0

  • Compatibilidade verificada com o SDK Mintegral 16.4.31.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK Mintegral versão 16.4.31.

Versão 16.4.21.0

  • O adaptador foi atualizado para usar a nova classe VersionInfo.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.0.0.
  • Compatibilidade verificada com o SDK Mintegral 16.4.21.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
  • SDK Mintegral versão 16.4.21.

Versão 16.3.91.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.91.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK Mintegral versão 16.3.91.

Versão 16.3.81.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.81.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK Mintegral versão 16.3.81.

Versão 16.3.71.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.71.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK da Mintegral versão 16.3.71.

Versão 16.3.61.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.61.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK Mintegral versão 16.3.61.

Versão 16.3.51.1

  • Adição de suporte à hierarquia para formatos de anúncio de banner (incluindo MREC), intersticial, premiado e nativo.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK Mintegral versão 16.3.51.

Versão 16.3.51.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.4.0.
  • SDK Mintegral versão 16.3.51.

Versão 16.3.41.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.41.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.4.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.4.0.
  • SDK da Mintegral versão 16.3.41.

Versão 16.3.11.0

  • Compatibilidade verificada com o SDK Mintegral 16.3.11.
  • Atualizamos o adaptador para encaminhar onUserEarnedReward() antes de onAdClosed() ao mostrar anúncios premiados.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
  • SDK Mintegral versão 16.3.11.

Versão 16.2.61.0

  • Versão inicial.
  • Adicionado suporte a lances para formatos de anúncio de banner (incluindo MREC), intersticial, premiado e nativo.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
  • SDK Mintegral versão 16.2.61.