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 do 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 seus equivalentes em inglês. "URL スキーム", por exemplo, é "URL Scheme".

Integrações e formatos de anúncio aceitos

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

Requisitos

• API Android nível 24 ou mais recente.

• SDK da maio 1.0.7 ou mais recente

• Última 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 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 de sua preferência.

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

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 Nome exclusivo para seu grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e defina 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 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 nome exclusivo e ative a mediação.

Ative a Coleta automática de dados e insira o ID da API e a CHAVE DA 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 Tipo de integração, Android como a Plataforma e Ativo como o Status. Insira o ID da mídia e o ID da zona obtidos na seção anterior. Em seguida, insira um valor de CPM padrão.

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

Etapa 3: importar o SDK e o adaptador da maio

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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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 da maio e adicione 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 do Android.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

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

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 editores podem verificar o erro na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

Confira os códigos e as mensagens geradas pelo adaptador da maio quando um anúncio não é carregado: