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 de hierarquia 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 AdMob adaptador de mediação da Mintegral tem os seguintes recursos:
| Integração | ||
|---|---|---|
| Lances | 1 | |
| Cascata | 2 | |
| Formatos | ||
| Abertura do aplicativo | 1 2 | |
| Banner | ||
| Intersticial | ||
| Premiado | ||
| Intersticial premiado | ||
2 A integração de lances com esse formato está na versão Beta fechada.
Requisitos
- Unity 5.6 ou mais recente
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Para implantar no Android
- Android API de nível 19 ou mais recente
- Para implantar no iOS:
- Meta 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.
- Concluir o Guia explicativo sobre 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
Navegue até a guia Configuração do app e anote a chave do app.
Adicionar um novo aplicativo
Na guia Configuração do aplicativo, clique no botão Adicionar aplicativo.
Selecione a Plataforma e preencha o restante do formulário. Em seguida, clique em Salvar.
Android
iOS
Anote o ID do app do seu aplicativo.
Android
iOS
Criar um posicionamento do anúncio
Depois de criar o aplicativo, navegue até a guia Canais e blocos e clique no botão Adicionar posição, conforme mostrado abaixo, para criar um canal do anúncio.
Android
iOS
Insira um Nome da posição 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 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 AD Units e anote o ID do bloco de anúncios.
Android
iOS
Localizar sua chave de API de relatórios da Mintegral
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Você vai precisar da sua chave da API Mintegral Reporting para configurar o AdMob ID do bloco de anúncios. Navegue até Conta > Ferramentas de API. Anote o Skey e o Secret.
Etapa 2: configurar a demanda da Mintegral na AdMob interface
Definir as configurações de mediação para seu bloco de anúncios
Android
Para conferir 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 das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Mintegral à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.
Etapa 3: importar o SDK e o adaptador da Mintegral
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 a Mintegral no link de download no Registro de mudanças (link em inglês) e extraia o GoogleMobileAdsMintegralMediation.unitypackage do arquivo ZIP.
No editor de projetos 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 > Play Services Resolver > Android Resolver > Force
Resolve. A biblioteca do resolvedor do Play Services do Unity executará a resolução
de dependências do zero e copiará as dependências declaradas para o
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 (link em inglês)
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 em AdMob
Para fazer o teste da Mintegral com anúncios de banner, intersticiais, premiados e nativos, a Mintegral recomenda o uso das chaves de app, dos IDs do app, da posição e do bloco de anúncios fornecidos na Página de ID do teste da Mintegral.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Mintegral, ative os testes de uma única origem no Ad Inspector usando as Mintegral (Bidding) and Mintegral (Waterfall) origens de anúncios.
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
Veja os códigos e as mensagens associadas geradas 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 aplicativo ou 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 aplicativo ou 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. |
Registros de alterações do plug-in de mediação do Unity da Mintegral
Versão 1.4.0
- Compatível com a versão 16.6.34.0 do adaptador Android da Mintegral.
- Compatível com o adaptador Mintegral para iOS versão 7.5.6.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.7.0.
Versão 1.3.0
- Compatível com a versão 16.5.91.0 do adaptador Android da Mintegral.
- Compatível com o 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 o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 1.2.1
- Compatível com a versão 16.4.61.0 do adaptador Android da Mintegral.
- Compatível com o adaptador Mintegral para iOS versão 7.3.8.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.3.0.
Versão 1.2.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/Mintegral/. - Compatível com a versão 16.4.41.0 do adaptador Android da Mintegral.
- Compatível com o adaptador Mintegral para iOS versão 7.3.6.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.3.0.
Versão 1.1.0
- Compatível com a versão 16.3.61.0 do adaptador Android da Mintegral.
- Compatível com o adaptador Mintegral para iOS versão 7.2.9.1.
- 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!
- Compatível com a versão 16.2.61.0 do adaptador Android da Mintegral.
- Compatível com o adaptador Mintegral para iOS versão 7.2.6.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.1.