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 app iOS .
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 de 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: 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.
Preencha o formulário e clique no botão 新規登録 (Inscrever-se).
Para criar um novo espaço de publicidade, selecione seu app na guia サイト/アプリ管理 (Site/Application Management).
Navegue até a guia 広告分ット管理 (Gerenciamento de espaços de anúncios) e clique no botão \">規広告分分ット (Novo espaço de anúncio).
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 as informações de パ리リッねーID (ID do editor), メディアID (ID de 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.
Etapa 2: configurar a demanda de dispositivos móveis na Ad Manager interface
Etapa 3: importar o SDK e o adaptador i-mobile
Usando o CocoaPods (recomendado)
Adicione a seguinte linha ao Podfile do 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 (link em inglês) 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 em Ad Manager A i-mobile fornece ID do Spot, ID de mídia e ID do editor de teste para testes. É possível encontrá-los aqui.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do i-mobile, ative os testes de uma única origem no Ad Inspector usando as i-mobile (Waterfall) origens de anúncios.
Etapas opcionais
Como usar anúncios nativos
Renderização de anúncios
O adaptador i-mobile preenche os seguintes
para um
GADNativeAd
.
Campo | Recursos sempre incluídos pelo adaptador para i-mobile |
---|---|
Título | |
Imagem | |
Corpo | |
Ícone do app | 1 |
Call-to-action | |
Star rating | |
Loja | |
Preço |
1 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 podem 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 para dispositivos móveis configurados na Ad Manager interface estão ausentes/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 vazia de anúncios nativos. |
105 | Falha ao fazer o download dos recursos de anúncio nativo da 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 para 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 exige a versão mínima do iOS 12.0.
- Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
- Incluiu
Info.plist
nos frameworks emIMobileAdapter.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 requer a versão 10.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
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 para 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 para 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 a versão 2.1.0 do SDK para dispositivos móveis.
- 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 de erro e mensagens 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 ter a versão 7.68.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
Criado 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 para 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 a versão 2.0.31 do SDK para dispositivos móveis.
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.