Integrar o Mintegral aos lances (Beta)

Neste guia, mostramos 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, abrangendo integrações de hierarquia 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 Android app.

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

O Ad Manager adaptador de mediação da Mintegral tem os seguintes recursos:

Integração
Lances  1
Cascata  2
Formatos
Abertura do aplicativo  1  2
Banner
Intersticial
Premiado
Intersticial premiado
Nativo  1  3
1 A integração de lances está em versão Beta fechada.

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

  • Concluir o Guia explicativo de 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

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 à 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 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 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 do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador da Mintegral:

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

Integração manual

  1. Para incluir o SDK da Mintegral, acesse SDK da 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 as configurações de privacidade no SDK da Mintegral

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 solicitar 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

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

O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Mintegral. Defina essas opções antes de 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)

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) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 a seguir mostra como transmitir informações de consentimento para o SDK da Mintegral. Se você precisar chamar esse método, chame-o depois de inicializar o SDK dos anúncios para dispositivos móveis do Google mas antes de solicitar anúncios por meio do SDK.

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 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 na Ad Manager interface.

Anúncios nativos

Renderização do anúncio

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

Campo Recursos sempre incluídos pelo adaptador da Mintegral
Título
Imagem 1
Body
Icon
Call-to-action
Star rating
Armazenar
Preço
Advertiser

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

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, verifique o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponse() nas seguintes classes:

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

Veja os códigos e as mensagens associadas geradas pelo adaptador da 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 aplicativo 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 Resposta de lance 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 aplicativo 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 do Android 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 com o SDK da Mintegral 16.6.41 verificada.

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 com o SDK da Mintegral 16.6.34 verificada.

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

  • Agora é possível usar lances 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.6.0.
  • Versão 16.5.91 do SDK da Mintegral.

Versão 16.5.91.0

  • Compatibilidade com o SDK da Mintegral 16.5.91 verificada.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 com o SDK da Mintegral 16.5.51 verificada.

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 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 com o SDK da Mintegral 16.5.21 verificada.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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

  • Adicionado suporte a marca d'água para anúncios de lances.
  • Compatibilidade com o SDK da Mintegral 16.5.11 verificada.

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 16.4.81 do SDK da Mintegral.

Versão 16.4.71.0

  • Compatibilidade com o SDK da Mintegral 16.4.71 verificada.

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 com o SDK da Mintegral 16.4.61 verificada.

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 16.4.51 do SDK da Mintegral.

Versão 16.4.41.0

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

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

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 compatibilidade com hierarquia para formatos de banner (inclui MREC), intersticiais, premiados e nativos.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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.
  • Adição de compatibilidade de lances para formatos de anúncios de banner (inclui MREC), intersticiais, premiados e nativos.

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.