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
Primeiro, inscreva-se ou faça login na sua conta de maio. Clique no botão Gerenciamento de aplicativos na barra lateral esquerda e em Novo app.
Selecione a guia correspondente ao seu Tipo de anúncio preferido.
Intersticial
Insira o Nome do seu aplicativo, selecione a plataforma e forneça o URL do aplicativo. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.
Premiado
Insira o Nome do seu aplicativo, selecione a plataforma e forneça o URL do aplicativo. 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 seu bloco de anúncios Ad Manager na próxima seção.
Na página Gerenciamento da zona, anote o ID da zona. Ele também será necessário para configurar seu bloco de anúncios de Ad Manager na próxima seção.
Etapa 2: configurar a demanda de maio na Ad Manager interface
Definir as configurações de mediação para seu bloco de anúncios
Faça login na sua conta do Ad Manager.
Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.
Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis ao qual você quer adicionar a mediação.
Em seguida, clique no botão Adicionar parceiro de rendimento.
Se você já tiver um Parceiro de rendimento para maio, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.
Selecione maio como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.
Ative a Coleta de dados automática e insira o API ID and API KEY recebido na seção anterior.
Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Media ID and Zone ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.
Clique em Salvar na parte inferior da página quando terminar.
Etapa 3: importar o SDK e o adaptador de maio
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
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 poderia fazer 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.