Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da maio usando 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 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 deste guia, os marcadores e botões são referenciados com os 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 | |
| Intersticial | |
| Premiado | |
| Nativo | |
Requisitos
- API Android nível da API 24 ou mais recente.
- SDK da maio 1.0.7 ou mais recente.
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).

Premiado
Insira o nome do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video Rewards (Vídeos premiados) como o tipo de anúncio e clique em Update (Atualizar).

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

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 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, entre na sua conta do AdMob. Em seguida, acesse a guia Mediação. Caso queira modificar um grupo de mediação, clique no nome dele para editar e pule para Adicionar a maio como uma origem de anúncios.
Para criar um novo 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 da 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.25.0-beta01") implementation("com.google.ads.mediation:maio:2.0.8.1") } 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.25.0-beta01' implementation 'com.google.ads.mediation:maio:2.0.8.1' } 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 e adicione o 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 da maio no Android.
Etapa 5: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste na AdMob.
Os publishers 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 publishers poderão 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 correspondentes gerados pelo adaptador da maio quando um anúncio não é carregado:
| 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`. |