Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios de maio usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar maio à propriedade de um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador de maio a um Android .
A interface do dashboard de 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 os botões são e os equivalentes em inglês. "URL 日ーム" por exemplo, é "Esquema de URL".
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
- Android API de nível 21 ou mais recente
- Maio SDK 1.0.7 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir a mediação Guia explicativo
Etapa 1: definir configurações na interface de maio
Etapa 2: configurar a demanda de maio na Ad Manager interface
Etapa 3: importar o SDK e o adaptador de maio
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
no nível do projeto, adicione o seguinte:
repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Em seguida, no arquivo build.gradle.kts
no nível do app, adicione o seguinte:
dependências e configurações de implementação. Use as versões mais recentes do
SDK e adaptador de maio:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Integração manual
- Faça download da versão mais recente do maio Android SDK e adicione ao seu projeto.
- Navegue até os artefatos do adaptador maio no repositório Maven do Google. Selecione a versão mais recente e faça o download de ".aar" do adaptador de maio e adicione-o ao seu projeto.
Etapa 4: adicionar o código obrigatório
Nenhum código extra é necessário para a integração com o Maio Android.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em Ad Manager
Os editores que usam a versão 11.6.0 ou posterior do SDK dos anúncios para dispositivos móveis do Google receberão automaticamente os anúncios de teste 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 do maio, ative os testes de uma única origem no Ad Inspector usando as maio (Waterfall) origens de anúncios.
Códigos de erro
Se o adaptador não receber um anúncio de maio,
os editores podem verificar o erro subjacente a partir 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 |
Estes são os códigos e as mensagens de acompanhamento geradas pelo adaptador de maio quando um anúncio não é carregado:
Código do erro | Motivo |
---|---|
0-10 | maio retornou um erro específico do SDK. Veja o código 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 Android Mediation Adapter de maio
Versão 1.1.16.3
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
- SDK do Maio versão 1.1.16.
Versão 1.1.16.2
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 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.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.0.0.
- O nível mínimo necessário da API do Android foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Maio versão 1.1.16.
Versão 1.1.16.0
- Os códigos de erro foram atualizados para capturar mais erros de maio.
- Compatibilidade verificada com a versão 1.1.16 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 versão 20.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- SDK do Maio versão 1.1.16.
Versão 1.1.15.0
- Compatibilidade verificada com a versão 1.1.15 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 versão 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 de erro e mensagens padronizados do adaptador.
- Compatibilidade verificada com a versão 1.1.14 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 versão 19.8.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.8.0.
- SDK do Maio versão 1.1.14.
Versão 1.1.13.0
- Compatibilidade verificada com a versão 1.1.13 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 versão 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
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
- SDK do Maio versão 1.1.12.
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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do Maio versão 1.1.11.
Versão 1.1.11.0
- Compatibilidade verificada com a versão 1.1.11 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.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK do Maio versão 1.1.11.
Versão 1.1.10.0
- Compatibilidade verificada com a versão 1.1.10 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.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
- Adaptador atualizado para oferecer suporte à nova API Premiada.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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 o SDK de maio versão 1.1.2.
Versão 1.1.1.1
- O adaptador foi atualizado 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 o SDK de maio versão 1.1.0.
Versão 1.0.8.0
- Compatibilidade verificada com a versão 1.0.8 do SDK de maio.
Versão 1.0.7.1
- Correção de um problema que fazia com que NullPointerExceptions ocorresse quando os anúncios falhassem para carregar.
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 o SDK de maio versão 1.0.7.
Versão 1.0.6.0
- Primeira versão!
- Agora é possível usar intersticiais e anúncios em vídeo premiados.