Integrar a i-mobile com a mediação

Selecione a plataforma: Android iOS Unity Flutter

Este guia mostra como usar o plug-in dos anúncios para dispositivos móveis do Google para Unity a fim de carregar e exibir anúncios da i-mobile usando a 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 Unity.

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
Banner
Intersticial
Premiado

Requisitos

  • Plug-in dos anúncios para dispositivos móveis do Google para Unity mais recente
  • Unity 5.6 ou mais recente
  • Para implantar no Android
    • API Android nível 23 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 12.0 ou mais recente.
  • Um projeto Unity funcional configurado com o plug-in dos anúncios para dispositivos móveis do Google para Unity. Consulte Começar para mais detalhes.
  • Leia todo o guia para iniciantes da 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.

Clique na guia サイト／アプリ管理 (Gerenciamento de site/aplicativo) e no botão da plataforma do seu app para adicioná-lo ao painel do i-mobile.

Android

iOS

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

Android

iOS

Para criar um novo espaço publicitário, selecione seu app na guia サイト／アプリ管理 (Gerenciamento de site/aplicativo).

Android

iOS

Navegue até a guia 広告スポット管理 (Gerenciamento de espaços para anúncios) e clique no botão 新規広告スポット (Novo espaço para anúncio).

create_ad_spot

Em seguida, preencha o formulário com o 広告スポット名 (nome do espaço para anúncio), 広告スポットサイズ (tamanho do espaço para anúncio) e outros detalhes. Em seguida, clique no botão 新規登録 (Sign up).

new_ad_spot_form

Seu novo espaço para 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), o メディアID (ID da mídia) e o スポットID (ID do spot). 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 no 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

OpenUPM-CLI

Se você tiver a OpenUPM-CLI instalada, poderá instalar o plug-in de mediação do i-mobile dos anúncios para dispositivos móveis do Google no Unity executando o seguinte comando no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads IMobile Mediation e clique em Install.

Instalar pelo OpenUPM

Pacote do Unity

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 no link de download do Registro de alterações e extraia o GoogleMobileAdsIMobileMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsIMobileMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

Etapa 4: código extra necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação do 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 na AdMob. A i-mobile fornece ID do spot, ID da mídia e ID do editor de teste. Encontre esses IDs 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 editores poderão verificar o erro 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 O i-mobile exige um contexto Activity para carregar anúncios.
102 Os parâmetros do servidor 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 compatível com a i-mobile.
104 O callback de sucesso de carregamento de anúncios nativos da i-mobile retornou uma lista vazia de anúncios nativos.

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 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 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 baixar os 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 mudanças do plug-in de mediação do Unity (i-mobile)

Versão 1.3.8

Versão 1.3.7

Versão 1.3.6

Versão 1.3.5

Versão 1.3.4

Versão 1.3.3

Versão 1.3.2

Versão 1.3.1

Versão 1.3.0

Versão 1.2.2

Versão 1.2.1

Versão 1.2.0

Versão 1.1.0

Versão 1.0.2

Versão 1.0.1

Versão 1.0.0