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 da maio usando a mediação, abordando integrações em cascata. Ele aborda 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 Unity.

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 aqui, os rótulos e botões são referidos pelos 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:

Integração
Lances
Cascata
Formatos
Banner
Intersticiais
Premiado

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou versões mais recentes
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o guia de primeiros passos da mediação.

Etapa 1: configurar as configurações na interface do 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 que você prefere.

Intersticial

Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.

Android

iOS

Premiado

Insira o Nome do app, selecione a plataforma e forneça o URL do app. Selecione Vídeos premiados como o Tipo de anúncio e clique em Atualizar.

Android

iOS

Na página Gerenciamento de aplicativos, anote o ID da mídia. Ela é necessária para configurar seu bloco de anúncios da AdMob na próxima seção.

Android

iOS

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.

Android

iOS

(Somente em cascata) 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.

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

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

Etapa 3: importar o SDK e o adaptador da maio

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Mediação do Google Mobile Ads Maio e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para maio no link de download do Registro de mudanças e extraia o GoogleMobileAdsMaioMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMaioMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

Etapa 4: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação do maio para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 5: testar a implementação

Ativar anúncios de teste

Verifique se você registrou seu dispositivo de teste na AdMob.

Os editores que usam a versão 7.26.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google recebem 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 poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

Formato Nome da classe
Intersticial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Premiado jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Formato Nome da classe
Intersticial GADMMaioInterstitialAdapter
Premiado GADMMaioRewardedAdapter

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

Android

Código do erro Motivo
0-10 maio retornou um erro específico do SDK. Consulte o código e a documentação do maio para mais detalhes.
101 Maio não tem um anúncio disponível.
102 Parâmetros de 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".

iOS

Código do erro Motivo
0-10 maio retornou um erro específico do SDK. Consulte o código de maio para mais detalhes.
101 maio ainda não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, ID da posição ausente).
103 O adaptador da Maio não é compatível com o formato de anúncio solicitado.
104 Um anúncio já está carregado para essa configuração de rede.

maio Unity Mediation Plugin Changelog

Versão 3.0.2

Versão 3.0.1

Versão 3.0.0

Versão 2.0.4

Versão 2.0.3

Versão 2.0.2

Versão 2.0.1

Versão 2.0.0

Versão 1.4.3

Versão 1.4.2

Versão 1.4.1

Versão 1.4.0

Versão 1.3.6

Versão 1.3.5

Versão 1.3.4

Versão 1.3.3

Versão 1.3.2

Versão 1.3.1

Versão 1.3.0

Versão 1.2.3

  • O plug-in foi atualizado para oferecer suporte à nova API Rewarded.
  • Compatibilidade com a versão 1.1.7.0 do adaptador do Android maio.
  • Compatibilidade com a versão 1.4.6.0 do adaptador do iOS maio.

Versão 1.2.2

  • Compatibilidade com a versão 1.1.6.0 do adaptador do Android maio.
  • Compatível com a versão 1.4.2.0 do adaptador do iOS da maio.

Versão 1.2.1

  • Compatibilidade com a versão 1.1.6.0 do adaptador do Android maio.
  • Compatibilidade com a versão 1.4.1.0 do adaptador do maio iOS.

Versão 1.2.0

  • Compatível com a versão 1.1.4.1 do adaptador do Android maio.
  • Compatível com a versão 1.4.0.0 do adaptador do iOS da maio.

Versão 1.1.3

  • Compatibilidade com a versão 1.1.3.1 do adaptador do Android maio.
  • Compatibilidade com a versão 1.3.2.0 do adaptador do iOS da maio.

Versão 1.1.2

  • Compatibilidade com a versão 1.1.3.0 do adaptador do Android maio.
  • Compatibilidade com a versão 1.3.2.0 do adaptador do iOS da maio.

Versão 1.1.1

  • Compatibilidade com a versão 1.1.1.0 do adaptador do Android maio.
  • Compatível com a versão 1.3.1.1 do adaptador do maio para iOS.

Versão 1.1.0

  • Compatibilidade com a versão 1.1.0.0 do adaptador maio Android.
  • Compatível com a versão 1.3.0.0 do adaptador do iOS da maio.

Versão 1.0.2

  • Compatibilidade com a versão 1.0.8 do SDK do Android maio.
  • Compatível com a versão 1.2.19 do SDK do maio para iOS.

Versão 1.0.1

  • Compatível com a versão 1.0.7 do SDK do Android maio.
  • Compatível com a versão 1.2.19 do SDK do maio para iOS.

Versão 1.0.0

  • Primeira versão!
  • Compatível com a versão 1.0.6 do SDK do Android maio.
  • Compatível com a versão 1.2.18 do SDK do maio para iOS.