Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios do i-mobile usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar i-mobile a um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador para dispositivos móveis ao um Android app.
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 neste guia não foram traduzidos. No entanto, nas descrições e instruções deste guia, os rótulos e são traduzidos com seus 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
- Android API de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do i-mobile
Inscreva-se ou faça login na sua conta do i-mobile.
Adicione seu app ao painel do i-mobile clicando na guia サイト/アプリ管理 (Gerenciamento de site/aplicativos) e no botão para a plataforma do seu app.
Preencha o formulário e clique no botão Subscribe規號 (Inscrever-se).
Para criar um novo Spot de publicidade, selecione seu app na guia サイト/アプリ管理 (gerenciamento de site/aplicativo).
Navegue até a guia 広告でット管理 (Gerenciamento de espaço de anúncio) e clique no botão prompt 規広告ット (Novo espaço de anúncio).
Em seguida, preencha o formulário, fornecendo o 広告ででットト (nome do espaço do anúncio), 広告まットサイズ (tamanho do espaço do anúncio) e a outros detalhes. Em seguida, clique no botão ว規órico (Inscrever-se).
Seu novo espaço de anúncio está pronto. Para conferir os detalhes da integração, clique no botão アプリา定取得 (Obter configurações do app).
Anote o パ전リッンャーID (ID do editor), o メディアID (ID da mídia) e o パנットID (ID do local). Você vai precisar desses parâmetros mais tarde ao configurar i-mobile para mediação na interface Ad Manager .
Etapa 2: configurar a demanda de dispositivos móveis na Ad Manager interface
Definir as configurações de mediação para seu 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 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 Aplicativo para dispositivos móveis ao qual você quer 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 de dados automática e insira o Login name and API Password
Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Publisher ID, Media ID and Spot ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.
Clique em Salvar na parte inferior da página quando terminar.
Etapa 3: importar o SDK e o adaptador para dispositivos móveis
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts do projeto, adicione o seguinte
repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Em seguida, no arquivo build.gradle.kts no nível do app, adicione o seguinte:
dependências e configurações de implementação. Use as versões mais recentes do
SDK e adaptador para i-mobile:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Integração manual
Faça download da versão mais recente do SDK do i-mobile e extrair o
android-ad-sdk.aarna pastasdke adicione ao seu projeto.Acesse os artefatos do adaptador i-mobile. no repositório Maven do Google. Selecionar a versão mais recente, baixar o i-mobile
.aardo adaptador e adicione-o ao projeto.
Etapa 4: adicionar o código obrigatório
Nenhum código adicional é necessário para a integração com o i-mobile.
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
Usar anúncios nativos
Renderização de anúncios
O adaptador para i-mobile preenche o seguinte
campos
para um
NativeAd.
| 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 para i-mobile não fornece um recurso de ícone do app. Em vez disso, o adaptador do 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 a partir da resposta do anúncio usando
ResponseInfo.getAdapterResponses()
nas seguintes classes:
| 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 |
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador para i-mobile quando ocorre uma falha no carregamento de um anúncio:
| Código do erro | Motivo |
|---|---|
| 0-99 | O SDK para i-mobile retornou um erro. Veja 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 no carregamento do anúncio nativo do i-mobile retornou uma lista de anúncios nativos vazia. |
| 0-10 | O SDK para i-mobile retornou um erro. Veja 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 à solicitação de vários anúncios intersticiais usando o mesmo ID do Spot. |
Registro de alterações do adaptador de mediação para Android para i-mobile
Versão 2.3.2.0
- Compatibilidade verificada com o SDK para i-mobile v2.3.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do IMobile versão 2.3.2.
Versão 2.3.1.2
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.
- Compatibilidade verificada com o SDK para i-mobile v2.3.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.1.1
- O adaptador foi atualizado para usar a nova classe
VersionInfo. - Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.1.0
- Compatibilidade verificada com o SDK para i-mobile v2.3.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do IMobile versão 2.3.1.
Versão 2.3.0.0
- Compatibilidade verificada com o SDK para i-mobile v2.3.0.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
- SDK do IMobile versão 2.3.0.
Versão 2.0.23.1
compileSdkVersionetargetSdkVersionforam atualizados para a API 31.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.0.0.
- O nível mínimo necessário da API do Android foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do IMobile versão 2.0.23.
Versão 2.0.23.0
- Compatibilidade verificada com o SDK para i-mobile v2.0.23.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.5.0.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- SDK do IMobile versão 2.0.23.
Versão 2.0.22.2
- Foram adicionados códigos de erro e mensagens padronizados do adaptador.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.1.0.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.22.1
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.0.0.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.22.0
- Compatibilidade verificada com o SDK para i-mobile v2.0.22.
- O adaptador foi atualizado para oferecer suporte a solicitações de banner adaptativo inline.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do IMobile versão 2.0.22.
Versão 2.0.21.0
- Compatibilidade verificada com o SDK para i-mobile v2.0.21.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.1.0.
- Agora é possível dimensionar anúncios de banner adaptativo.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do IMobile versão 2.0.21.
Versão 2.0.20.2
- Suporte adicionado para tamanhos de anúncio de banner flexíveis.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 18.3.0.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK do IMobile versão 2.0.20.
Versão 2.0.20.1
- O adaptador agora retorna uma proporção de
mediaContentdiferente de zero.
Criado e testado com
- SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
- SDK do IMobile versão 2.0.20.
Versão 2.0.20.0
- Versão inicial.
- Agora é possível usar anúncios intersticiais, nativos e de banner.