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 para carregar e exibir anúncios do i-mobile usando a mediação, abrangendo integrações em hierarquia. Ele 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 aplicativo.

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 deste 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 Ad Manager 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 19 ou mais recente
  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o Guia explicativo de mediação

Etapa 1: defina as configurações na interface do usuário i-mobile

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

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

Preencha o formulário e clique no botão Subscribe規號 (Inscrever-se).

Para criar um novo Spot de publicidade, selecione seu app na guia サイト/アプリ管理 (gerenciamento de site/aplicativo).

Navegue até a guia 広告でット管理 (Gerenciamento de espaço de anúncio) e clique no botão prompt 規広告ット (Novo espaço de anúncio).

create_ad_spot

Em seguida, preencha o formulário, fornecendo o 広告ででットト (nome do espaço do anúncio), 広告まットサイズ (tamanho do espaço do anúncio) e a outros detalhes. Em seguida, clique no botão ว規órico (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 アプリา定取得 (Obter configurações do app).

ad_spot_list

Anote o パ전リッンャーID (ID do editor), o メディアID (ID da mídia) e o パנットID (ID do local). Você vai precisar desses parâmetros mais tarde ao configurar i-mobile para mediação na interface Ad Manager .

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

Definir as configurações de mediação para seu 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 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 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 de dados automática e insira o Login name and API Password

Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Publisher ID, Media ID and Spot ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.

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

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

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 seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador para i-mobile:

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

Integração manual

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

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

Campo Recursos sempre incluídos pelo adaptador i-mobile
Título
Imagem
Body
Ícone do app 1
Call-to-action
Star rating
Armazenar
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 da 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.getAdapterResponse() 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 associadas geradas pelo adaptador i-mobile quando um anúncio não é carregado:

Código do erro Motivo
0-99 O SDK do i-mobile retornou um erro. Confira o código para mais detalhes.
101 O i-mobile requer um contexto Activity para carregar anúncios.
102 Os parâmetros do servidor i-mobile configurados na Ad Manager interface estão ausentes/inválidos.
103 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile.
104 O callback de sucesso no carregamento de anúncios nativos do i-mobile retornou uma lista de anúncios nativos vazia.
0-10 O SDK do i-mobile retornou um erro. Confira o código para mais detalhes.
101 Os parâmetros do servidor i-mobile configurados na Ad Manager interface estão ausentes/inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile.
103 A i-mobile falhou ao apresentar um anúncio.
104 O i-mobile retornou uma matriz de anúncios nativos vazia.
105 A i-mobile não conseguiu fazer o download dos recursos de anúncios nativos.
106 O i-mobile não aceita a solicitação de vários anúncios intersticiais usando o mesmo ID do Spot.

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

Próxima versão

  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 22.4.0.

Versão 2.3.1.1

  • O adaptador foi atualizado para usar a nova classe VersionInfo.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 para IMobile versão 2.3.1.

Versão 2.3.1.0

  • Compatibilidade verificada com o SDK para i-mobile v2.3.1.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 21.5.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
  • SDK para IMobile versão 2.3.1.

Versão 2.3.0.0

  • Compatibilidade verificada com o SDK para i-mobile v2.3.0.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 para IMobile versão 2.3.0.

Versão 2.0.23.1

  • compileSdkVersion e targetSdkVersion foram atualizados para o nível 31 da API
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 para IMobile versão 2.0.23.

Versão 2.0.23.0

  • Compatibilidade verificada com o SDK para i-mobile v2.0.23.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 20.5.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
  • SDK para IMobile versão 2.0.23.

Versão 2.0.22.2

  • Foram adicionados códigos de erro e mensagens de adaptador padronizados.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 20.1.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
  • SDK para IMobile versão 2.0.22.

Versão 2.0.22.1

  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 20.0.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
  • SDK para 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 para IMobile versão 2.0.22.

Versão 2.0.21.0

  • Compatibilidade verificada com o SDK para i-mobile v2.0.21.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 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 para IMobile versão 2.0.21.

Versão 2.0.20.2

  • Suporte adicionado para tamanhos flexíveis de anúncio de banner.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.3.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
  • SDK para 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 para IMobile versão 2.0.20.

Versão 2.0.20.0

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