Integrar maio à mediação

Neste guia, mostramos como usar o SDK do Google Mobile Ads para carregar e exibir anúncios de maio usando mediação, abrangendo integrações em hierarquia. O artigo 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 aplicativoAndroid .

A interface do painel para maio usa texto em japonês para os 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 referenciados pelos equivalentes em inglês. "URL 東キーム", por exemplo, é "Esquema de URL" e assim por diante.

Integrações e formatos de anúncio compatíveis

O adaptador de mediação AdMob para maio tem os seguintes recursos:

Integração
Lances
Cachoeira
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • API do Android de nível 19 ou mais recente
  • SDK de maio 1.0.7 ou posterior

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o guia de iniciação de mediação

Etapa 1: configurar a rede 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 aplicativo.

Selecione a guia correspondente ao Tipo de anúncio de sua preferência.

Intersticial

Insira o Nome do seu aplicativo, defina a plataforma como Android 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, defina a plataforma como Android 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 AdMob na próxima seção.

Na página Gerenciamento de zona, anote o ID da zona. Também será necessário configurar seu bloco de anúncios 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 de API para configurar seu ID do bloco de anúncios Android para mediação.

Na página da API Reporting, anote o ID da API e a CHAVE de API.

Etapa 2: definir as configurações de mediação para seu AdMob bloco de anúncios

É preciso adicionar maio à configuração de mediação do seu bloco de anúncios. Primeiro, faça login na sua conta da AdMob.

Acesse a guia Mediação. Para modificar um grupo de mediação atual, clique no nome dele para fazer a edição e pule para Add maio as an ad source.

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

Insira o Formato do anúncio e a Plataforma 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úncios atuais da AdMob. Em seguida, clique em Concluído.

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

Adicionar maio como uma origem de anúncios

No card "Origens de anúncios", selecione Adicionar rede de anúncios. Selecione maio como rede de publicidade e insira o API ID e a API KEY da seção anterior para configurar a otimização da origem de anúncios em maio. Em seguida, insira um valor de eCPM para maio e clique em Continuar.

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

Em seguida, insira um Nome de mapeamento, um ID de mídia e um ID de zona encontrados na seção anterior. Clique em Concluído.

Etapa 3: importar o SDK e o adaptador de maio

Adicione o seguinte repositório Maven e dependência de implementação com a versão mais recente do SDK do maio (link em inglês) no arquivo build.gradle no nível do aplicativo:

repositories {
    google()
    mavenCentral()
    maven {
        url "https://imobile-maio.github.io/maven"
    }
}

...
dependencies {
   implementation 'com.google.android.gms:play-services-ads:22.4.0'
   implementation 'com.google.ads.mediation:maio:1.1.16.2'
}
...

Integração manual

  • Faça o download da versão mais recente do SDK do Android para maio e adicione-o 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 seu projeto.

Etapa 4: código extra necessário

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

Etapa 5: testar a implementação

Ao fazer solicitações, 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 anúncios de teste de maio em telefones e tablets registrados como test devices.

Códigos de erro

Se o adaptador não receber um anúncio de maio, os editores podem 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.Intersticial
Premiado jp.maio.sdk.android.Mediation.admob.adapter.Rewarded

Estes são os códigos e as mensagens 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. Para saber mais, consulte a documentação sobre código e maio (links em inglês).
101 Maio não tem um anúncio disponível.
102 Parâmetros de 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".
0-10 maio retornou um erro específico do SDK. Veja o código de maio para mais detalhes.
101 maio ainda não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, ID da posição ausente).
103 O adaptador de maio não é compatível com o formato de anúncio solicitado.
104 Um anúncio já foi carregado para esta configuração de rede.

registro de alterações do adaptador de mediação do Android maio

Próxima versão

  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 22.4.0.

Versão 1.1.16.2

  • O adaptador foi atualizado para usar a nova classe VersionInfo.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 Maio versão 1.1.16.

Versão 1.1.16.1

  • compileSdkVersion e targetSdkVersion foram atualizados para o nível 31 da API
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 Maio versão 1.1.16.

Versão 1.1.16.0

  • Atualização dos códigos de erro para capturar mais erros de maio.
  • Compatibilidade verificada com o SDK de maio versão 1.1.16.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 20.4.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
  • SDK Maio versão 1.1.16.

Versão 1.1.15.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.15.
  • Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 20.0.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
  • SDK Maio versão 1.1.15.

Versão 1.1.14.0

  • Códigos de erro e mensagens de adaptador padronizados foram adicionados.
  • Compatibilidade verificada com o SDK de maio versão 1.1.14.
  • Atualização da 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.
  • SDK Maio versão 1.1.14.

Versão 1.1.13.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.13.
  • Atualização da 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 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 19.4.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
  • SDK Maio versão 1.1.12.

Versão 1.1.11.1

  • Para limitar tempos, as solicitações de anúncio 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 19.1.0.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
  • SDK Maio versão 1.1.11.

Versão 1.1.11.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.11.
  • Atualização da 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.
  • SDK Maio versão 1.1.11.

Versão 1.1.10.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.10.
  • Atualização da 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

  • Foi verificada a compatibilidade com o SDK de maio versão 1.1.8.
  • Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.1.0.

Versão 1.1.7.0

  • Correções de bugs
  • Foi verificada a compatibilidade com o SDK de maio versão 1.1.7.

Versão 1.1.6.1

  • O adaptador foi atualizado para oferecer suporte à nova API obrigatória.
  • Atualização da 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 o SDK de maio versão 1.1.6.

Versão 1.1.5.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.5.

Versão 1.1.4.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.4.

Versão 1.1.3.1

  • O adaptador foi atualizado para funcionar com a classe de instância em vez do singleton.

Versão 1.1.3.0

  • Compatibilidade verificada com o SDK de maio versão 1.1.3.

Versão 1.1.2.1

  • O adaptador foi atualizado com as 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 o SDK de maio versão 1.1.1.

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 poderia fazer com que NullPointerExceptions ocorresse quando os anúncios falhasse no carregamento.

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

  • Primeiro lançamento!
  • Agora é possível usar anúncios em vídeo premiados e intersticiais.