Integrar a i-mobile com a mediação

Este guia mostra como usar o Google Mobile Ads Flutter Plugin 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 do Flutter.

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 do Ad Manager para i-mobile tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente do framework do Flutter.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar 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 o Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configure a mediação.
  • 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 サイト/アプリ管理 (Gerenciamento de sites/aplicativos) e no botão da plataforma do seu app.

    Android

    iOS

    Preencha o formulário e clique no botão 新規登録 (Inscrever-se).

    Android

    iOS

    Para criar um novo espaço de publicidade, selecione seu app na guia サイト/アプリ管理 (Gerenciamento de sites/aplicativos).

    Android

    iOS

    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 informando o 広告スポット名 (nome do espaço de anúncio), 広告スポットサイズ (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.

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

    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

    (Somente para Android) Adicione os seguintes repositórios ao arquivo build.gradle no diretório android do seu projeto:

      repositories {
          google()
          mavenCentral()
          maven {
              url = uri("https://imobile.github.io/adnw-sdk-android")
          }
      }
    

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

    dependencies:
      gma_mediation_imobile: ^1.0.6
    

    Integração manual

    Baixe a 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 seguinte dependência:

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

    Etapa 4: código extra necessário

    Android

    Não é necessário nenhum código adicional para a integração com a i-mobile.

    iOS

    Integração da SKAdNetwork

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

    Etapa 5: testar a implementação

    Ativar anúncios de teste

    Registre seu dispositivo de teste no Ad Manager. A i-mobile oferece ID do spot, ID da mídia e ID do publisher para testes. Eles estão disponíveis 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).

    Códigos de erro

    Se o adaptador não receber um anúncio da i-mobile, os publishers 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 requer um contexto Activity para carregar anúncios.
    102 Os parâmetros do servidor da i-mobile configurados na interface do Ad Manager estão ausentes ou são inválidos.
    103 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela i-mobile.
    104 O callback de carregamento de anúncios nativos da i-mobile retornou uma lista 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 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 aceito pela i-mobile.
    103 A i-mobile não apresentou 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 permite solicitar vários anúncios intersticiais usando o mesmo ID de spot.

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

    Versão 1.0.6

    Versão 1.0.5

    Versão 1.0.4

    Versão 1.0.3

    Versão 1.0.2

    Versão 1.0.1

    Versão 1.0.0