Integrar a i-mobile com a mediação

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

Este guia mostra como usar o GMA Next-Gen SDK para carregar e exibir anúncios da i-mobile com a Mediação da AdMob, incluindo 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 do i-mobile usa texto em japonês para 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.

• Versão mais recente do GMA Next-Gen SDK.

• Configure a Mediação da AdMob.

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

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

Adicione seu app ao painel da i-mobile clicando na guia サイト／アプリ管理 (Gerenciamento de sites/aplicativos) e no botão da plataforma do seu app.

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

Observação: a i-mobile precisa aprovar seu registro. Depois da aprovação, você poderá criar um espaço publicitário.

Para criar um novo espaço de publicidade, selecione seu app na guia サイト／アプリ管理 (Gerenciamento de sites/aplicativos).

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

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

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

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 a i-mobile para mediação na interface da AdMob.

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, configure um arquivo app-ads.txt para seu app.

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

Etapa 2: configurar a demanda da i-mobile na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Adicione a i-mobile à configuração de mediação do seu bloco de anúncios.

Faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a i-mobile como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a i-mobile como uma origem de anúncios

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione i-mobile e ative a chave Otimizar. Insira o nome de login e a senha da API obtidos na seção anterior para configurar a otimização da origem de anúncios para a i-mobile. Em seguida, insira um valor de eCPM para a i-mobile e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para a i-mobile, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do publisher, o código da mídia e o ID do spot obtidos na seção anterior. Em seguida, clique em Concluído.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes e calcular com precisão o eCPM de uma rede de mediação. Enquanto isso, o status da otimização é PENDING. Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios começará a atualizá-lo automaticamente em seu nome.

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

Observação: a falha na integração das versões compatíveis da i-mobile e do GMA Next-Gen SDK pode causar problemas de build.

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

No arquivo do Gradle no nível do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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. Acesse os artefatos do adaptador da 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 na AdMob. A i-mobile fornece ID do spot, ID da mídia e ID do publisher para testes. Eles estão disponíveis aqui.

Importante: desative o modo de teste da AdMob e da i-mobile antes de lançar o app.

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 as seguintes descrições de campos de anúncios nativos avançados 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

¹ 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.getAdSourceResponses() 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	A i-mobile requer um contexto Activity para carregar anúncios.
102	Os parâmetros do servidor da i-mobile configurados na interface da AdMob 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 carregamento de anúncios nativos da i-mobile retornou uma lista vazia.
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

Próxima versão

• Atualizamos o adaptador para usar a API InitializationCompleteCallback.onInitializationFailed(AdError).
• Atualizamos o nível mínimo necessário da API Android para 24.
• Corrigimos um problema em que os callbacks de carregamento e apresentação de anúncios intersticiais não eram encaminhados porque um listener vazio estava registrado no SDK da i-mobile.

Versão 2.3.2.5

• Fixe a dependência do Kotlin do adaptador 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 dos anúncios para dispositivos móveis do Google.
• Versão 1.1.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 2.3.2 do SDK da i-mobile.

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 das implementações de anúncios de banner, intersticiais e nativos da API antiga para a nova.

Criado e testado com:

• Versão 25.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.3.2 do SDK da i-mobile.

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 dos anúncios para dispositivos móveis do Google 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 i-mobile.

Versão 2.3.2.0

• Compatibilidade verificada com a versão 2.3.2 do SDK da i-mobile.

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 a versão 2.3.1 do SDK da i-mobile.

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 dos anúncios para dispositivos móveis do Google 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 a versão 2.3.1 do SDK da i-mobile.
• 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 i-mobile.

Versão 2.3.0.0

• Compatibilidade verificada com a versão 2.3.0 do SDK da i-mobile.
• 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 i-mobile.

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 i-mobile.

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 dos anúncios para dispositivos móveis do Google.
• Versão 2.0.23 do SDK da i-mobile.

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 a versão 2.0.21 do SDK da i-mobile.
• 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 da i-mobile.

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 i-mobile.

Versão 2.0.20.0

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