Integrar o Mintegral aos lances (Beta)

Este guia mostra 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 abrange 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 em uma Android .

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

O adaptador de mediação para a 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á ativa versão Beta fechada (exceto para formato de anúncio nativo na versão Beta aberta).

2 A integração em hierarquia está 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

  • Concluir a mediação Guia explicativo

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

Navegue até a guia Configuração do app e anote a chave do app.

Adicionar um novo aplicativo

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

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

Anote o ID do app do seu aplicativo.

Criar um posicionamento do anúncio

Depois de criar o aplicativo, navegue até a guia Canais e blocos e clique no botão Adicionar posição, conforme mostrado abaixo, para criar um canal do anúncio.

Insira um Nome da posição 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 que a posição do anúncio for criada, anote o ID da posição.

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

Localizar sua chave de API de relatórios da Mintegral

Lances

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

Cascata

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

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

Faça login na sua conta do Ad Manager.

Adicionar Mintegral em "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 digitar um Nome de usuário ou uma Senha. Clique em Salvar quando concluir.

Ativar o compartilhamento de indicador seguro

Lances

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange, revise e ative a opção Compartilhamento de indicador seguro. Clique em Salvar.

Cascata

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

Configurar Mintegral lances

Lances

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

Selecione Mintegral como bidder.

Ative a opção 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

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

Configurar o mapeamento de blocos de anúncios

Lances

Navegue até Exibição > 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 um formato, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, digite o App Key, App ID, Placement ID, and Ad Unit ID obtido na seção anterior. Por fim, clique em Salvar.

.

Cascata

Navegue até Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione seu Aplicativo para dispositivos móveis.

Role para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para Mintegralna seção anterior. Escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status.

Insira o App Key, App ID, Placement ID, and Ad Unit IDobtido na seção anterior e o valor de CPM padrão. Clique em Salvar.

Adicionar Mintegral ao GDPR e à lista de parceiros de publicidade 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 Mintegral à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.

Etapa 3: importar o SDK e o adaptador da Mintegral

No arquivo settings.gradle.kts do projeto, adicione o seguinte 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 o seguinte: dependências e configurações de implementação. Use as versões mais recentes do SDK e adaptador da Mintegral:

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

Integração manual

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

  2. Acesse o Artefatos do adaptador Mintegral no repositório Maven do Google. Selecione a versão mais recente e faça o download do Mintegral .aar do adaptador e adicione-o ao projeto.

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

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

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

O exemplo de código a seguir mostra como transmitir informações de consentimento para a Mintegral SDK do Vertex AI Pipelines. Essas opções precisam ser definidas Inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente ao 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)

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

Leis Estaduais de Privacidade dos EUA

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. O Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

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

O exemplo de código a seguir mostra como transmitir informações de consentimento para a Mintegral SDK do Vertex AI Pipelines. Se você precisar chamar esse método, chame-o depois 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)

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

Etapa 5: adicionar o código obrigatório

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em Ad Manager

Para fazer o teste da Mintegral com anúncios de banner, intersticiais, premiados e nativos, a Mintegral recomenda o uso das chaves de app, dos IDs do app, da posição e do bloco de anúncios fornecidos na página de IDs de teste da Mintegral (em inglês).

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Mintegral, ative os testes de uma única origem no Ad Inspector usando as Mintegral (Bidding) and Mintegral (Waterfall) origens de anúncios.

Etapas opcionais

Adicionar a Mintegral à lista de parceiros de publicidade da CCPA

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

Anúncios nativos

Renderização de anúncios

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

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

1 O adaptador da Mintegral não dão 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ê pode verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

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

Estes são os códigos e as mensagens correspondentes gerados pelo adaptador da Mintegral quando ocorre uma falha no carregamento de um anúncio:

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 de anúncio solicitado não corresponde a um tamanho de banner compatível com a Mintegral.
103 com.google.ads.mediation.mintegral A resposta do lance está ausente ou é inválida.
104 com.google.ads.mediation.mintegral O SDK da Mintegral retornou um erro de não preenchimento.
101 com.google.mediation.mintegral Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição ausente).
102 com.google.mediation.mintegral O SDK da Mintegral retornou um erro de não 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 para Android da Mintegral

Versão 16.8.11.0

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

Versão 16.7.81.0

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

Criado e testado com:

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

Versão 16.7.61.0

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

Criado e testado com:

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

Versão 16.7.41.0

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

Criado e testado com:

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

Versão 16.7.21.0

  • Compatibilidade verificada com o SDK da Mintegral 16.7.21.

Criado e testado com:

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

Versão 16.7.11.0

  • Compatibilidade verificada com o SDK da Mintegral 16.7.11.

Criado e testado com:

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

Versão 16.6.71.0

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

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

Versão 16.6.51.0

  • Compatibilidade verificada com o SDK da Mintegral 16.6.51.

Criado e testado com:

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

Versão 16.6.41.0

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

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

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

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.51.0

  • Compatibilidade verificada com o SDK da Mintegral 16.5.51.

Criado e testado com:

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

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

Versão 16.5.31.0

  • Compatibilidade verificada com o SDK da Mintegral 16.5.31.
  • O adaptador foi revertido para depender do SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
  • Foi adicionado suporte à hierarquia para o formato de 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 da Mintegral 16.5.21.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 22.4.0.

Criado e testado com:

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

Versão 16.5.11.0

  • Adição de compatibilidade com marca d'água para anúncios de lances.
  • Compatibilidade verificada com o SDK da 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 da 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 16.4.91 do SDK da Mintegral.

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

Versão 16.4.71.0

  • Compatibilidade verificada com o SDK da Mintegral 16.4.71.

Criado e testado com:

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

Versão 16.4.61.0

  • Compatibilidade verificada com o SDK da Mintegral 16.4.61.

Criado e testado com:

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

Versão 16.4.51.0

  • Compatibilidade verificada com o SDK da Mintegral 16.4.51.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
  • Versão do SDK da Mintegral 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.
  • Versão 16.4.41 do SDK da Mintegral.

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

Versão 16.4.21.0

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

Criado e testado com:

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

Versão 16.3.91.0

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

Criado e testado com:

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

Versão 16.3.71.0

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

Criado e testado com:

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

Versão 16.3.51.1

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

Criado e testado com:

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

Versão 16.3.51.0

  • Compatibilidade verificada com o SDK da Mintegral 16.3.51.

Criado e testado com:

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

Versão 16.3.41.0

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

Versão 16.3.11.0

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

Versão 16.2.61.0

  • Versão inicial.
  • Foi adicionada compatibilidade com lances para os formatos de banner (inclui MREC), intersticial, premiado e nativo.

Criado e testado com:

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