Esta página foi traduzida pela API Cloud Translation.

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

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:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

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: configurar a interface do i-mobile

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

Para adicionar o 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ço de anúncio) e clique no botão 新規広告スポット (Novo espaço de anúncio).

create_ad_spot

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

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 (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 do AdMob.

Etapa 2: configurar a interface do i-mobile demand AdMob

Configurar as configurações de mediação para o bloco de anúncios

É necessário adicionar o i-mobile à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar 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 e 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 blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

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

No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione i-mobile.

Selecione i-mobile e ative a chave Optimize. 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 i-mobile. Em seguida, insira um valor de eCPM para i-mobile e clique em Continuar.

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

Em seguida, insira o ID do editor, o ID da mídia e o ID do anúncio recebidos 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 para calcular o eCPM com precisão para uma rede de mediação. Enquanto isso, o status de otimização da origem de anúncios é PENDING. Portanto, é necessário definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios vai começar a atualizar o eCPM automaticamente.

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

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

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

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

Campo	Recursos sempre incluídos pelo adaptador i-mobile
Título
Imagem
Corpo
Ícone do app	¹
Call-to-action
Star rating
Loja
Preço

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

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

Código do erro	Motivo
0-99	O SDK 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 i-mobile configurados na interface AdMob estão ausentes ou 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 de carregamento de anúncios nativos do i-mobile retornou uma lista de anúncios nativos vazia.

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 de API do Android necessário 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 i-mobile v2.0.22.
O adaptador foi atualizado para oferecer suporte a solicitações de banners adaptativos 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 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.
Adição de suporte para dimensionamento de 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.
Foi adicionado suporte a anúncios de banner, intersticiais e nativos.