Integrar maio com a Mediação

Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios de maio usando mediação, incluindo integrações em 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 para maio usa texto em japonês para os rótulos, botões e descrições. 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 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 Ad Manager 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 19 ou mais recente
  • SDK maio 1.0.7 ou superior

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

  • Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na IU 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 no nível 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 do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador Maven:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.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 (em inglês) e adicione-a 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: adicionar o código necessário

Nenhum código extra é necessário para a integraçã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 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

Veja a seguir os códigos e as mensagens que acompanham o adaptador de maio quando o carregamento de um anúncio falhar:

Código do erro Motivo
0-10 maio retornou um erro específico do SDK. Para saber mais, consulte a documentação de code e maio.
101 Maio não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, código 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. Para mais detalhes, consulte o code de maio.
101 maio ainda não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, código 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 a 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 da 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 da Maio versão 1.1.16.

Versão 1.1.16.0

  • Atualizamos os códigos de erro para capturar mais erros de maio.
  • Verificação da compatibilidade com o SDK de maio versão 1.1.16.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 da Maio versão 1.1.16.

Versão 1.1.15.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.15.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 20.0.0.

Criado e testado com:

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

Versão 1.1.14.0

  • Foram adicionados códigos de erro e mensagens de adaptador padronizados.
  • Verificação da compatibilidade com o SDK de maio versão 1.1.14.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 19.8.0.

Criado e testado com:

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

Versão 1.1.13.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.13.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 19.5.0.

Criado e testado com:

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

Versão 1.1.12.0

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

Criado e testado com:

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

Versão 1.1.11.1

  • Para limitar os tempos, as solicitações de anúncio vão apresentar uma falha imediatamente se maio não tiver um anúncio pronto para ser exibido.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 19.1.0.

Criado e testado com:

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

Versão 1.1.11.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.11.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.3.0.

Criado e testado com:

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

Versão 1.1.10.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.10.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.2.0.

Versão 1.1.8.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.8.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.1.0.

Versão 1.1.7.0

  • Correções de bugs
  • Verificação da compatibilidade com o SDK de maio versão 1.1.7.

Versão 1.1.6.1

  • Adaptador atualizado para oferecer suporte à nova API Premiada.
  • A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 17.2.0.

Versão 1.1.6.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.6.

Versão 1.1.5.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.5.

Versão 1.1.4.0

  • Verificação da compatibilidade 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 de Singleton.

Versão 1.1.3.0

  • Verificação da compatibilidade 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

  • Verificação da compatibilidade 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

  • Verificação da compatibilidade com o SDK de maio versão 1.1.1.

Versão 1.1.0.0

  • Verificação da compatibilidade com o SDK de maio versão 1.1.0.

Versão 1.0.8.0

  • Verificação da compatibilidade 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 não fossem carregados.

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.
  • Verificação da compatibilidade com o SDK de maio versão 1.0.7.

Versão 1.0.6.0

  • Primeira versão!
  • Adicionado suporte a intersticiais e anúncios em vídeo premiados.