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

A interface do painel para maio usa texto em japonês nos rótulos, botões e descrições. As capturas de tela neste 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 de maio 1.0.7 ou mais recente

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

• Concluir o Guia para iniciantes de mediação

Etapa 1: configurar as configurações na interface do Maio

Primeiro, cadastre-se ou faça login na sua conta do Maio. Clique no botão Gerenciamento de aplicativos na barra lateral esquerda e em Novo app.

Selecione a guia correspondente ao tipo de anúncio que você quer.

Intersticial

Insira o nome do app, selecione a plataforma e informe o URL do app. Selecione Intersticial em vídeo como o tipo de anúncio e clique em Atualizar.

Observação:os anúncios intersticiais de maio são puláveis por padrão.

Premiado

Insira o nome do app, selecione a plataforma e informe o URL do app. Selecione Recompensas de vídeo como o Tipo de anúncio e clique em Atualizar.

Observação:os anúncios em vídeo premiados de maio NÃO podem ser pulados por padrão.

Na página Gerenciamento de aplicativos, anote o ID da mídia. É necessário configurar o 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.

Observação: se você estiver configurando sua conta maio pela primeira vez, talvez seja necessário entrar em contato com a equipe de suporte da maio para receber seu ID de API e a chave de API.

Etapa 2: configurar a demanda de maio na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

É necessário adicionar maio à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar a maio como uma origem de anúncios.

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

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

Dê um nome ao grupo de mediação e selecione os locais de segmentação. 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 blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar maio como uma origem de anúncios

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

Selecione maio e ative a chave Optimize. Insira o ID da API e a CHAVE DE API obtida 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.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para "maio", selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID da mídia e o ID da zona recebidos na seção anterior. Em seguida, clique em Concluído.

Importante: o ID da mídia precisa ser associado ao app de destino, como na interface do Maio.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes para calcular o eCPM com precisão para uma rede de mediação. Enquanto isso, o status da otimização da origem de anúncios é PENDING. Portanto, é necessário definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios vai começar a atualizar o eCPM automaticamente.

Etapa 3: importar o SDK e o adaptador da maio

Observação: a falha na integração das versões compatíveis do Maio e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Integração com o Android Studio (recomendada)

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 do app, adicione as dependências e configurações de implementação abaixo. Use as versões mais recentes do SDK e do adaptador do maiô:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.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 do Android maiô e adicione ao projeto.
• Navegue até os artefatos do adaptador maiô no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo ".aar" do adaptador maio e adicione-o ao projeto.

Etapa 4: adicionar o código necessá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 na AdMob.

Os editores que usam a versão 11.6.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google vão receber anúncios de teste automaticamente a partir de maio em smartphones e tablets registrados como dispositivos de teste ao fazer solicitações.

Importante: desative o modo de teste da AdMob e do maiô antes de lançar o app.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da maio, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios maio (hierarquia).

Códigos de erro

Se o adaptador não receber um anúncio do 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	pode ter retornado um erro específico do SDK. Consulte o código e a documentação para saber mais.
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 adaptador do Android Mediation de maio

Versão 1.1.16.3

• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.0.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
• Versão 1.1.16 do SDK de maio.

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.
• Versão 1.1.16 do SDK de maio.

Versão 1.1.15.0

• Compatibilidade verificada com a versão 1.1.15 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.0.0.

Criado e testado com:

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

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.
• Atualizamos a 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.
• Versão 1.1.14 do SDK de maio.

Versão 1.1.13.0

• Compatibilidade verificada com a versão 1.1.13 do SDK de maio.
• Atualizamos a 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.
• 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.
• Versão 1.1.12 do SDK de maio.

Versão 1.1.11.1

• Para limitar os timeouts, as solicitações de anúncio agora vão falhar imediatamente se não houver um anúncio pronto para ser exibido.
• 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.
• Versão 1.1.11 do SDK de maio.

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.
• Atualizamos a 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.
• Compatibilidade verificada com a versão 1.1.7 do SDK de maio.

Versão 1.1.6.1

• O adaptador foi atualizado para oferecer suporte à nova API Rewarded.
• 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

• Atualizamos o adaptador 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 a versão 1.1.0 do SDK de maio.

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