Integrar i-mobile com Mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar o Google Mobile Ads SDK (Legacy) para carregar e exibir anúncios da i-mobile usando a mediação, abrangendo integrações em hierarquia. Ele explica como adicionar a i-mobile à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da i-mobile a um app Android.

A interface do painel da 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 aceitos

O adaptador de mediação da i-mobile tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • API Android nível 24 ou mais recente.

Etapa 1: definir as configurações na interface da i-mobile

Inscreva-se ou faça login na sua conta da i-mobile.

Clique na guia サイト／アプリ管理 (Gerenciamento de site/aplicativo) e no botão da plataforma do seu app para adicionar o app ao painel do i-mobile.

Preencha o formulário e clique no botão 新規登録 (Inscrever-se).

Para criar um novo espaço publicitário, selecione seu app na guia サイト／アプリ管理 (Gerenciamento de site/aplicativo).

Navegue até a guia 広告スポット管理 (Gerenciamento de espaços para anúncios) e clique no botão 新規広告スポット (Novo espaço para anúncio).

create_ad_spot

Em seguida, preencha o formulário com o 広告スポット名 (nome do espaço de anúncio), o 広告スポットサイズ (tamanho do espaço de anúncio) e outros detalhes. Em seguida, clique no botão 新規登録 (Inscrever-se).

new_ad_spot_form

Seu novo espaço de anúncio está pronto. Para conferir os detalhes da integração, clique no botão アプリ設定取得 (Get App settings).

ad_spot_list

Anote o ID do publisher (パブリッシャーID), o código da mídia (メディアID) e o ID do spot (スポットID). Você vai precisar desses parâmetros mais tarde ao configurar o i-mobile para mediação na interface do Ad Manager.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar o app-ads.txt para i-mobile, consulte as perguntas frequentes.

Etapa 2: configurar a demanda da i-mobile na interface do Ad Manager

Definir as configurações de mediação do 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 defina 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 a 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 automática de dados e insira o Nome de login e a Senha da API.

Depois de selecionar o Parceiro de rendimento, escolha Mediação de SDK para dispositivos móveis como Tipo de integração, Android como Plataforma e Ativo como Status. Insira o ID do publisher, o código da mídia e o ID do spot obtidos na seção anterior. Em seguida, insira um valor de CPM padrão.

Clique em Salvar na parte de baixo da página quando terminar.

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

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")
    }
  }
}

No arquivo Gradle do app, adicione as seguintes dependências de implementação:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

Integração manual

  1. Faça o download da versão mais recente do SDK da i-mobile, extraia o android-ad-sdk.aar na pasta sdk e adicione ao seu 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 da i-mobile e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

Carregar o anúncio com o contexto da atividade

Transmita o contexto Activity ao carregar formatos de anúncio de banner, intersticial, premiado e nativo.Sem o contexto da Activity, o carregamento de anúncios falhará.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager. A i-mobile oferece ID do spot, ID da mídia e ID do publisher para testes. Eles estão disponíveis 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

Como usar anúncios nativos

Renderização do anúncio

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

Campo Recursos sempre incluídos pelo adaptador i-mobile
Título
Imagem
Corpo
Ícone do app 1
Call-to-action
Classificação por estrela
Loja
Preço

1 Para anúncios nativos, o SDK da i-mobile não oferece 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 da i-mobile, os publishers poderão verificar o erro na 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

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

Código do erro Motivo
0-99 O SDK da i-mobile retornou um erro. Consulte o código para mais detalhes.
101 O i-mobile exige um contexto Activity para carregar anúncios.
102 Os parâmetros do servidor da i-mobile configurados na interface do Ad Manager estão ausentes ou são inválidos.
103 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela i-mobile.
104 O callback de sucesso do carregamento de anúncios nativos da i-mobile retornou uma lista vazia de anúncios nativos.
105 A solicitação tinha tratamento com restrição de idade, mas o SDK da i-mobile não pode receber indicadores com restrição de idade.

Registro de alterações do adaptador de mediação do i-mobile para Android

Versão 2.3.2.5

  • Fixe a dependência do adaptador do Kotlin em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA NextGen).
  • Corrigimos o comportamento de fallback em ramificações de falha com restrição de idade durante a inicialização de anúncios e as solicitações de carregamento de anúncios.

Criado e testado com:

  • Versão 25.4.0 do SDK do Google Mobile Ads.
  • Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
  • Versão 2.3.2 do SDK da i-mobile.

Versão 2.3.2.4

  • Filtre as solicitações com restrição de idade para o SDK i-mobile quando o novo AgeRestrictedTreatment for definido como CHILD.

Criado e testado com:

  • Versão 25.4.0 do SDK do Google Mobile Ads.
  • Versão 1.2.0 do SDK Next-Gen do Google Mobile Ads.
  • Versão 2.3.2 do SDK da i-mobile.

Versão 2.3.2.3

  • Filtre as solicitações com restrição de idade para o SDK i-mobile, porque ele não pode receber indicadores com restrição de idade.

Criado e testado com:

  • Versão 25.1.0 do SDK do Google Mobile Ads.
  • Versão 1.1.0 do SDK Next-Gen do Google Mobile Ads.
  • Versão 2.3.2 do SDK da iMobile.

Versão 2.3.2.2

  • Adicionamos uma propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
  • Migração de implementações de anúncios de banner, intersticiais e nativos da API antiga para a nova API.

Criado e testado com:

  • Versão 25.1.0 do SDK do Google Mobile Ads.
  • Versão 2.3.2 do SDK da iMobile.

Versão 2.3.2.1

  • Atualizamos o nível mínimo necessário da API Android para 23.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 24.0.0.

Criado e testado com:

  • Versão 24.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.2 do SDK da iMobile.

Versão 2.3.2.0

  • Compatibilidade verificada com o SDK da i-mobile v2.3.2.

Criado e testado com:

  • Versão 23.1.0 do SDK do Google Mobile Ads.
  • Versão 2.3.2 do SDK da i-mobile.

Versão 2.3.1.2

  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 23.0.0.
  • Compatibilidade verificada com o SDK da i-mobile v2.3.1.

Criado e testado com:

  • Versão 23.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.1 do SDK da i-mobile.

Versão 2.3.1.1

  • Adaptador atualizado para usar a nova classe VersionInfo.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 22.0.0.

Criado e testado com:

  • Versão 22.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.1 do SDK da i-mobile.

Versão 2.3.1.0

  • Compatibilidade verificada com o SDK da i-mobile v2.3.1.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 21.5.0.

Criado e testado com:

  • Versão 21.5.0 do SDK do Google Mobile Ads.
  • Versão 2.3.1 do SDK da iMobile.

Versão 2.3.0.0

  • Compatibilidade verificada com o SDK da i-mobile v2.3.0.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 21.3.0.

Criado e testado com:

  • Versão 21.3.0 do SDK do Google Mobile Ads.
  • Versão 2.3.0 do SDK da iMobile.

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 do Google Mobile Ads para 21.0.0.
  • Atualizamos o nível mínimo necessário da API Android para 19.

Criado e testado com:

  • Versão 21.0.0 do SDK do Google Mobile Ads.
  • Versão 2.0.23 do SDK da iMobile.

Versão 2.0.23.0

  • Compatibilidade verificada com a versão 2.0.23 do SDK da i-mobile.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 20.5.0.

Criado e testado com

  • Versão 20.5.0 do SDK do Google Mobile Ads.
  • Versão 2.0.23 do SDK da iMobile.

Versão 2.0.22.2

  • Adicionamos códigos e mensagens de erro padronizados do adaptador.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 20.1.0.

Criado e testado com

  • Versão 20.1.0 do SDK do Google Mobile Ads.
  • Versão 2.0.22 do SDK da i-mobile.

Versão 2.0.22.1

  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 20.0.0.

Criado e testado com

  • Versão 20.0.0 do SDK do Google Mobile Ads.
  • Versão 2.0.22 do SDK da i-mobile.

Versão 2.0.22.0

  • Compatibilidade verificada com a versão 2.0.22 do SDK da i-mobile.
  • Atualizamos o adaptador para oferecer suporte a solicitações de banners adaptativos inline.

Criado e testado com

  • Versão 19.1.0 do SDK do Google Mobile Ads.
  • Versão 2.0.22 do SDK da i-mobile.

Versão 2.0.21.0

  • Compatibilidade verificada com o SDK da i-mobile v2.0.21.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 19.1.0.
  • Adicionamos suporte para dimensionar anúncios de banner adaptativo.

Criado e testado com

  • Versão 19.1.0 do SDK do Google Mobile Ads.
  • Versão 2.0.21 do SDK do iMobile.

Versão 2.0.20.2

  • Adicionamos suporte a tamanhos flexíveis de anúncios de banner.
  • Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 18.3.0.

Criado e testado com

  • Versão 18.3.0 do SDK do Google Mobile Ads.
  • Versão 2.0.20 do SDK da i-mobile.

Versão 2.0.20.1

  • O adaptador agora retorna uma proporção mediaContent diferente de zero.

Criado e testado com

  • Versão 18.2.0 do SDK do Google Mobile Ads.
  • Versão 2.0.20 do SDK da iMobile.

Versão 2.0.20.0

  • Versão inicial.
  • Adicionamos suporte para anúncios de banner, intersticiais e nativos.