Integrar a Mintegral com a mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios de display da Mintegral usando mediação, incluindo integrações de lances e em hierarquia. Ele explica 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 aceitos

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

Integração
Lances	^1
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

¹ A integração de lances está em versão Beta aberta.

Requisitos

• API Android nível da API 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da Mintegral 16.5.91.1 ou uma versão mais recente (recomendamos usar a última versão)

• Mais recente GMA Next-Gen SDK.

• Leia todo o guia para iniciantes da mediação .

Etapa 1: definir as configurações na interface da Mintegral

Crie uma conta ou faça login na sua conta da Mintegral.

Encontrar a chave do app

Acesse a guia APP Setting e anote a APP Key.

Adicionar um novo aplicativo

Na guia APP Setting, clique no botão Add APP.

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

Anote o APP ID do aplicativo.

Criar uma posição do anúncio

Depois que o aplicativo for criado, acesse a guia Placements &Units e clique no botão Add Placement , conforme mostrado abaixo, para criar a posição do anúncio.

Insira um Placement Name e um AD Format.

Importante: Para o formato de anúncio nativo, selecione Native (Custom Rendering) como o Formato do anúncio.

Selecione Header Bidding como o Bidding Type. Preencha o restante do formulário e clique em Save.

Depois que a posição do anúncio for criada, anote o Placement ID.

Clique no menu suspenso 1 AD Units e anote o AD Unit ID.

Localizar a chave da API Reporting da Mintegral

Lances

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

Cascata

Você vai precisar da chave da API Reporting da Mintegral para configurar o ID do bloco de anúncios do Ad Manager. Acesse Account > API Tools. Anote o Skey e a Secret.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar app-ads.txt na Mintegral, consulte Como o app-ads.txt pode ajudar a combater a fraude de anúncios.

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

Faça login na sua conta do Ad Manager.

Adicionar a Mintegral em Empresas

Lances

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

Cascata

Acesse Admin > Companies e clique no botão New company na guia All companies. Selecione rede de publicidade.

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

Não é necessário inserir um Username ou Password. Clique em Save quando terminar.

Ativar o compartilhamento de indicador seguro

Lances

Acesse Admin > Global settings. Acesse a guia Ad Exchange account settings e ative a opção Compartilhamento de indicador seguro. Clique em Save.

Cascata

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

Compartilhar indicadores seguros em solicitações de lance

Lances

Acesse Inventory > Secure Signals. Em Secure signals, pesquise Mobvista/Mintegral e ative a opção Enable app integration.

Clique em Save.

Cascata

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

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Lances

Acesse Delivery > Demand channel settings. Na guia Default settings, ative a opção Allow secure signal sharing para Lances do SDK.

Clique em Save.

Cascata

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

Configurar os lances da Mintegral

Lances

Acesse Delivery > Bidders e clique em Lances do SDK.

Clique em New bidder.

Selecione Mintegral como o bidder.

Clique em Continue para ativar os Lances do SDK para esse bidder.

Clique em Concluído.

Cascata

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

Configurar o mapeamento de blocos de anúncios

Lances

Acesse Delivery > Bidders e clique em Lances do SDK.

Selecione a empresa da Mintegral.

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

Escolha bloco de anúncios específico. Selecione um bloco e um formato de anúncios, Mobile app como o tipo de inventário e seu Mobile application. Em seguida, insira App Key, App ID, Placement ID e Ad Unit ID vistos na seção anterior.

Por fim, clique em Save.

Importante: segmente o bloco de anúncios selecionado por pelo menos um grupo de rendimento. O App ID e a App Key precisam ser associados ao app segmentado, como na interface da Mintegral.

Cascata

Acesse Delivery > Yield groups e clique no botão New yield group. Selecione seu Mobile application.

Role a página para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para a Mintegral na seção anterior. Escolha Mobile SDK mediation como o Integration type, Android como a Platform e Active como o Status.

Insira a App Key, o App ID, o Placement ID e o Ad Unit ID vistos na seção anterior, além do valor Default CPM. Clique em Save.

**Importante** :o **App ID** e a **App Key** precisam ser associados ao app segmentado, como na interface da Mintegral.

Adicionar a Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Importante: verifique se você tem permissão de gerenciamento da conta para concluir a configuração do consentimento da UE e do GDPR, das regulamentações estaduais dos EUA e da plataforma de mensagens de usuários. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Mobvista/Mintegral à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador da Mintegral

Observação: a falha na integração das versões compatíveis do SDK da Mintegral e do GMA Next-Gen SDK pode causar problemas de build.

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")
    }
  }
}

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.91.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

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

2. Navegue até os artefatos do adaptador da 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 configurações de privacidade no SDK da Mintegral

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

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

O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Mintegral. Essas opções precisam ser definidas antes de você inicializar GMA Next-Gen SDK 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 de privacidade dos estados 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 com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga 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 a esse SDK.

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, faça isso depois de inicializar GMA Next-Gen SDK mas antes de solicitar anúncios por ele.GMA Next-Gen 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

Certifique-se de registrar seu dispositivo de teste para Ad Manager.

Para receber anúncios de teste da Mintegral para banners, intersticiais, anúncios premiados e nativos, a Mintegral recomenda usar as chaves do app, os IDs do app, os IDs de posição e os IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.

**Importante** :desative o modo de teste do Ad Manager e da Mintegral antes de lançar o app.

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 originais de anúncios Mintegral (lances) e Mintegral (hierarquia).

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

Anúncios nativos

Renderização do anúncio

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

Campo	Recursos sempre incluídos pelo adaptador da Mintegral
Título
Imagem	1
Corpo
Ícone
Call-to-action
Classificação por estrela
Repositório
Preço
Advertiser

¹ O adaptador da 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, verifique o erro na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

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

Confira os códigos e as mensagens correspondentes gerados 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 app ou ID de posição ausente).
102	com.google.ads.mediation.mintegral	O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela 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 preenchimento.