Integrar a i-mobile com a Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native 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 React Native.

A interface do painel da 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 AdMob 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:

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 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 para 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 ver as 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

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para i-mobile. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/imobile/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. Se você estiver criando para Android, adicione o seguinte repositório ao arquivo build.gradle no diretório android do seu projeto:

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

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 na AdMob. A i-mobile oferece ID do spot, ID de 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 da AdMob 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 da AdMob 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.

Versão 0.1.0

  • Versão inicial.