Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da 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 Android app.
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 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 para i-mobile tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- Android API de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir o Guia explicativo de mediação
Etapa 1: definir as 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.
Preencha o formulário e clique no botão 新規登録 (Inscrever-se).
Para criar um novo espaço de publicidade, selecione seu app na guia サイト/アプリ管理 (Site/Application Management).
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 新規登録 (Sign up).
Seu novo espaço de anúncio está pronto. Para exibir os detalhes de integração, clique no botão アプリ號定取得 (Obter configurações do aplicativo).
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.
Etapa 2: configurar a demanda de dispositivos móveis na Ad Manager interface
Etapa 3: importar o SDK e o adaptador i-mobile
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
do projeto, adicione os seguintes
repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Em seguida, no arquivo build.gradle.kts
do app, adicione as
dependências e configurações de implementação abaixo. Use as versões mais recentes do
SDK e do adaptador i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integração manual
Faça o download da versão mais recente do SDK i-mobile, extraia o
android-ad-sdk.aar
na pastasdk
e adicione ao projeto.Navegue até os artefatos do adaptador i-mobile no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo
.aar
do adaptador i-mobile e adicione-o ao projeto.
Etapa 4: adicionar o código obrigatório
Nenhum código adicional é necessário para a integração com o i-mobile.
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).
Etapas opcionais
Como usar anúncios nativos
Renderização do anúncio
O adaptador para i-mobile preenche as seguintes
campos
para uma
NativeAd
.
Campo | Recursos sempre incluídos pelo adaptador i-mobile |
---|---|
Título | |
Imagem | |
Corpo | |
Ícone do app | 1 |
Call-to-action | |
Star rating | |
Loja | |
Preço |
1 Para anúncios nativos, o SDK para i-mobile não fornece um recurso de ícone do app. Em vez disso, o adaptador para i-mobile preenche o ícone do app com uma imagem transparente.
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.getAdapterResponses()
nas seguintes classes:
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 |
Confira os códigos e as mensagens exibidas pelo adaptador i-mobile quando um anúncio não é carregado:
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 de carregamento de anúncios nativos do i-mobile retornou uma lista de anúncios nativos vazia. |
Registro de alterações do adaptador de mediação do i-mobile para Android
Versão 2.3.2.0
- Compatibilidade verificada com o SDK para i-mobile v2.3.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do IMobile versão 2.3.2.
Versão 2.3.1.2
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.
- Compatibilidade verificada com o SDK i-mobile v2.3.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.1.1
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.1.0
- Compatibilidade verificada com o SDK i-mobile v2.3.1.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.0.0
- Compatibilidade verificada com o SDK i-mobile v2.3.0.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
- SDK do IMobile versão 2.3.0.
Versão 2.0.23.1
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.0.0.
- O nível mínimo de API do Android necessário foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do IMobile versão 2.0.23.
Versão 2.0.23.0
- Compatibilidade verificada com o SDK para i-mobile v2.0.23.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.5.0.
Desenvolvido e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- SDK do IMobile versão 2.0.23.
Versão 2.0.22.2
- Foram adicionados códigos e mensagens de erro padronizados do adaptador.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.1.0.
Desenvolvido e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.22.1
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.0.0.
Desenvolvido e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.22.0
- Compatibilidade verificada com o SDK i-mobile v2.0.22.
- O adaptador foi atualizado para oferecer suporte a solicitações de banners adaptativos inline.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.21.0
- Compatibilidade verificada com o SDK do i-mobile v2.0.21.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.1.0.
- Adição de suporte para dimensionamento de anúncios de banner adaptativo.
Desenvolvido e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do IMobile versão 2.0.21.
Versão 2.0.20.2
- Adição de suporte a tamanhos flexíveis de anúncios de banner.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.3.0.
Desenvolvido e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK do IMobile versão 2.0.20.
Versão 2.0.20.1
- O adaptador agora retorna uma proporção de
mediaContent
diferente de zero.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
- SDK do IMobile versão 2.0.20.
Versão 2.0.20.0
- Versão inicial.
- Suporte adicionado para anúncios de banner, intersticiais e nativos.