Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da maio usando mediação, incluindo integrações em hierarquia. Ele explica como adicionar a maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da maio a um app Flutter.
A interface do painel da maio usa texto em japonês para marcadores, botões e descrições, e as capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções aqui, os marcadores e botões são mencionados pelos equivalentes em inglês. Por exemplo, "URL スキーム" é "URL Scheme".
Integrações e formatos de anúncio aceitos
O adaptador de mediação da maio tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticiais | |
| Premiado | |
| Nativo | |
Requisitos
- Mais recente Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 ou versão mais recente
- Para implantação no Android
- API Android nível da API 23 ou mais recente
- Para implantação no iOS
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
- Configurar a mediação.
Etapa 1: definir as configurações na interface da maio
Primeiro, inscreva-se ou faça login na sua conta da maio. Clique no botão Application management (Gerenciamento de aplicativos) na barra lateral esquerda e em New app (Novo app).
Selecione a guia correspondente ao tipo de anúncio preferido.
Intersticial
Insira o nome do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video interstitial (Intersticial em vídeo) como o tipo de anúncio e, em seguida, clique em Update (Atualizar).
Android
iOS
Premiado
Insira o nome do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video Rewards (Recompensas em vídeo) como o tipo de anúncio e clique em Update (Atualizar).
Android
iOS
Na página Application Management (Gerenciamento de aplicativos), anote o ID da mídia. Ele é necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.
Android
iOS
Na página Zone Management (Gerenciamento de zonas), anote o ID da zona. Ele também será necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.
Android
iOS
Etapa 2: configurar a demanda da maio 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 do guia para Android.
iOS
Para instruções, consulte a etapa 2 do guia para iOS.
Etapa 3: importar o SDK e o adaptador da maio
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da maio no arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_maio: ^1.1.3
Integração manual
Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para
maio,
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_maio:
path: path/to/local/package
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração da maio.
iOS
Integração da SKAdNetwork
Siga a documentação da maio
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste para Ad Manager.
Os editores que usam a versão 7.26.0 ou mais recente de Google Mobile Ads Flutter Plugin vão receber automaticamente anúncios de teste da maio em smartphones e tablets registrados como dispositivos de teste ao fazer solicitações.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da maio, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios maio (hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio da maio, os editores poderão verificar o
erro subjacente na resposta do anúncio usando
ResponseInfo nas
seguintes classes:
Android
| Formato | Nome da classe |
|---|---|
| Intersticial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Premiado | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Formato | Nome da classe |
|---|---|
| Intersticial | GADMMaioInterstitialAdapter |
| Premiado | GADMMaioRewardedAdapter |
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da maio quando um anúncio não é carregado:
Android
| Código do erro | Motivo |
|---|---|
| 0-10 | A maio retornou um erro específico do SDK. Consulte o código e a documentação da maio para mais detalhes. |
| 101 | A maio não tem um anúncio disponível. |
| 102 | Parâmetros de servidor inválidos (por exemplo, ID de posicionamento ausente). |
| 103 | O contexto usado para carregar um anúncio não era uma instância de `Activity`. |
iOS
Registro de alterações do adaptador de mediação da maio para Flutter
Versão 1.1.4 (em andamento)
- Versão mínima do Flutter atualizada para 3.38.1
- Atualizado para oferecer suporte à versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
Versão 1.1.3
- Oferece suporte à versão 2.0.7.0 do adaptador da maio para Android.
- Oferece suporte à versão 2.2.0.3 do adaptador da maio para iOS .
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.1.2
- Versão mínima do Flutter atualizada para 3.35.1
- Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
- Oferece suporte à versão 2.0.8.0 do adaptador da maio para Android .
- Oferece suporte à versão 2.2.0.1 do adaptador da maio para iOS.
Versão 1.1.1
- Oferece suporte à versão 2.0.7.0 do adaptador da maio para Android.
- Oferece suporte à versão 2.2.0.1 do adaptador da maio para iOS.
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.1.0
- Oferece suporte à versão 2.0.6.0 do adaptador da maio para Android.
- Oferece suporte à versão 2.2.0.0 do adaptador da maio para iOS .
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.3
- Oferece suporte à versão 2.0.5.0 do adaptador da maio para Android .
- Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.2
- Oferece suporte à versão 2.0.4.0 do adaptador da maio para Android.
- Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.1
- Oferece suporte à versão 2.0.3.1 do adaptador da maio para Android .
- Oferece suporte à versão 2.1.6.1 do adaptador da maio para iOS .
- Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.0
- Versão inicial.
- Oferece suporte à versão 2.0.3.0 do adaptador da maio para Android .
- Oferece suporte à versão 2.1.6.0 do adaptador da maio 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.