Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios do i-mobile usando mediação, cobrindo integrações em hierarquia. Ele aborda como adicionar o i-mobile à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do i-mobile a um app Unity.
A interface do painel para i-mobile usa texto em japonês nos rótulos, botões e descrições. As capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções deste guia, os rótulos e botões são traduzidos com os equivalentes em inglês entre parênteses.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação da AdMob para i-mobile tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
Requisitos
- Unity 5.6 ou mais recente
- SDK dos anúncios para dispositivos móveis do Google 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 do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes de mediação
Etapa 1: configurar a interface do i-mobile
Inscreva-se ou faça login na sua conta do i-mobile.
Adicione o app ao painel do i-mobile clicando na guia サイト／アプリ管理 (Site/Application Management) e no botão da plataforma do app.
Android
iOS
Preencha o formulário e clique no botão 新規登録 (Inscrever-se).
Android
iOS
Para criar um novo espaço de publicidade, selecione seu app na guia サイト／アプリ管理 (Site/Application Management).
Android
iOS
Navegue até a guia 広告スポット管理 (Gerenciamento de espaço publicitário) e clique no botão 新規広告スポット (Novo espaço publicitário).
Em seguida, preencha o formulário com o 広告スポット名 (nome do espaço do anúncio), 広告スポットサイズ (tamanho do espaço do anúncio) e outros detalhes. Em seguida, clique no botão 新規登録 (Sign up).
Seu novo espaço de anúncio está pronto. Para conferir os detalhes da integração, clique no botão アプリ設定取得 (Get App settings).
Anote o パブリッシャーID (ID do editor), メディアID (ID da mídia) e スポットID (ID do spot). Você vai precisar desses parâmetros mais tarde ao configurar o i-mobile para mediação na interface do AdMob.
Android
iOS
Etapa 2: configurar a demanda de i-mobile 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 ver as instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador i-mobile
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação i-mobile do Google Mobile Ads para Unity no seu projeto executando o comando abaixo no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.imobileOpenUPM
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 i-mobile 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
i-mobile no link de download no
Changelog
e extraia o
GoogleMobileAdsIMobileMediation.unitypackage do arquivo
zip.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o
arquivo GoogleMobileAdsIMobileMediation.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: código adicional necessário
Android
Nenhum código adicional é necessário para a integração com o i-mobile.
iOS
Integração da SKAdNetwork
Siga a documentação da i-mobile
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. O i-mobile fornece ID do spot, ID da mídia e ID do editor para testes. Eles podem ser encontrados aqui.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da i-mobile, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios i-mobile (hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio do i-mobile, os editores poderão verificar o
erro subjacente da resposta do anúncio usando ResponseInfo
nas seguintes classes:
Android
| Formato | Nome da classe |
|---|---|
| Banner | com.google.ads.mediation.imobile.IMobileAdapter |
| Intersticial | com.google.ads.mediation.imobile.IMobileAdapter |
| Nativo | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| Formato | Nome da classe |
|---|---|
| Banner | IMobileAdapter |
| Intersticial | IMobileAdapter |
| Nativo | GADMediationAdapterIMobile |
Confira os códigos e as mensagens exibidas pelo adaptador i-mobile quando um anúncio não é carregado:
Android
| Código do erro | Motivo |
|---|---|
| 0-99 | O SDK i-mobile retornou um erro. Consulte o código para mais detalhes. |
| 101 | O i-mobile exige um contexto Activity para carregar anúncios. |
| 102 | Os parâmetros do servidor i-mobile configurados na interface da AdMob estão ausentes ou são inválidos. |
| 103 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile. |
| 104 | O callback de sucesso de carregamento de anúncios nativos do i-mobile retornou uma lista de anúncios nativos vazia. |
iOS
| Código do erro | Motivo |
|---|---|
| 0-10 | O SDK i-mobile retornou um erro. Consulte o código para mais detalhes. |
| 101 | Os parâmetros do servidor i-mobile configurados na interface da AdMob estão ausentes ou são inválidos. |
| 102 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile. |
| 103 | O i-mobile não conseguiu apresentar um anúncio. |
| 104 | O i-mobile retornou uma matriz de anúncios nativos vazia. |
| 105 | Não foi possível fazer o download de recursos de anúncios nativos no i-mobile. |
| 106 | O i-mobile não oferece suporte a solicitações de vários anúncios intersticiais usando o mesmo ID de spot. |
Registro de alterações do plug-in de mediação Unity para i-mobile
Versão 1.3.6
- Suporte para a versão 2.3.2.0 do adaptador Android i-mobile.
- Suporte para a versão 2.3.4.1 do adaptador iOS i-mobile.
- 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.3.5
- Suporte para a versão 2.3.2.0 do adaptador Android i-mobile.
- Suporte para a versão 2.3.4.0 do adaptador iOS i-mobile.
- 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.3.4
- Suporte para a versão 2.3.1.2 do adaptador Android i-mobile.
- Suporte para a versão 2.3.4.0 do adaptador iOS i-mobile.
- 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.3.3
- Suporte à versão 2.3.1.1 do adaptador Android i-mobile.
- Suporte para a versão 2.3.3.0 do adaptador iOS i-mobile.
- 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.3.2
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/IMobile/. - Suporte à versão 2.3.1.1 do adaptador Android i-mobile.
- Suporte para a versão 2.3.2.0 do adaptador iOS i-mobile.
- Criado e testado com a versão 8.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.1
- Suporte para a versão 2.3.0.0 do adaptador Android i-mobile.
- Suporte para a versão 2.3.0.1 do adaptador iOS i-mobile.
- 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.3.0
- Suporte para a versão 2.3.0.0 do adaptador Android i-mobile.
- Suporte para o adaptador iOS i-mobile versão 2.3.0.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.
Versão 1.2.2
- Suporte ao adaptador Android i-mobile versão 2.0.23.1.
- Suporte para a versão 2.2.0.1 do adaptador iOS i-mobile.
- Criado e testado com a versão 7.0.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.1
- Suporte à versão 2.0.23.0 do adaptador Android i-mobile.
- Suporte para a versão 2.2.0.1 do adaptador iOS i-mobile.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.0
- Suporte à versão 2.0.23.0 do adaptador Android i-mobile.
- Suporte para a versão 2.2.0.0 do adaptador iOS i-mobile.
Versão 1.1.0
- Suporte para o adaptador Android i-mobile versão 2.0.22.2.
- Suporte para a versão 2.1.0.1 do adaptador iOS i-mobile.
Versão 1.0.2
- Suporte à versão 2.0.22.0 do adaptador Android i-mobile.
- Compatível com a versão 2.0.32.0 do adaptador iOS i-mobile.
Versão 1.0.1
- Suporte para a versão 2.0.21.0 do adaptador Android i-mobile.
- Suporte ao adaptador iOS i-mobile versão 2.0.31.0.
Versão 1.0.0
- Primeira versão!
- Suporte à versão 2.0.20.1 do adaptador Android i-mobile.
- Suporte ao adaptador iOS i-mobile versão 2.0.29.0.