Integrar i-mobile com mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do i-mobile usando mediação, cobrindo integrações em hierarquia. Ele aborda como adicionar o i-mobile à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do i-mobile a um app Unity.

A interface do painel para i-mobile usa texto em japonês para seus rótulos, botões e descrições. As capturas de tela deste 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 compatíveis

O Ad Manager adaptador de mediação para i-mobile tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • Unity 5.6 ou mais recente
  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na interface do i-mobile

Inscreva-se ou faça login na sua conta do i-mobile.

Para adicionar seu app ao painel do i-mobile, clique na guia サイト／アプリ管理 (Site/Application Management) e no botão da plataforma do 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 site/aplicativo).

Android

iOS

Navegue até a guia 広告スポット管理 (Gerenciamento de espaço 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 do anúncio), 広告スポットサイズ (tamanho do espaço do anúncio) e outros detalhes. Em seguida, 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 editor), メディアID (ID da mídia) e スポットID (ID do spot). Você vai precisar desses parâmetros mais tarde ao configurar o i-mobile para mediação na interface da AdMob.

Android

iOS

Etapa 2: configurar a interface do i-mobile demand Ad Manager

Definir as configurações de mediação para seu bloco de anúncios

Android

Para conferir 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 do i-mobile

OpenUPM-CLI

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

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

OpenUPM

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

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

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads i-mobile 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 de anúncios para dispositivos móveis do Google para i-mobile no link de download no Changelog 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ê transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca External Dependency Manager vai executar a resolução do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app Unity.

Forçar resolução

Etapa 4: código adicional necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 5: testar a implementação

Códigos de erro

Se o adaptador não receber um anúncio do i-mobile, os editores poderão verificar o erro subjacente da 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 exibidas pelo adaptador i-mobile quando um anúncio não é carregado:

Android

Código do erro Motivo
0-99 O SDK para i-mobile retornou um erro. Consulte o código para mais detalhes.
101 O i-mobile requer um contexto Activity para carregar anúncios.
102 Os parâmetros do servidor para dispositivos móveis configurados na Ad Manager interface estão ausentes/inválidos.
103 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile.
104 O callback de sucesso de carregamento de anúncios nativos do i-mobile retornou uma lista de anúncios nativos vazia.

iOS

Código do erro Motivo
0-10 O SDK i-mobile retornou um erro. Consulte o código para mais detalhes.
101 Os parâmetros do servidor i-mobile configurados na interface Ad Manager estão ausentes ou inválidos.
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com i-mobile.
103 O i-mobile não conseguiu apresentar um anúncio.
104 O i-mobile retornou uma matriz de anúncios nativos vazia.
105 Não foi possível fazer o download dos recursos de anúncios nativos no i-mobile.
106 O i-mobile não oferece suporte a solicitações de vários anúncios intersticiais usando o mesmo ID de spot.

Registro de alterações do plug-in de mediação Unity para i-mobile

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