Integrar maio com mediação

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 da AdMob, cobrindo integrações de hierarquia. Ele aborda como adicionar maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador de maio a um appAndroid .

A interface do dashboard de maio usa texto em japonês para os rótulos, os botões e as descrições, e as capturas de tela deste 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

  • Leia o Guia explicativo de mediação

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 clique 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 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 AdMob interface

Definir as configurações de mediação para seu bloco de anúncios

Você precisa adicionar maio à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar maio como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

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

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. 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únciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar maio como uma origem de anúncios

No card Cascata, na seção Origens de anúncios, selecione Adicionar origem do anúncio. Em seguida, selecione maio.

Selecione maio e ative a chave Otimizar. Insira o API ID and API KEY recebido na seção anterior para configurar a otimização da origem de anúncios para maio. Em seguida, insira um valor de eCPM para maio e clique em Continuar.

Se você já tem um mapeamento para maio, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Media ID and Zone ID recebido na seção anterior. Em seguida, clique em Concluído.

Etapa 3: importar o SDK e o adaptador da maio

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")
    }
  }
}

Em seguida, no arquivo build.gradle.kts no nível 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 principal do Android e a adicione ao seu 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 obrigatório

Nenhum código adicional é necessário para a integração com o Android.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob

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 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 maio retornou 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 do 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".

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.
  • 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.
  • Atualização da versão mínima necessária 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 e targetSdkVersion 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.
  • 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 e mensagens de erro 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.
  • Versão 1.1.13 do SDK de maio.

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.
  • 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.
  • 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.
  • 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.
  • 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 o SDK de maio versão 1.1.7.

Versão 1.1.6.1

  • Adaptador atualizado para oferecer suporte à nova API Premiada.
  • 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

  • Atualizamos o adaptador 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

  • 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 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.