Integrar maio com mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios de maio usando a mediação, 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 do Unity.

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 aqui, os rótulos e botões são citados pelos equivalentes em inglês. "URL スキーム", por exemplo, é "URL Scheme" e assim por diante.

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
Intersticiais
Premiado

Requisitos

  • Unity 4 ou mais recente
  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS de 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 o artigo Começar para ver mais detalhes.
  • Concluir o Guia explicativo de mediação

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

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

Selecione a guia correspondente ao seu Tipo de anúncio preferido.

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.

Android

iOS

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.

Android

iOS

Na página Gerenciamento de aplicativos, anote o ID da mídia. É necessário 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 cascata) Além do ID da mídia e do ID da zona, você precisará do ID de API e da CHAVE de 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 maio na Ad Manager interface

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

Android

Para conferir 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, poderá instalar o plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

OpenUPM

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

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

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads maio Mediation e clique em Install.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação do Google Mobile Ads para maio no link de download no Changelog 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ê transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app Unity.

Forçar resolução

Etapa 4: adicionar o código obrigatório

Android

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

iOS

Integração com a SKAdNetwork

Consulte a documentação do Maio (em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Etapa 5: testar a implementação

Códigos de erro

Se o adaptador não receber um anúncio de maio, os editores poderão verificar o erro subjacente da 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 associadas gerados pelo adaptador maio quando um anúncio não é carregado:

Android

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

iOS

Código do erro Motivo
0-10 pode ter retornado 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 do servidor inválidos (por exemplo, ID da posição ausente).
103 O adaptador maio não oferece suporte ao formato de anúncio solicitado.
104 Um anúncio já foi carregado para essa configuração de rede.

Registro de alterações do plug-in da Unity Mediation de maio

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.
  • Oferece suporte ao adaptador maio do Android versão 1.1.7.0.
  • Suporte à versão 1.4.6.0 do adaptador para iOS.

Versão 1.2.2

  • Suporte à versão 1.1.6.0 do adaptador Android.
  • Suporte para a versão 1.4.2.0 do adaptador para iOS.

Versão 1.2.1

  • Suporte à versão 1.1.6.0 do adaptador Android.
  • Suporte à versão 1.4.1.0 do adaptador para iOS.

Versão 1.2.0

  • Suporte à versão 1.1.4.1 do adaptador Android maio.
  • Suporte para a versão 1.4.0.0 do adaptador para iOS.

Versão 1.1.3

  • Compatível com o adaptador maio do Android versão 1.1.3.1.
  • Suporte para a versão 1.3.2.0 do adaptador para iOS.

Versão 1.1.2

  • Compatível com o adaptador maio do Android versão 1.1.3.0.
  • Compatível com o adaptador maio para iOS versão 1.3.2.0.

Versão 1.1.1

  • Suporte à versão 1.1.1.0 do adaptador do Android.
  • Suporte à versão 1.3.1.1 do adaptador para iOS.

Versão 1.1.0

  • Suporte à versão 1.1.0.0 do adaptador Android.
  • Suporte à versão 1.3.0.0 do adaptador para iOS.

Versão 1.0.2

  • Suporte à versão 1.0.8 do SDK do Android.
  • Suporte à versão 1.2.19 do SDK para iOS.

Versão 1.0.1

  • Suporte à versão 1.0.7 do SDK do Android.
  • Oferece suporte ao SDK para iOS de maio versão 1.2.19.

Versão 1.0.0

  • Primeira versão!
  • Suporte à versão 1.0.6 do SDK do Android.
  • Oferece suporte ao SDK para iOS de maio versão 1.2.18.