Integrar maio com a Mediação

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.

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 o ID do bloco de anúncios para mediação. Na página da API Reporting, anote o ID da API e a CHAVE DE API.

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

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.2.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".
0-10 maio retornou um erro específico do SDK. Consulte 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 do canal 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 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 e targetSdkVersion 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 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 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.