Integrar a maio com a mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da maio usando Mediação da AdMob, incluindo integrações em hierarquia. Ele explica como adicionar a maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da maio a um app Android.

A interface do painel da maio usa texto em japonês para marcadores, 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 marcadores e botões são referenciados com os equivalentes em inglês. Por exemplo, "URL スキーム" é "URL Scheme".

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• API Android nível da API 24 ou mais recente.

• SDK da maio 1.0.7 ou mais recente.

• Mais recente GMA Next-Gen SDK.

• Conclua o guia de introdução à mediação .

Etapa 1: definir as configurações na interface da maio

Primeiro, inscreva-se ou faça login na sua conta da maio. Clique no botão Application management (Gerenciamento de aplicativos) na barra lateral esquerda e em New app (Novo app).

Selecione a guia correspondente ao tipo de anúncio preferido.

Intersticial

Insira o nome do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video interstitial (Intersticial em vídeo) como o tipo de anúncio e, em seguida, clique em Update (Atualizar).

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

Premiado

Insira o nome do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video Rewards (Vídeos premiados) como o tipo de anúncio e clique em Update (Atualizar).

Observação:os anúncios em vídeo premiados da maio NÃO são puláveis por padrão.

Na página Application Management (Gerenciamento de aplicativos), anote o código da mídia. Ele é necessário para configurar o bloco de anúncios da AdMob na próxima seção.

Na página Zone Management (Gerenciamento de zonas), anote o ID da zona. Ele também será necessário para configurar o 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 esta for a primeira vez que você configura sua conta da maio, talvez seja necessário entrar em contato com a equipe de suporte da maio para que o ID da API e a chave da API sejam emitidos para você.

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

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

Adicione a maio à configuração de mediação do seu bloco de anúncios.

Primeiro, entre na sua conta do AdMob. Em seguida, acesse a guia Mediação. Caso queira modificar um grupo de mediação, clique no nome dele para editar 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, depois 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 dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a maio como uma origem de anúncios

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione maio e ative a chave Otimizar. Insira o ID da API e a chave da API obtidos na seção anterior para configurar a otimização da origem de anúncios para a maio. Em seguida, insira um valor de eCPM para a 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 a maio, selecione-o. Caso contrário, clique em Adicionar mapeamento.

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

Importante: o ID da mídia precisa ser associado ao app segmentado, como na interface da maio.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes e calcular com precisão o eCPM de uma rede de mediação. Enquanto isso, o status da otimização é PENDING. Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios começará a atualizá-lo automaticamente em seu nome.

Etapa 3: importar o SDK e o adaptador da maio

Observação: a falha na integração das versões compatíveis do SDK da maio e do GMA Next-Gen SDK 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")
    }
  }
}

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

• Baixe a versão mais recente do SDK do Android e adicione o ao seu projeto.
• Navegue até os artefatos do adaptador da maio no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo `.aar` do adaptador da maio e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste na AdMob.

Os publishers que usam a versão 11.6.0 ou mais recente do GMA Next-Gen SDK vão receber automaticamente anúncios de teste da maio em smartphones e tablets registrados como dispositivos de teste ao fazer solicitações.

Importante: desative o modo de teste da AdMob e da maio 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 da maio, os publishers poderão verificar o erro na resposta do anúncio usando ResponseInfo.getAdSourceResponses() 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 correspondentes gerados pelo adaptador da maio quando um anúncio não é carregado:

Código do erro	Motivo
0-10	A maio retornou um erro específico do SDK. Consulte o código e a documentação da maio para mais detalhes.
101	A maio não tem um anúncio disponível.
102	Parâmetros de servidor inválidos (por exemplo, ID de posicionamento ausente).
103	O contexto usado para carregar um anúncio não era uma instância de `Activity`.