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
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 site/aplicativos) e no botão para a plataforma do seu app.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/select_platform_Android.png?authuser=9&hl=pt)
Preencha o formulário e clique no botão Subscribe規號 (Inscrever-se).
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/add_app_name_Android.png?authuser=9&hl=pt)
Para criar um novo Spot de publicidade, selecione seu app na guia サイト/アプリ管理 (gerenciamento de site/aplicativo).
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/app_list_Android.png?authuser=9&hl=pt)
Navegue até a guia 広告でット管理 (Gerenciamento de espaço de anúncio) e clique no botão prompt 規広告ット (Novo espaço de anúncio).
Em seguida, preencha o formulário, fornecendo o 広告ででットト (nome do espaço do anúncio), 広告まットサイズ (tamanho do espaço do anúncio) e a outros detalhes. Em seguida, clique no botão ว規órico (Inscrever-se).
Seu novo espaço de anúncio está pronto. Para conferir os detalhes da integração, clique no botão アプリา定取得 (Obter configurações do app).
Anote o パ전リッンャーID (ID do editor), o メディアID (ID da mídia) e o パנットID (ID do local). Você vai precisar desses parâmetros mais tarde ao configurar i-mobile para mediação na interface Ad Manager .
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=9&hl=pt)
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
Faça login na sua conta do Ad Manager.
Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.
Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis ao qual você quer adicionar a mediação.
Em seguida, clique no botão Adicionar parceiro de rendimento.
Se você já tiver um Parceiro de rendimento para i-mobile, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.
Selecione i-mobile como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.
Ative a Coleta de dados automática e insira o Login name and API Password
Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Publisher ID, Media ID and Spot ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.
Clique em Salvar na parte inferior da página quando terminar.
Etapa 3: importar o SDK e o adaptador para dispositivos móveis
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
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.