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 i-mobile a um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador para dispositivos móveis ao um Android app.
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 para i-mobile tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- API do Android de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir a mediação Guia explicativo
Etapa 1: configurar a interface do i-mobile
Inscreva-se ou faça login na sua conta do i-mobile.
Para adicionar o 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 no Guia サイト/アプリ管理 (Gerenciamento de site/aplicativos).
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 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 de editor), メディアID (ID de mídia), e ットID (ID do Spot). Você vai precisar desses parâmetros mais tarde ao configurar i-mobile para mediação na interface da AdMob.
Android
iOS
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 (recomendada)
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
no nível do app, adicione o seguinte:
dependências e configurações de implementação. Use as versões mais recentes do
SDK e adaptador para i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.4.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integração manual
Faça download da versão mais recente do SDK do i-mobile e extrair o
android-ad-sdk.aar
na pastasdk
e adicione ao seu projeto.Acesse 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 necessá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 em Ad Manager A i-mobile fornece ID do Spot, ID de mídia e ID do editor de teste para testes. É possível encontrá-los aqui.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do i-mobile, ative os testes de uma única origem no Ad Inspector usando as i-mobile (Waterfall) origens de anúncios.
Etapas opcionais
Usar anúncios nativos
Renderização do anúncio
O adaptador i-mobile preenche os seguintes
para um
NativeAd
.
Campo | Recursos sempre incluídos pelo adaptador para 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 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 podem verificar o erro subjacente a partir 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. Veja o código para mais detalhes. |
101 | O i-mobile requer 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. |
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 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
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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 para i-mobile v2.3.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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 para 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 necessário da API do Android 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.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
- 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.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
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 para i-mobile v2.0.22.
- O adaptador foi atualizado para oferecer suporte a solicitações de banner adaptativo 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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
- Foi adicionado suporte a anúncios de banner, intersticiais e nativos.