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 |
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.
![](https://developers.google.cn/admob/images/mediation/mintegral/new_application_Android.png?authuser=19&hl=pt)
Anote o ID do app do seu aplicativo.
![](https://developers.google.cn/admob/images/mediation/mintegral/app_id_Android.png?authuser=19&hl=pt)
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.
![](https://developers.google.cn/admob/images/mediation/mintegral/create_placement_Android.png?authuser=19&hl=pt)
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.
![](https://developers.google.cn/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=19&hl=pt)
Clique no menu suspenso 1 AD Units e anote o ID do bloco de anúncios.
![](https://developers.google.cn/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=19&hl=pt)
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
Integração com o Android Studio (recomendado)
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
Para incluir o SDK da Mintegral, acesse SDK da Mintegral para Android.
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
Consentimento da UE e GDPR
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. A 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 os seguintes campos:
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. |
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 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.
- 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
- Foi adicionada a 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 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 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.
- 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.