Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da i-mobile usando a mediação, abrangendo 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 do Flutter.
A interface do painel do 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 do Ad Manager para i-mobile tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
| Nativo | |
Pré-requisitos
Antes de continuar, verifique o seguinte:
- Versão mais recente do Google Mobile Ads Flutter Plugin.
- Versão 3.7.0 ou mais recente do framework do Flutter.
- Para implantar no Android
- API Android nível 24 ou mais recente.
- Para implantar no iOS
- Destino de implantação do iOS 13.0 ou mais recente.
- Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar o Google Mobile Ads Flutter Plugin para mais detalhes.
Etapa 1: definir as configurações na interface da i-mobile
Inscreva-se ou faça login na sua conta da i-mobile.
Adicione seu app ao painel da i-mobile clicando na guia サイト/アプリ管理 (Gerenciamento de sites/aplicativos) e no botão da plataforma do seu 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 sites/aplicativos).
Android

iOS

Acesse a guia 広告スポット管理 (Gerenciamento de espaços de anúncio) e clique no botão 新規広告スポット (Novo espaço de anúncio).
Em seguida, preencha o formulário informando o 広告スポット名 (nome do espaço de anúncio), 広告スポットサイズ (tamanho do espaço de anúncio) e outros detalhes. Em seguida, clique no botão 新規登録 (Inscrever-se).
Seu novo espaço de anúncio está pronto. Para ver os detalhes da integração, clique no botão アプリ設定取得 (Get App settings).
Anote o ID do publisher (パブリッシャーID), o código da mídia (メディアID) e o ID do spot (スポットID). Você vai precisar desses parâmetros mais tarde, ao configurar a i-mobile para mediação na interface do Ad Manager.
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, crie um arquivo app-ads.txt para o Ad Manager.
Para implementar o app-ads.txt para i-mobile, consulte as
perguntas frequentes.
Etapa 2: configurar a demanda da i-mobile na interface do Ad Manager
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
Integração pelo pub.dev
(Somente para Android) Adicione os seguintes repositórios ao arquivo build.gradle no diretório android do seu projeto:
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da i-mobile no arquivo pubspec.yaml do seu pacote:
dependencies:
gma_mediation_imobile: ^1.0.6
Integração manual
Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para
i-mobile,
extraia o arquivo baixado e adicione a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo
pubspec.yaml adicionando a seguinte dependência:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
Etapa 4: código extra necessário
Android
Não é necessário nenhum código adicional para a integração com a i-mobile.
iOS
Integração da SKAdNetwork
Siga a documentação da i-mobile (em japonês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste no Ad Manager. A i-mobile oferece ID do spot, ID da mídia e ID do publisher para testes. Eles estão disponíveis 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 publishers poderão verificar o erro
subjacente 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 | A i-mobile requer um contexto Activity para carregar anúncios. |
| 102 | Os parâmetros do servidor da i-mobile configurados na interface do Ad Manager estão ausentes ou são inválidos. |
| 103 | O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela i-mobile. |
| 104 | O callback de carregamento de anúncios nativos da i-mobile retornou uma lista vazia. |
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 da i-mobile configurados na interface do Ad Manager estão ausentes ou são inválidos. |
| 102 | O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela i-mobile. |
| 103 | A i-mobile não apresentou um anúncio. |
| 104 | A i-mobile retornou uma matriz de anúncios nativos vazia. |
| 105 | A i-mobile não conseguiu fazer o download dos 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 alterações do adaptador de mediação da i-mobile para Flutter
Versão 1.0.6
- Compatível com a versão 2.3.2.5 do adaptador i-mobile para Android.
- Compatível com a versão 2.3.4.8 do adaptador i-mobile para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.5
- Atualizamos o adaptador para oferecer suporte à versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
- Adição de suporte ao Gerenciador de Pacotes do Swift.
- Compatível com a versão 2.3.2.4 do adaptador i-mobile para Android.
- Compatível com a versão 2.3.4.8 do adaptador i-mobile para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.4
- Compatível com a versão 2.3.2.3 do adaptador da i-mobile para Android.
- Compatível com a versão 2.3.4.7 do adaptador da i-mobile para iOS.
- Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.3
- Atualizamos a versão mínima do Flutter para 3.38.1.
- Atualizado para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
- Compatível com a versão 2.3.2.3 do adaptador da i-mobile para Android.
- Compatível com a versão 2.3.4.6 do adaptador do i-mobile para iOS.
- Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.2
- Compatível com a versão 2.3.2.1 do adaptador do i-mobile para Android.
- Compatível com a versão 2.3.4.3 do adaptador do i-mobile para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.1
- Compatível com a versão 2.3.2.1 do adaptador do i-mobile para Android.
- Compatível com a versão 2.3.4.2 do adaptador do i-mobile para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 2.3.2.0 do adaptador da i-mobile para Android.
- Compatível com a versão 2.3.4.1 do adaptador i-mobile para iOS.
- Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.