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 da i-mobile usando mediação, cobrindo integrações em hierarquia. Ela 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 iOS app.

A interface do painel para i-mobile usa texto em japonês nos 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 compatíveis

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• Destino de implantação do iOS 12.0 ou mais recente

• SDK dos anúncios para dispositivos móveis do Google mais recente

• Concluir o Guia explicativo de mediação

Etapa 1: configurar a interface do i-mobile

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

Para adicionar o app ao painel do i-mobile, clique na guia サイト／アプリ管理 (Site/Application Management) e no botão da plataforma do app.

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

Observação: o i-mobile precisa aprovar seu registro. Depois que você for aprovado, poderá criar um espaço de publicidade.

Para criar um novo espaço de publicidade, selecione seu app na guia サイト／アプリ管理 (Site/Application Management).

Navegue até a guia 広告スポット管理 (Gerenciamento de espaço publicitário) e clique no botão 新規広告スポット (Novo espaço publicitário).

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).

Seu novo espaço de anúncio está pronto. Para conferir os detalhes da integração, clique no botão アプリ設定取得 (Get App settings).

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 do Ad Manager.

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

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

Faça login na sua conta do Ad Manager.

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.

Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e defina o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e App para dispositivos móveis para adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um parceiro de rendimento para i-mobile, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.

Selecione i-mobile como a rede de publicidade, insira um nome exclusivo e ative a mediação.

Ative a Coleta automática de dados e insira o nome de login e a senha da API.

Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como Tipo de integração, iOS como Plataforma e Ativo como Status. Insira o ID do editor, o ID da mídia e o ID do anúncio recebidos na seção anterior. Em seguida, insira um valor de CPM padrão.

Clique em Salvar na parte de baixo da página quando terminar.

Observação: a coleta de dados automática leva alguns dias para reunir os dados antes de calcular com precisão um valor de CPM dinâmico para uma rede de mediação. Depois que o eCPM for calculado, ele será atualizado automaticamente.

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

Observação: a falha na integração das versões compatíveis do i-mobile e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Usando o CocoaPods (recomendado)

Adicione a seguinte linha ao Podfile do seu projeto:

pod 'GoogleMobileAdsMediationIMobile'

Na linha de comando, execute:

pod install --repo-update

Integração manual

• Faça o download da versão mais recente do SDK i-mobile e vincule ImobileSdkAds.framework ao seu projeto.
• Faça o download da versão mais recente do adaptador i-mobile no link de download no Changelog e no link IMobileAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

Integração da SKAdNetwork

Siga a documentação da 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 no Ad Manager. O i-mobile fornece ID do spot, ID da mídia e ID do editor para testes. Eles podem ser encontrados aqui.

Importante: desative o modo de teste do Ad Manager e do i-mobile antes de lançar o app.

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).

Etapas opcionais

Como usar anúncios nativos

Renderização do anúncio

O adaptador i-mobile preenche os seguintes para um GADNativeAd.

Campo	Recursos sempre incluídos pelo adaptador i-mobile
Título
Imagem
Corpo
Ícone do app	^1
Call-to-action
Star rating
Loja
Preço

¹ Para anúncios nativos, o SDK i-mobile não fornece um recurso de ícone de app. Em vez disso, o adaptador i-mobile preenche o ícone do app com uma imagem transparente.

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 GADResponseInfo.adNetworkInfoArray nas seguintes classes:

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:

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 de 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 adaptador de mediação iOS da i-mobile

Versão 2.3.4.1

• CFBundleShortVersionString foi atualizado para ter três componentes em vez de quatro.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
• SDK i-mobile versão 2.3.4.

Versão 2.3.4.0

• Compatibilidade verificada com o SDK i-mobile 2.3.4.
• Foi adicionado suporte para retornar a versão do SDK i-mobile em adSDKVersion.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
• SDK i-mobile versão 2.3.4.

Versão 2.3.3.0

• Compatibilidade verificada com o SDK i-mobile 2.3.3.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.1.0.
• SDK i-mobile versão 2.3.3.

Versão 2.3.2.1

• O método de delegação willBackgroundApplication descontinuado foi removido das implementações de anúncios nativos, intersticiais e de banner.
• Agora requer a versão mínima do iOS 12.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 11.0 ou mais recente.
• Incluiu Info.plist nos frameworks em IMobileAdapter.xcframework.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
• SDK i-mobile versão 2.3.2.

Versão 2.3.2.0

• Compatibilidade verificada com o SDK i-mobile 2.3.2.
• A compatibilidade com a arquitetura armv7 foi removida.
• Agora requer a versão mínima do iOS 11.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.4.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.4.0.
• SDK i-mobile versão 2.3.2.

Versão 2.3.1.0

• Compatibilidade verificada com o SDK i-mobile 2.3.1.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.3.0.
• SDK i-mobile versão 2.3.1.

Versão 2.3.0.1

• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
• SDK i-mobile versão 2.3.0.

Versão 2.3.0.0

• Compatibilidade verificada com o SDK i-mobile 2.3.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.8.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.13.0.
• SDK i-mobile versão 2.3.0.

Versão 2.2.0.1

• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.0.0 ou mais recente.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 9.0.0.
• SDK i-mobile versão 2.2.0.

Versão 2.2.0.0

• Compatibilidade verificada com o SDK i-mobile versão 2.2.0.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.13.0.
• SDK i-mobile versão 2.2.0.

Versão 2.1.0.1

• Dependência relaxada do SDK dos anúncios para dispositivos móveis do Google versão 8.0.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.4.0.
• SDK i-mobile versão 2.1.0.

Versão 2.1.0.0

• Compatibilidade verificada com o SDK i-mobile versão 2.1.0.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 8.1.0 ou mais recente.
• O adaptador foi atualizado para usar o formato .xcframework.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 8.1.0.
• SDK i-mobile versão 2.1.0.

Versão 2.0.33.1

• Foram adicionados códigos e mensagens de erro padronizados do adaptador.
• O adaptador agora limita a solicitação de vários anúncios intersticiais usando o mesmo ID de spot i-mobile.
• O adaptador agora encaminha o callback -nativeAdWillLeaveApplication: quando os anúncios nativos são tocados.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.68.0 ou mais recente.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.68.0.
• SDK i-mobile versão 2.0.33.

Versão 2.0.33.0

• Compatibilidade verificada com o SDK i-mobile versão 2.0.33.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.65.0 ou mais recente.
• Agora requer a versão mínima do iOS 9.0.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.65.0.
• SDK i-mobile versão 2.0.33.

Versão 2.0.32.0

• Compatibilidade verificada com o SDK i-mobile versão 2.0.32.
• Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 7.60.0 ou mais recente.
• Foi adicionado suporte para dimensionar anúncios de 320 x 50 e 320 x 100 para melhor se ajustar aos tamanhos de solicitação de banner adaptativo.
• Remoção do suporte à arquitetura i386.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.60.0.
• SDK i-mobile versão 2.0.32.

Versão 2.0.31.0

• Compatibilidade verificada com o SDK i-mobile versão 2.0.31.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.53.1.
• SDK i-mobile versão 2.0.31.

Versão 2.0.29.0

• Versão inicial.
• Suporte adicionado para anúncios de banner, intersticiais e nativos.

Desenvolvido e testado com

• SDK dos anúncios para dispositivos móveis do Google versão 7.52.0.
• SDK i-mobile versão 2.0.29.