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 mostrar anúncios da Mintegral usando a 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 Unity .

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

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

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

¹ A integração de lances está na Beta fechada (exceto para o formato de anúncio nativo na Beta aberta).

² A integração em hierarquia está na versão Beta fechada.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 5.6 ou mais recente
  • Para implantar no Android
    • API do Android de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto Unity funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo 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.

Android

iOS

Anote o ID do app.

Android

iOS

Criar uma posição de anúncio

Depois que a aplicação for criada, navegue até a guia Posicionamentos e unidades e clique no botão Adicionar posicionamento, conforme mostrado abaixo, para criar o posicionamento do anúncio.

Android

iOS

Insira um nome do canal e um formato de anúncio.

Importante: para o formato de anúncio nativo, selecione Nativo (Renderização personalizada) como 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 Tradicional 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.

Android

iOS

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

Android

iOS

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 da AdMob. Navegue até Account > API Tools. Anote a chave S e a chave secreta.

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

Configurar as configurações de mediação para o 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 Mintegral à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Siga as etapas em Configurações do GDPR e 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 da AdMob.

Etapa 3: importar o SDK e o adaptador da Mintegral

Observação: a falha na integração das versões compatíveis do Mintegral e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

OpenUPM-CLI

Importante: se você estiver migrando de um .unitypackage para o OpenUPM-CLI, desinstale manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/Mintegral.

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do Google Mobile Ads Mintegral para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

OpenUPM

Importante: se você estiver migrando de um .unitypackage para o OpenUPM, será necessário desinstalar manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/Mintegral.

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

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

• Nome: OpenUPM
• URL: https://package.openupm.com
• Escopo(s): com.google

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Selecione o pacote Google Mobile Ads Mintegral Mediation e clique em Install.

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para Mintegral no link de download no Changelog 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ê transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app Unity.

Etapa 4: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração com a 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

Registre seu dispositivo de teste na AdMob.

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 do app, IDs do app, IDs de posicionamento e IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.

Importante: desative o modo de teste da AdMob 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 origens de anúncios Mintegral (Mediação) e Mintegral (Hierarquia).

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, os editores poderão verificar o erro subjacente da 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 associadas gerados pelo adaptador Mintegral quando um anúncio não é carregado:

Android

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.

iOS

Código do erro	Domínio	Motivo
101	com.google.mediation.mintegral	Parâmetros do 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 Mintegral não conseguiu mostrar um anúncio.
104	com.google.mediation.mintegral	O tamanho do 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 da Mintegral para Unity

Versão 1.8.3

• Suporte à versão 16.8.61.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.7.3.0.
• Criado e testado com a versão 9.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.8.2

• Suporte à versão 16.8.61.0 do adaptador Mintegral para Android.
• Suporte à versão 7.7.2.1 do adaptador Mintegral para iOS.
• Criado e testado com a versão 9.2.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.8.1

• Suporte à versão 16.8.51.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.7.2.0.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.8.0

• Suporte à versão 16.8.31.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.7.0.0.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.7.0

• DummyClient foi renomeado como PlaceholderClient
• Suporte ao adaptador Mintegral para Android versão 16.8.11.0.
• Suporte ao adaptador Mintegral para iOS versão 7.6.9.0.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.5

• Suporte para a versão 16.7.81.0 do adaptador Mintegral para Android.
• Suporte para a versão 7.6.8.0 do adaptador Mintegral para iOS.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.4

• Suporte à versão 16.7.61.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.6.7.0.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.3

• Suporte à versão 16.7.41.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.6.6.0.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.2

• Suporte à versão 16.7.41.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.6.4.0.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.1

• Suporte ao adaptador Mintegral para Android versão 16.7.21.0.
• Suporte ao adaptador Mintegral para iOS versão 7.6.3.0.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.6.0

• Suporte à versão 16.7.11.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.6.2.0.
• Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.5.0

• Suporte à versão 16.6.71.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.6.0.0.
• Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.4.0

• Suporte à versão 16.6.34.0 do adaptador Mintegral para Android.
• Suporte para a versão 7.5.6.0 do adaptador Mintegral para iOS.
• Criado e testado com a versão 8.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.3.0

• Suporte ao adaptador Mintegral para Android versão 16.5.91.0.
• Suporte ao adaptador Mintegral para iOS versão 7.5.3.0.
• Os seguintes métodos foram adicionados à classe Mintegral:
  • SetConsentStatus(bool)
  • SetDoNotTrackStatus(bool)
• Criado e testado com a versão 8.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.2.1

• Suporte à versão 16.4.61.0 do adaptador Mintegral Android.
• Suporte ao adaptador Mintegral para iOS versão 7.3.8.0.
• Criado e testado com a versão 8.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.2.0

• O conteúdo do adaptador foi movido para GoogleMobileAds/Mediation/Mintegral/.
• Suporte à versão 16.4.41.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.3.6.0.
• Criado e testado com a versão 8.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.1.0

• Suporte à versão 16.3.61.0 do adaptador Mintegral Android.
• Suporte à versão 7.2.9.1 do adaptador Mintegral para iOS.
• Criado e testado com a versão 7.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.0.0

• Versão inicial!
• Suporte à versão 16.2.61.0 do adaptador Mintegral para Android.
• Suporte ao adaptador Mintegral para iOS versão 7.2.6.0.
• Criado e testado com a versão 7.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.