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 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 Ad Manager 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 explicativo de mediação
Etapa 1: definir configurações na interface do i-mobile
Inscreva-se ou faça login na sua conta do i-mobile.
Para adicionar seu app ao painel do i-mobile, clique 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 de anúncio) e clique no botão 新規広告スポット (Novo espaço de anúncio).
Em seguida, preencha o formulário inserindo 広告分ット名 (nome do espaço de anúncio), 広告分分ットサイズ (tamanho do espaço de 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 da AdMob.
Android
iOS
Etapa 2: configurar a interface do i-mobile demand Ad Manager
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 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.imobile
OpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.
Na guia Registros com escopo, 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 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
Importar.
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
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 Ad Manager estão ausentes ou 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. Confira 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
- Compatível com o adaptador para Android i-mobile versão 2.3.2.0.
- 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
- 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.
- Compatível com o adaptador para iOS i-mobile versão 2.3.0.1.
- 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
- Oferece suporte ao adaptador para Android i-mobile versão 2.3.0.0.
- Suporte para a versão 2.3.0.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 7.3.1.
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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
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 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.