Integrar a Mintegral aos lances (Beta)

Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Mintegral usando 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 appAndroid .

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

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

Integração
Lances  1
Cascata  2
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo
1 A integração de lances está na Beta fechada (exceto para o formato de anúncio nativo na Beta aberta).

2 A integração em cascata está na versão Beta fechada.

Requisitos

  • Android API de nível 21 ou mais recente

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

  • Leia o Guia explicativo de mediação

Etapa 1: definir 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 um posicionamento do 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 Ad Manager interface

Adicionar Mintegral à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das 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 no nível 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 no nível do app, adicione as dependências e configurações de implementação abaixo. Use as versões mais recentes do SDK e do adaptador da Mintegral:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.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 da Mintegral e adicione-o ao projeto.

Etapa 4: implementar 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 a seguir 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 lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" 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 da Mintegral inclui o método setDoNotTrackStatus para transmitir informações de consentimento ao SDK da 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, chame-o após de 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

Etapas opcionais

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

Siga as etapas em Configurações da CCPA para adicionar Mintegral à lista de parceiros de publicidade da CCPA na Ad Manager UI.

Anúncios nativos

Renderização de anúncios

O adaptador da Mintegral retorna os anúncios nativos como 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 da Mintegral não fornece acesso direto ao recurso de imagem principal para os 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 de servidor inválidos (por exemplo, ID do app ou 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 do 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 da Mintegral 16.8.41.

Criado e testado com:

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

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.
  • Versão 16.8.11 do SDK da Mintegral.

Versão 16.7.91.0

  • Compatibilidade verificada com o SDK da 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.
  • Versão do SDK da Mintegral 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.
  • Versão 16.7.61 do SDK da Mintegral.

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.
  • Versão 16.7.41 do SDK da Mintegral.

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.
  • Versão 16.6.71 do SDK da Mintegral.

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 da 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.
  • Versão 16.6.41 do SDK da Mintegral.

Versão 16.6.34.0

  • Compatibilidade verificada com o SDK da 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 da Mintegral 16.6.21.

Criado e testado com:

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

Versão 16.5.91.1

  • Agora é possível usar lances para o formato do anúncio de abertura do app.

Criado e testado com:

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

Versão 16.5.91.0

  • Compatibilidade verificada com o SDK da 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 da 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.
  • Foi adicionado suporte à hierarquia para o formato do anúncio de abertura do app.

Criado e testado com:

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

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.
  • Versão 16.5.11 do SDK da Mintegral.

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.
  • Versão do SDK da Mintegral 16.4.91.

Versão 16.4.81.0

  • Compatibilidade verificada com o SDK da 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 da 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 da 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.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
  • Versão 16.3.91 do SDK da Mintegral.

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.
  • Versão 16.3.71 do SDK da Mintegral.

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.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
  • O adaptador foi atualizado 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.