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, incluindo integrações em hierarquia e de lances. 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 Unity.

Integrações e formatos de anúncio aceitos

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

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

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

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 aceitos em lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para Mintegral 1.4.0 ou uma versão mais recente (recomendamos usar a última versão).
  • Para implantar no Android:
    • API Android nível 23 ou mais recente.
  • Para implantar 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.
  • Leia todo o guia para iniciantes da mediação.

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

Acesse a guia APP Setting e anote a APP Key.

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, acesse a guia Posições e unidades e clique no botão Adicionar posição, conforme mostrado abaixo, para criar sua posição de anúncio.

Android

iOS

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

Importante: para o formato de anúncio nativo, selecione Nativo (renderização personalizada) como o 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 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 do Ad Manager. Acesse Conta > Ferramentas de API. Anote a 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 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 do Ad Manager

Definir 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 a 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 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 dos anúncios para dispositivos móveis do Google pode causar problemas de build.

OpenUPM-CLI

Importante: se você está migrando de um .unitypackage para usar 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, 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

Importante: se você usava .unitypackage e está migrando para OpenUPM, desinstale 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 Configurações do gerenciador de pacotes do Unity.

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

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

Selecione o pacote Mediação do Google Mobile Ads Mintegral e clique em Instalar.

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 mudanças 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.

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.

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

Registre seu dispositivo de teste no Ad Manager.

Para receber anúncios de teste da Mintegral em 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.

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 origens de anúncios Mintegral (lances) 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 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 mostrou 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.5

• Compatível com a versão 16.9.91.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.9.0 do adaptador iOS da Mintegral.
• Criado e testado com a versão 10.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.9.4

• Compatível com a versão 16.9.81.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.8.0 do adaptador da Mintegral para iOS.
• Criado e testado com a versão 10.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.9.3

• Suporte à versão 16.9.71.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.8.0 do adaptador da Mintegral para iOS.
• Criado e testado com a versão 10.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.9.2

• Suporte à versão 16.9.71.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.7.0 do adaptador iOS da Mintegral.
• Criado e testado com a versão 10.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.9.1

• Compatível com a versão 16.9.61.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.7.0 do adaptador iOS da Mintegral.
• Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.9.0

• Compatível com a versão 16.9.51.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.7.0 do adaptador iOS da Mintegral.
• Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.8.4

• Compatível com a versão 16.8.61.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.5.0 do adaptador iOS da Mintegral.
• Criado e testado com a versão 9.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 1.8.3

• Compatível com a versão 16.8.61.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.3.0 do adaptador iOS da Mintegral.
• 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

• Compatível com a versão 16.8.61.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.7.2.1 do adaptador do iOS da Mintegral.
• 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

• Compatível com a versão 16.8.51.0 do adaptador do Android da Mintegral.
• Compatível com a versão 7.7.2.0 do adaptador do iOS da Mintegral.
• 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

• Compatível com a versão 16.8.31.0 do adaptador do Android da Mintegral.
• Compatível com a versão 7.7.0.0 do adaptador iOS da Mintegral.
• 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
• Compatível com a versão 16.8.11.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.6.9.0 do adaptador do iOS da Mintegral.
• 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 à versão 16.7.81.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.6.8.0 do adaptador da 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 do Android da Mintegral.
• Compatível com a versão 7.6.7.0 do adaptador do iOS da Mintegral.
• 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 para a versão 16.7.41.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.6.6.0 do adaptador iOS da Mintegral.
• 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 para a versão 16.7.41.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.6.4.0 do adaptador do iOS da Mintegral.
• 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 para a versão 16.7.21.0 do adaptador do Android da Mintegral.
• Compatível com a versão 7.6.3.0 do adaptador do iOS da Mintegral.
• 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 do Android da Mintegral.
• Compatível com a versão 7.6.2.0 do adaptador do iOS da Mintegral.
• 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

• Compatível com a versão 16.6.71.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.6.0.0 do adaptador iOS da Mintegral.
• 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

• Compatível com a versão 16.6.34.0 do adaptador do Android da Mintegral.
• Compatível com a versão 7.5.6.0 do adaptador iOS da Mintegral.
• 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

• Compatível com a versão 16.5.91.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.5.3.0 do adaptador iOS da Mintegral.
• 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

• Compatibilidade com a versão 16.4.61.0 do adaptador Android da Mintegral.
• Compatível com a versão 7.3.8.0 do adaptador da Mintegral para iOS.
• 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

• Conteúdo do adaptador movido para GoogleMobileAds/Mediation/Mintegral/.
• Suporte à versão 16.4.41.0 do adaptador do Android da Mintegral.
• Compatível com a versão 7.3.6.0 do adaptador do iOS da Mintegral.
• 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

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

Versão 1.0.0

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