Integração do i-mobile com a Mediação

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

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

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

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