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, cobrindo integrações de leilão e de lances. Ele aborda como adicionar o Mintegral à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Mintegral a um app do Unity.
Integrações e formatos de anúncio compatíveis
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 | |
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 com suporte nos 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 (recomenda-se a versão mais recente).
- Para implantar no Android
- API do Android de 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 configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Conclua o Guia para iniciantes da 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
Acesse a guia Configuração da APP e anote a chave da 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.
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.
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 do Ad Manager. Navegue até Account > API Tools. Anote a chave S e a chave secreta.
Etapa 2: configurar a demanda da Mintegral na interface do Ad Manager
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 ver as instruções, consulte a etapa 2 no guia para iOS.
Adição da Mobvista/Mintegral à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações de regulamentações europeias e Configurações de 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
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação Mintegral para Unity do Google Mobile Ads no seu projeto executando o comando abaixo no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.mintegralOpenUPM
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 do 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 no Ad Manager.
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 de app, IDs de app, IDs de posicionamento e IDs de bloco de anúncios fornecidos na página de ID 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 (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.4
- Suporte à versão 16.8.61.0 do adaptador Mintegral para Android.
- Suporte ao adaptador Mintegral para iOS versão 7.7.5.0.
- 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
- 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
DummyClientfoi renomeado comoPlaceholderClient- Suporte ao adaptador Mintegral para Android versão 16.8.11.0.
- Suporte para a versão 7.6.9.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.5
- Suporte para a versão 16.7.81.0 do adaptador Mintegral para Android.
- Suporte ao adaptador Mintegral para iOS versão 7.6.8.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.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 à versão 16.7.21.0 do adaptador Mintegral para Android.
- 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 ao adaptador Mintegral para iOS versão 7.5.6.0.
- 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.