Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios do i-mobile usando mediação, cobrindo integrações de 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 para seus rótulos, botões e descrições. As capturas de tela neste guia não foram traduzidos. No entanto, nas descrições e instruções deste guia, os rótulos e são traduzidos com seus 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 a mediação Guia explicativo
Etapa 1: definir as configurações na interface do i-mobile
Etapa 2: configurar a demanda de dispositivos móveis na Ad Manager interface
Etapa 3: importar o SDK e o adaptador para dispositivos móveis
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
no nível do projeto, adicione o seguinte:
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.3.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. Selecionar a versão mais recente, baixar o i-mobile
.aar
do adaptador 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 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 de anúncios
O adaptador para i-mobile preenche o seguinte
campos
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 do 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 |
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador para i-mobile quando ocorre uma falha no carregamento de um anúncio:
Código do erro | Motivo |
---|---|
0-99 | O SDK para 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 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. |
Registro de alterações do adaptador de mediação para Android para i-mobile
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
- 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 para 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 exigida 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 versão 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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
- 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.
Criado 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 de erro e mensagens 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.
Criado 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.
Criado 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 para i-mobile v2.0.21.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.1.0.
- Agora é possível dimensionar anúncios de banner adaptativo.
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.21.
Versão 2.0.20.2
- Suporte adicionado para tamanhos de anúncio de banner flexíveis.
- 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.
Criado 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.
- Agora é possível usar anúncios intersticiais, nativos e de banner.