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 |
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 Posições e unidades e clique no botão Adicionar posição, conforme mostrado abaixo, para criar a posição 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
Integração com o Android Studio (recomendada)
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
Para incluir o SDK Mintegral, acesse o SDK Mintegral para Android.
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
Consentimento da UE e GDPR
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 deonAdClosed()
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.