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 a mediação, 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 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 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 24 ou mais recente

• SDK da maio 1.0.7 ou mais recente

• Mais recente GMA Next-Gen SDK

• Leia todo o guia para iniciantes da 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 na barra lateral esquerda e em New app.

Selecione a guia correspondente ao Ad Type preferido.

Intersticial

Insira o Name do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video interstitial como o Ad Type e, em seguida, clique em Update.

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

Premiado

Insira o Name do app, selecione a plataforma e forneça o URL do aplicativo. Selecione Video Rewards como o Ad Type e clique em Update.

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, anote o código da mídia. Ele é necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.

Na página Zone Management, anote o Zone ID. Ele também será necessário para configurar o bloco de anúncios do Ad Manager na próxima seção.

Além do Media ID e do Zone ID, você vai precisar do API ID e API KEY 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.

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 API ID e a API KEY sejam emitidos para você.

Etapa 2: configurar a demanda da maio na interface do Ad Manager

Definir as configurações de mediação do 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 Name exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o formato do anúncio e defina o tipo de inventário como Mobile App. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis a que 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 Name exclusivo e ative a Mediação.

Ative a coleta automática de dados e insira o API ID e a chave de API obtidos na seção anterior.

Depois que o parceiro de rendimento for selecionado, escolha Mediação de SDK para dispositivos móveis como o Integration type, Android como a Platform, e Active como o Status. Insira o Media ID e o Zone ID obtidos na seção anterior. Em seguida, insira um valor de CPM padrão.

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

Clique em Salvar na parte de baixo da página quando terminar.

Observação: a coleta de dados automática leva alguns dias para reunir os dados antes de calcular com precisão um valor de CPM dinâmico para uma rede de mediação. Depois que o eCPM for calculado, ele será atualizado 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 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 do 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 para Ad Manager.

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 do Ad Manager 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 subjacente 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 do canal ausente).
103	O contexto usado para carregar um anúncio não era uma instância de `Activity`.