Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir 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 para seus rótulos, botões e descrições. As capturas de tela deste 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 Ad Manager adaptador de mediação 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
- Android API 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 o artigo Começar para ver mais detalhes.
- Conclua a mediação Guia explicativo
Etapa 1: definir as configurações na interface do i-mobile
Inscreva-se ou faça login na sua conta do i-mobile.
Adicione seu app ao painel do i-mobile clicando na guia サイト/アプリ管理 (Gerenciamento de sites/aplicativos) 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 サイト/アプリ管理 (gerenciamento de site/aplicativo).
Android
iOS
Navegue até a guia 広告スポット管理 (Gerenciamento de espaço de anúncio) e clique no botão 新規広告スポット (Novo espaço de anúncio).
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 Ϧ分 (Inscrever-se).
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ê precisará desses parâmetros mais tarde ao configurar o i-mobile para mediação na interface da AdMob.
Android
iOS
Etapa 2: configurar a demanda de dispositivos móveis na Ad Manager 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
Etapa 3: importar o SDK e o adaptador do i-mobile
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação i-mobile dos anúncios para dispositivos móveis do Google 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 selecione My Registries no menu suspenso.
Selecione o pacote Mediação de anúncios para dispositivos móveis do Google em dispositivos móveis e clique em Instalar.
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 de projetos do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsIMobileMediation.unitypackage
que você salvou. 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: 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 para dispositivos móveis configurados na Ad Manager interface estão ausentes/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 no carregamento do anúncio nativo 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 Ad Manager estão ausentes ou 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 dos 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 ao adaptador iOS i-mobile versão 2.3.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.3.4
- Suporte para a versão 2.3.1.2 do adaptador Android i-mobile.
- Suporte ao adaptador iOS i-mobile versão 2.3.4.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.3.3
- Compatível com o adaptador para Android i-mobile versão 2.3.1.1.
- Suporte para a versão 2.3.3.0 do adaptador iOS i-mobile.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.
Versão 1.3.1
- Oferece suporte ao adaptador para Android i-mobile versão 2.3.0.0.
- 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.
- Compatível com o adaptador para 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
- Oferece suporte ao adaptador para Android i-mobile versão 2.0.23.0.
- Compatível com o adaptador para iOS i-mobile versão 2.2.0.1.
- 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
- Oferece suporte ao adaptador para Android i-mobile versão 2.0.23.0.
- Suporte para a versão 2.2.0.0 do adaptador i-mobile para iOS.
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
- Oferece suporte ao adaptador para Android i-mobile versão 2.0.22.0.
- 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.