Integrar a Mintegral aos lances (Beta)

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 mediação, cobrindo integrações de leilão e de 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  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 hierarquia está na versão Beta fechada.

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.

Selecione Lances de cabeçalho 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 do Ad Manager. Navegue até Account > API Tools. Anote a chave S e a chave secreta.

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

Faça login na sua conta do Ad Manager.

Adicionar a Mintegral nas empresas

Lances

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

Cascata

Acesse Administrador > Empresas e clique no botão Nova empresa na guia Todas as empresas. Selecione Rede de publicidade.

Selecione Mintegral como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Não é necessário inserir um Nome de usuário ou uma Senha. Clique em Salvar quando terminar.

Ativar o compartilhamento de indicador seguro

Lances

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative o Compartilhamento de indicadores seguros. Clique em Salvar.

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar lances da Mintegral

Lances

Navegue até Exibição > Bidders e clique em Novo bidder na guia Lances do SDK.

Selecione Mintegral como o bidder.

Ative Adicionar a biblioteca de indicadores deste bidder à lista de indicadores permitidos e Permitir que os indicadores sejam compartilhados com este bidder. Em seguida, clique em Continuar.

Clique em Continuar.

Clique em Concluído.

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar o mapeamento de blocos de anúncios

Lances

Navegue até Envio > Bidders e selecione a empresa para Mintegral na guia Lances do SDK.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco de anúncios e formato, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira a chave do app, o ID do app, o ID da posição e o ID do bloco de anúncios que você recebeu na seção anterior. Por fim, clique em Salvar.

Cascata

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione o aplicativo para dispositivos móveis.

Role a tela para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para Mintegral na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o tipo de integração, Android como a plataforma e Ativo como o status.

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 e o valor do CPM padrão. Clique em Salvar.

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 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 do Ad Manager.

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

As 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 desses termos na lei). Essa opção é disponibilizada 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 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 no Ad Manager.

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 do Ad Manager.

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.