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

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:

  • Destino de implantação do iOS 13.0 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 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).

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 ver 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 a 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 receita 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 o Tipo de integração, iOS como a Plataforma e Ativo como o 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

Usar o Gerenciador de Pacotes do Swift

Antes de continuar, verifique se você tem a versão mínima compatível do adaptador 2.3.4.2.

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

  1. No Xcode, acesse File > Add Package Dependencies….

  2. No prompt que aparece, pesquise o seguinte URL do pacote:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. Em Regra de dependência, selecione Ramificação.

  4. No campo de texto, digite main.

Usar o CocoaPods

  • Adicione a seguinte linha ao Podfile do seu 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 da i-mobile e vincule ImobileSdkAds.framework ao seu projeto.
  • Baixe a versão mais recente do adaptador da i-mobile no link de download em Registro de alterações e vincule IMobileAdapter.framework ao seu projeto.

Etapa 4: adicionar o código necessário

Implementar a SKAdNetwork

Siga a documentação da i-mobile para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager. A i-mobile fornece ID do spot, ID da mídia e ID do editor de teste. Você pode encontrá-los 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 GADNativeAd.

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 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 editores podem verificar o erro na 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 correspondentes gerados pelo adaptador da i-mobile quando um anúncio não é carregado:

Código do erro Motivo
0-10 O SDK da i-mobile retornou um erro. Consulte o código para mais detalhes.
101 Os parâmetros do servidor da i-mobile configurados na interface do Ad Manager estão ausentes ou são inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a i-mobile.
103 O i-mobile não conseguiu apresentar um anúncio.
104 A i-mobile retornou uma matriz de anúncios nativos vazia.
105 O i-mobile não conseguiu fazer o download dos recursos de anúncios nativos.
106 A i-mobile não permite solicitar vários anúncios intersticiais usando o mesmo ID do spot.
107 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.

Registro de mudanças: adaptador de mediação do iOS (i-mobile)

Versão 2.3.4.8

  • Atualizamos a versão mínima do iOS para reduzir a dependência do SDK do Google Mobile Ads e permitir versões secundárias.

Criado e testado com:

  • Versão 13.7.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.7

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

Criado e testado com:

  • Versão 13.4.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.6

  • Filtre 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 13.2.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.5

  • Atualizamos a dependência do SDK do Google Mobile Ads para a versão 13.0.0.

Criado e testado com:

  • Versão 13.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.4

  • Atualizamos a versão mínima do iOS do CocoaPods para 13.0.

Criado e testado com:

  • Versão 13.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.3

  • Correção dos nomes de cabeçalho do framework e do umbrella no mapa de módulo IMobileAdapter.

Criado e testado com:

  • Versão 12.12.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.2

  • Agora requer a versão 12.0.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com:

  • Versão 12.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.1

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

Criado e testado com:

  • Versão 11.10.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.4.0

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

Criado e testado com:

  • Versão 11.2.0 do SDK do Google Mobile Ads.
  • Versão 2.3.4 do SDK da i-mobile.

Versão 2.3.3.0

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

Criado e testado com:

  • Versão 11.1.0 do SDK do Google Mobile Ads.
  • Versão 2.3.3 do SDK da i-mobile.

Versão 2.3.2.1

  • O método delegado willBackgroundApplication descontinuado foi removido das implementações de anúncios nativos, intersticiais e de banner.
  • Agora requer a versão mínima do iOS 12.0.
  • Agora requer a versão 11.0 ou mais recente do SDK do Google Mobile Ads.
  • Incluímos Info.plist nos frameworks em IMobileAdapter.xcframework.

Criado e testado com:

  • Versão 11.0.1 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.
  • Remoção do suporte à arquitetura armv7.
  • Agora requer a versão mínima 11.0 do iOS.
  • Agora requer a versão 10.4.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com:

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

Versão 2.3.1.0

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

Criado e testado com:

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

Versão 2.3.0.1

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

Criado e testado com:

  • Versão 10.0.0 do SDK do Google Mobile Ads.
  • Versão 2.3.0 do SDK da i-mobile.

Versão 2.3.0.0

  • Compatibilidade verificada com o SDK da i-mobile 2.3.0.
  • Agora requer a versão 9.8.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com:

  • Versão 9.13.0 do SDK do Google Mobile Ads.
  • Versão 2.3.0 do SDK da i-mobile.

Versão 2.2.0.1

  • Agora requer a versão 9.0.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com:

  • Versão 9.0.0 do SDK do Google Mobile Ads.
  • Versão 2.2.0 do SDK da i-mobile.

Versão 2.2.0.0

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

Criado e testado com

  • Versão 8.13.0 do SDK do Google Mobile Ads.
  • Versão 2.2.0 do SDK da i-mobile.

Versão 2.1.0.1

  • Flexibilizamos a dependência da versão 8.0.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com

  • Versão 8.4.0 do SDK do Google Mobile Ads.
  • Versão 2.1.0 do SDK da i-mobile.

Versão 2.1.0.0

  • Compatibilidade verificada com a versão 2.1.0 do SDK da i-mobile.
  • Agora requer a versão 8.1.0 ou mais recente do SDK do Google Mobile Ads.
  • Atualizamos o adaptador para usar o formato .xcframework.

Criado e testado com

  • Versão 8.1.0 do SDK do Google Mobile Ads.
  • Versão 2.1.0 do SDK da i-mobile.

Versão 2.0.33.1

  • Adicionamos códigos e mensagens de erro padronizados do adaptador.
  • O adaptador agora limita a solicitação de vários anúncios intersticiais usando o mesmo ID de spot da i-mobile.
  • O adaptador agora encaminha o callback -nativeAdWillLeaveApplication: quando os anúncios nativos são tocados.
  • Agora requer a versão 7.68.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com

  • Versão 7.68.0 do SDK do Google Mobile Ads.
  • Versão 2.0.33 do SDK da i-mobile.

Versão 2.0.33.0

  • Compatibilidade verificada com a versão 2.0.33 do SDK da i-mobile.
  • Agora requer a versão 7.65.0 ou mais recente do SDK do Google Mobile Ads.
  • Agora exige a versão mínima do iOS 9.0.

Criado e testado com

  • Versão 7.65.0 do SDK do Google Mobile Ads.
  • Versão 2.0.33 do SDK da i-mobile.

Versão 2.0.32.0

  • Compatibilidade verificada com a versão 2.0.32 do SDK da i-mobile.
  • Agora requer a versão 7.60.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
  • Adicionamos suporte para escalonamento de anúncios de 320 x 50 e 320 x 100 para melhor ajuste aos tamanhos de solicitação de banner adaptativo.
  • Remoção do suporte à arquitetura i386.

Criado e testado com

  • Versão 7.60.0 do SDK do Google Mobile Ads.
  • Versão 2.0.32 do SDK da i-mobile.

Versão 2.0.31.0

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

Criado e testado com

  • Versão 7.53.1 do SDK do Google Mobile Ads.
  • Versão 2.0.31 do SDK i-mobile.

Versão 2.0.29.0

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

Criado e testado com

  • Versão 7.52.0 do SDK do Google Mobile Ads.
  • Versão 2.0.29 do SDK da i-mobile.