Integrar a i-mobile com a mediação

Selecionar plataforma: Android Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da i-mobile usando mediação, 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 Flutter.

A interface do painel da i-mobile usa texto em japonês para identificadores, 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 identificadores 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 AdMob para i-mobile tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • Mais recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ou versão mais recente
  • Para implantação no Android
    • API Android nível da API 23 ou mais recente
  • Para implantação no iOS
    • Destino de implantação do iOS 13.0 ou mais recente
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configurar 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 サイト／アプリ管理 (Site/Application Management) e no botão da plataforma do seu app.

Android

iOS

Preencha o formulário e clique no botão 新規登録 (Sign up).

Android

iOS

Para criar um novo Advertising Spot, selecione seu app na guia サイト／アプリ管理 (Site/Application Management).

Android

iOS

Navegue até a guia 広告スポット管理 (Ad Spot Management) e clique no botão 新規広告スポット (New Ad Spot).

create_ad_spot

Em seguida, preencha o formulário fornecendo o 広告スポット名 (nome do espaço de anúncio), 広告スポットサイズ (tamanho do espaço de anúncio) e outros detalhes. Depois, 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 publisher), メディアID (código da mídia), e スポットID (Spot ID). Você vai precisar desses parâmetros mais tarde ao configurar a i-mobile para mediação na interface da AdMob.

Android

iOS

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptador da i-mobile no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_imobile: ^1.0.2

Integração manual

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para i-mobile, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a dependência abaixo:

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

Etapa 4: código extra necessário

Android

Nenhum código extra é necessário para a integração da i-mobile.

iOS

Integração da SKAdNetwork

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste na AdMob. A i-mobile fornece teste Spot ID, código da mídia, e ID do publisher para 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 i-mobile (Waterfall) origens de anúncios.

Códigos de erro

Se o adaptador não receber um anúncio da i-mobile, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

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

iOS

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:

Android

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 exige 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 do anúncio solicitado não corresponde a um tamanho de banner compatível com a i-mobile.
104 O callback de sucesso de carregamento de anúncios nativos da i-mobile retornou uma lista de anúncios nativos vazia.

iOS

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 da AdMob estão ausentes ou são inválidos.
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a i-mobile.
103 A i-mobile não conseguiu apresentar um anúncio.
104 A 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 A i-mobile não oferece suporte a solicitações de vários anúncios intersticiais usando o mesmo ID de canal.

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

Versão 1.0.4 (em andamento)

Versão 1.0.3 (em andamento)

  • Versão mínima do Flutter atualizada para 3.35.1
  • Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter

Versão 1.0.2

Versão 1.0.1

Versão 1.0.0

  • Versão inicial.
  • Oferece suporte à versão 2.3.2.0 do adaptador da i-mobile para Android .
  • Oferece suporte à versão 2.3.4.1 do adaptador da i-mobile para iOS .
  • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.