Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios de maio usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar o maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do maio a um appAndroid .
A interface do painel para maio usa texto em japonês nos 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 referenciados com os equivalentes em inglês. Por exemplo, "URL スキーム" é "URL Scheme".
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para maio tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- API do Android de nível 21 ou mais recente
- SDK para maio 1.0.7 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir o Guia explicativo de mediação
Etapa 1: definir configurações na interface de maio
Primeiro, cadastre-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 que você quer.
Intersticial
Insira o nome do app, selecione a plataforma e informe 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 informe o URL do app. Selecione Recompensas de vídeo como o Tipo de anúncio e clique em Atualizar.
Na página Gerenciamento de aplicativos, anote o ID da mídia. É necessário configurar o 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.
Além do ID da mídia e do ID da zona, você vai precisar do ID da API e da chave da API para configurar o ID do bloco de anúncios para mediação. Na página da API Reporting, anote o ID da API e a CHAVE DA API.Etapa 2: configurar a demanda maio na Ad Manager interface
Etapa 3: importar o SDK e o adaptador da maio
Integração com o Android Studio (recomendada)
No arquivo settings.gradle.kts
no nível do projeto, adicione os seguintes repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Em seguida, no arquivo build.gradle.kts
do app, adicione as
dependências e configurações de implementação abaixo. Use as versões mais recentes do
SDK e do adaptador maiô:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Integração manual
- Faça o download da versão mais recente do SDK do Android maiô e adicione ao projeto.
- Navegue até os artefatos do adaptador Maio no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo ".aar" do adaptador de maio e adicione-o ao projeto.
Etapa 4: adicionar o código necessário
Nenhum código extra é necessário para a integração do maio com 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 SDK dos anúncios para dispositivos móveis do Google vão receber anúncios de teste automaticamente a partir de 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 de maio,
os editores poderão verificar o erro subjacente da resposta do anúncio usando
ResponseInfo.getAdapterResponses()
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 exibidas pelo adaptador maio quando um anúncio não é carregado:
Código do erro | Motivo |
---|---|
0-10 | pode ter retornado um erro específico do SDK. Consulte o code e a documentação de maio para mais detalhes. |
101 | Maio não tem um anúncio disponível. |
102 | Parâmetros de servidor inválidos (por exemplo, ID do canal ausente). |
103 | O contexto usado para carregar um anúncio não era uma instância de "Activity". |
Registro de alterações do adaptador do Android Mediation de maio
Versão 1.1.16.3
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.
- Compatibilidade verificada com a versão 1.1.16 do SDK de maio.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- Versão 1.1.16 do SDK de maio.
Versão 1.1.16.2
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do Maio versão 1.1.16.
Versão 1.1.16.1
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.0.0.
- O nível mínimo de API do Android necessário foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- Versão 1.1.16 do SDK de maio.
Versão 1.1.16.0
- Os códigos de erro foram atualizados para capturar outros erros de maio.
- Compatibilidade verificada com a versão 1.1.16 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- Versão 1.1.16 do SDK de maio.
Versão 1.1.15.0
- Compatibilidade verificada com a versão 1.1.15 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- SDK do Maio versão 1.1.15.
Versão 1.1.14.0
- Foram adicionados códigos e mensagens de erro padronizados do adaptador.
- Compatibilidade verificada com a versão 1.1.14 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.8.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.8.0.
- Versão 1.1.14 do SDK de maio.
Versão 1.1.13.0
- Compatibilidade verificada com a versão 1.1.13 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK do Maio versão 1.1.13.
Versão 1.1.12.0
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
- Versão 1.1.12 do SDK de maio.
Versão 1.1.11.1
- Para limitar os tempos, as solicitações de anúncios vão falhar imediatamente se maio não tiver um anúncio pronto para exibição.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- Versão 1.1.11 do SDK de maio.
Versão 1.1.11.0
- Compatibilidade verificada com a versão 1.1.11 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- Versão 1.1.11 do SDK de maio.
Versão 1.1.10.0
- Compatibilidade verificada com a versão 1.1.10 do SDK de maio.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.2.0.
Versão 1.1.8.0
- Compatibilidade verificada com a versão 1.1.8 do SDK de maio.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 18.1.0.
Versão 1.1.7.0
- Correções de bugs.
- Compatibilidade verificada com a versão 1.1.7 do SDK de maio.
Versão 1.1.6.1
- O adaptador foi atualizado para oferecer suporte à nova API Rewarded.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 17.2.0.
Versão 1.1.6.0
- Compatibilidade verificada com a versão 1.1.6 do SDK de maio.
Versão 1.1.5.0
- Compatibilidade verificada com a versão 1.1.5 do SDK de maio.
Versão 1.1.4.0
- Compatibilidade verificada com a versão 1.1.4 do SDK de maio.
Versão 1.1.3.1
- O adaptador foi atualizado para funcionar com a classe de instância em vez de singleton.
Versão 1.1.3.0
- Compatibilidade verificada com a versão 1.1.3 do SDK de maio.
Versão 1.1.2.1
- O adaptador foi atualizado com funções de inicialização atualizadas.
Versão 1.1.2.0
- Compatibilidade verificada com a versão 1.1.2 do SDK de maio.
Versão 1.1.1.1
- Atualizamos o adaptador para invocar o evento de anúncio
onRewardedVideoComplete()
.
Versão 1.1.1.0
- Compatibilidade verificada com a versão 1.1.1 do SDK de maio.
Versão 1.1.0.0
- Compatibilidade verificada com a versão 1.1.0 do SDK de maio.
Versão 1.0.8.0
- Compatibilidade verificada com o SDK de maio versão 1.0.8.
Versão 1.0.7.1
- Correção de um problema que podia fazer com que NullPointerExceptions ocorressem quando os anúncios não carregavam.
Versão 1.0.7.0
- Foi adicionada a capacidade de ativar o modo de teste adicionando o ID do dispositivo de teste a
AdRequest
. - Compatibilidade verificada com a versão 1.0.7 do SDK de maio.
Versão 1.0.6.0
- Primeira versão!
- Adição de suporte para intersticiais e anúncios em vídeo premiados.