Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da maio usando a Mediação da AdMob, 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 Android.
A interface do painel do maio usa texto em japonês para rótulos, botões e descrições, e 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 referenciados com seus equivalentes em inglês. "URL スキーム", por exemplo, é "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 | |
| Intersticial | |
| Premiado | |
| Nativo | |
Requisitos
- API Android nível 24 ou mais recente.
- SDK da maio 1.0.7 ou mais recente
Última GMA Next-Gen SDK.
Leia todo o guia para iniciantes da mediação.
Etapa 1: definir as configurações na interface da maio
Primeiro, inscreva-se ou faça login na sua conta do maio. Clique no botão Gerenciamento de aplicativos na barra lateral esquerda e em Novo app.

Selecione a guia correspondente ao Tipo de anúncio de sua preferência.
Intersticial
Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.

Premiado
Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Vídeos premiados como o Tipo de anúncio e clique em Atualizar.

Na página Gerenciamento de aplicativos, anote o ID da mídia. Ele é necessário para configurar seu bloco de anúncios da AdMob na próxima seção.

Na página Gerenciamento de zonas, anote o ID da zona. Também será necessário configurar seu bloco de anúncios da AdMob na próxima seção.


Etapa 2: configurar a demanda da maio na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Adicione a maio à configuração de mediação do seu bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a maio como uma origem de anúncios.
Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a maio como uma origem de anúncios
No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.
Selecione maio e ative a chave Otimizar. Insira o ID da API e a CHAVE DE API obtidos na seção anterior para configurar a otimização da origem de anúncios para a maio. Em seguida, insira um valor de eCPM para a maio e clique em Continuar.

Se você já tiver um mapeamento para a maio, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID da mídia e o ID da zona obtidos na seção anterior. Em seguida, clique em Concluído.

Etapa 3: importar o SDK e o adaptador da maio
Integração com o Android Studio (recomendada)
No arquivo settings.gradle.kts do projeto, adicione os seguintes repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:maio:2.0.8.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:maio:2.0.8.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Integração manual
- Baixe a versão mais recente do SDK do Android da maio e adicione ao seu projeto.
- Navegue até os artefatos do adaptador da maio no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo.aar do adaptador da maio e adicione-o ao projeto.
Etapa 4: adicionar o código necessário
Nenhum código adicional é necessário para a integração do Android.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Os editores que usam a versão 11.6.0 ou mais recente do GMA Next-Gen SDK 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 podem verificar o erro na resposta do anúncio usando
ResponseInfo.getAdSourceResponses()
nas seguintes classes:
| Formato | Nome da classe |
|---|---|
| Intersticial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Premiado | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
Confira os códigos e as mensagens geradas pelo adaptador da maio quando um anúncio não é carregado:
| Código do erro | Motivo |
|---|---|
| 0-10 | maio retornou um erro específico do SDK. Consulte o código e a documentação do maio para mais detalhes. |
| 101 | Maio não tem um anúncio disponível. |
| 102 | Parâmetros de servidor inválidos (por exemplo, ID da posição ausente). |
| 103 | O contexto usado para carregar um anúncio não era uma instância de "Activity". |