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 mostrar anúncios do i-mobile usando Mediação da AdMob, abrangendo integrações de 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 app iOS .

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

  • Destino de implantação do iOS 12.0 ou mais recente

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Leia o Guia explicativo de mediação

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

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

Para adicionar seu 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 サイト/アプリ管理 (gerenciamento de site/aplicativo).

Navegue até a guia 広告分ット管理 (Gerenciamento de espaços de anúncios) 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 Ϧ分 (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 (ID do editor), メディアID (ID da mídia) e スポットID (ID do spot). Você precisará desses parâmetros mais tarde ao configurar o i-mobile para mediação na interface da AdMob.

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

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

Você precisa adicionar i-mobile à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga 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 a plataforma e o formato do anúncio e clique em Continuar.

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. 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únciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar i-mobile como uma origem de anúncios

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

Selecione i-mobile e ative a chave Otimizar. Insira o Login name and API Password recebido 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á tem um mapeamento para i-mobile, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Publisher ID, Media ID and Spot ID recebido na seção anterior. Em seguida, clique em Concluído.

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

Adicione a seguinte linha ao Podfile do projeto:

pod 'GoogleMobileAdsMediationIMobile'

Na linha de comando, execute:

pod install --repo-update

Integração manual

  • Faça o download da versão mais recente do SDK i-mobile e vincule ImobileSdkAds.framework ao seu projeto.
  • Faça o download da versão mais recente do adaptador i-mobile no link de download no Changelog e no link IMobileAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

Integração da SKAdNetwork

Siga a documentação da i-mobile (link em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 5: testar a implementação

Etapas opcionais

Usar anúncios nativos

Renderização do anúncio

O adaptador para i-mobile preenche as seguintes descrições dos campos de anúncios nativos avançados para uma GADNativeAd.

Campo Recursos sempre incluídos pelo adaptador 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 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 GADResponseInfo.adNetworkInfoArray nas seguintes classes:

Formato Nome da classe
Banner IMobileAdapter
Intersticial IMobileAdapter
Nativo GADMediationAdapterIMobile

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-10 O SDK i-mobile retornou um erro. Consulte o código para mais detalhes.
101 Os parâmetros do servidor i-mobile configurados na interface AdMob estão ausentes ou inválidos.
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile.
103 O i-mobile não conseguiu apresentar um anúncio.
104 O i-mobile retornou uma matriz vazia de anúncios nativos.
105 Falha ao fazer o download dos recursos de anúncio nativo da i-mobile.
106 O i-mobile não oferece suporte à solicitação de vários anúncios intersticiais usando o mesmo ID do Spot.

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

Versão 2.3.4.1

  • CFBundleShortVersionString foi atualizado para ter três componentes em vez de quatro.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
  • SDK para i-mobile versão 2.3.4.

Versão 2.3.4.0

  • Compatibilidade verificada com o SDK i-mobile 2.3.4.
  • Foi adicionado suporte para retornar a versão do SDK i-mobile em adSDKVersion.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
  • SDK para i-mobile versão 2.3.4.

Versão 2.3.3.0

  • Compatibilidade verificada com o SDK para i-mobile 2.3.3.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.1.0.
  • SDK i-mobile versão 2.3.3.

Versão 2.3.2.1

  • Removemos o método delegado willBackgroundApplication descontinuado das implementações de banner, intersticial e nativo.
  • Agora exige a versão mínima do iOS 12.0.
  • Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Inclusão de Info.plist nos frameworks em IMobileAdapter.xcframework.

Criado e testado com:

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

Versão 2.3.2.0

  • Compatibilidade verificada com o SDK para i-mobile 2.3.2.
  • A compatibilidade com a arquitetura armv7 foi removida.
  • Agora exige a versão mínima do iOS 11.0.
  • Agora requer a versão 10.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

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

Versão 2.3.1.0

  • Compatibilidade verificada com o SDK para i-mobile 2.3.1.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.3.0.
  • SDK i-mobile versão 2.3.1.

Versão 2.3.0.1

  • Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
  • SDK i-mobile versão 2.3.0.

Versão 2.3.0.0

  • Compatibilidade verificada com o SDK i-mobile 2.3.0.
  • Agora é necessário ter a versão 9.8.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 9.13.0.
  • SDK i-mobile versão 2.3.0.

Versão 2.2.0.1

  • Agora requer a versão 9.0.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 9.0.0.
  • SDK para i-mobile versão 2.2.0.

Versão 2.2.0.0

  • Compatibilidade verificada com o SDK i-mobile versão 2.2.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 8.13.0.
  • SDK i-mobile versão 2.2.0.

Versão 2.1.0.1

  • Dependência reduzida do SDK dos anúncios para dispositivos móveis do Google versão 8.0.0 ou mais recente.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 8.4.0.
  • SDK i-mobile versão 2.1.0.

Versão 2.1.0.0

  • Compatibilidade verificada com a versão 2.1.0 do SDK para dispositivos móveis.
  • Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 8.1.0 ou mais recente.
  • O adaptador foi atualizado para usar o formato .xcframework.

Desenvolvido e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 8.1.0.
  • SDK i-mobile versão 2.1.0.

Versão 2.0.33.1

  • Foram adicionados códigos de erro e mensagens padronizados do adaptador.
  • O adaptador agora limita a solicitação de vários anúncios intersticiais usando o mesmo ID do Spot para i-mobile.
  • O adaptador agora encaminha o callback -nativeAdWillLeaveApplication: quando os anúncios nativos são tocados.
  • Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.68.0 ou mais recente.

Desenvolvido e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 7.68.0.
  • SDK i-mobile versão 2.0.33.

Versão 2.0.33.0

  • Compatibilidade verificada com a versão 2.0.33 do SDK para dispositivos móveis.
  • Agora é necessário ter a versão 7.65.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Agora requer a versão mínima do iOS 9.0.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 7.65.0.
  • SDK i-mobile versão 2.0.33.

Versão 2.0.32.0

  • Compatibilidade verificada com a versão 2.0.32 do SDK para dispositivos móveis.
  • Agora é necessário ter a versão 7.60.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Agora é possível dimensionar anúncios de 320 x 50 e 320 x 100 para se adequar melhor aos tamanhos das solicitações de banner adaptativo.
  • Remoção da compatibilidade com a arquitetura i386.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 7.60.0.
  • SDK i-mobile versão 2.0.32.

Versão 2.0.31.0

  • Compatibilidade verificada com a versão 2.0.31 do SDK para dispositivos móveis.

Criado e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 7.53.1.
  • SDK do i-mobile versão 2.0.31.

Versão 2.0.29.0

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

Desenvolvido e testado com

  • SDK dos anúncios para dispositivos móveis do Google versão 7.52.0.
  • SDK i-mobile versão 2.0.29.