Integrar a Mintegral com a mediação

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 a mediação, abrangendo integrações em cascata 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 Unity.

Integrações e formatos de anúncio aceitos

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

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

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
    • Unity 5.6 ou mais recente
    • [Para lances]: para integrar todos os formatos de anúncio compatíveis em lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para Mintegral 1.4.0 ou mais recente (versão mais recente recomendada).
    • Para fazer a implantação no Android,
      • API do Android de nível 23 ou mais recente
    • Para fazer a implantação no iOS:
      • Destino de implantação do iOS 12.0 ou mais recente
    • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
    • Conclua o Guia de primeiros passos da mediação.

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

Inscreva-se ou faça login na sua conta da Mintegral.

Localizar a chave do app

Acesse a guia Configuração do APP e anote a chave do APP.

Adicionar um novo aplicativo

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

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

Android

iOS

Anote o ID do app do aplicativo.

Android

iOS

Criar uma posição de anúncio

Depois que o aplicativo for criado, navegue até a guia Posições e unidades e clique no botão Adicionar posição, conforme mostrado abaixo, para criar a posição de anúncio.

Android

iOS

Insira um Nome do canal e um Formato do anúncio.

Lances

Selecione Lances de cabeçalho como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

Cascata

Selecione Em cascata como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

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

Android

iOS

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

Android

iOS

Localizar sua chave da API Reporting da Mintegral

Lances

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

Cascata

Você vai precisar da chave de API de relatórios da Mintegral para configurar o ID do bloco de anúncios da AdMob. Acesse Conta > Ferramentas de API. Anote a Skey e o Secret.

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é 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, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt na Mintegral, consulte Como o app-ads.txt pode ajudar a combater a fraude publicitária.

Etapa 2: configurar a demanda da Mintegral na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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

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

Etapa 3: importar o SDK e o adaptador da Mintegral

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação da Mintegral dos anúncios para dispositivos móveis do Google no Unity:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Mediação da Mintegral com os anúncios para dispositivos móveis do Google e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para Mintegral usando o link de download no Registro de alterações e extraia o GoogleMobileAdsMintegralMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMintegralMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

Etapa 4: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação da Mintegral para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 5: testar a implementação

Ativar anúncios de teste

Verifique se você registrou seu dispositivo de teste na AdMob.

Para receber anúncios de teste da Mintegral para banners, intersticiais, anúncios premiados e nativos, a Mintegral recomenda usar as chaves de app, os IDs de app, os IDs de posição e os IDs de bloco de anúncios fornecidos na página de IDs 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 (Bidding) e Mintegral (Waterfall).

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

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

iOS

GADMediationAdapterMintegral

Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Mintegral quando um anúncio não é carregado:

Android

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

iOS

Código do erro Domínio Motivo
101 com.google.mediation.mintegral Parâmetros de servidor inválidos (por exemplo, ID do app ou ID 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 plug-in de mediação do Unity da Mintegral

Versão 1.9.3

Versão 1.9.2

Versão 1.9.1

Versão 1.9.0

Versão 1.8.4

Versão 1.8.3

Versão 1.8.2

Versão 1.8.1

Versão 1.8.0

Versão 1.7.0

Versão 1.6.5

Versão 1.6.4

Versão 1.6.3

Versão 1.6.2

Versão 1.6.1

Versão 1.6.0

Versão 1.5.0

Versão 1.4.0

Versão 1.3.0

Versão 1.2.1

Versão 1.2.0

Versão 1.1.0

Versão 1.0.0