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 da AdMob, 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.

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ços de anúncios) 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 as informações de パ리リッねーID (ID do editor), メディアID (ID de 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 AdMob interface

Etapa 3: importar o SDK e o adaptador i-mobile

Integração com o Android Studio (recomendado)

No arquivo settings.gradle.kts no nível 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

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 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 o ID do Spot, o ID da mídia e o ID do editor de teste para testes. Encontre-os 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 descrições de campos avançados de anúncios nativos para um NativeAd.

¹ Para anúncios nativos, o SDK i-mobile não fornece um recurso de ícone de 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:

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

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

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