Integrar i-mobile com Mediação

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. Ela 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 Android .

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:

Requisitos

• API do Android 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 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 sites/aplicativos) 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 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.

Etapa 2: configurar a interface do i-mobile demand Ad Manager

Etapa 3: importar o SDK e o adaptador para dispositivos móveis

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 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

1. Faça o download da versão mais recente do SDK i-mobile, extraia o android-ad-sdk.aar na pasta sdk e adicione ao projeto.

2. 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 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 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

Usar anúncios nativos

Renderização do anúncio

O adaptador i-mobile preenche os seguintes para um NativeAd.

¹ 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 da resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

Confira os códigos e as mensagens exibidas pelo adaptador i-mobile quando um anúncio não é carregado:

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 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.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
• 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 e targetSdkVersion 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 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

• 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.

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.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.
• Agora é possível dimensionar 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

• Suporte adicionado para tamanhos de anúncio de banner flexíveis.
• 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 mediaContent diferente de zero.

Desenvolvido 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.