Integrar maio com mediação

Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios de maio usando mediação, incluindo integrações em hierarquia. Ele aborda como adicionar maio à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador maio a um app Unity.

A interface do dashboard para maio usa texto em japonês para os rótulos, botões e descrições. As capturas de tela deste guia não foram traduzidas. No entanto, nas descrições e instruções apresentadas aqui, os rótulos e os botões são referidos por seus equivalentes em inglês. "URL キーム", por exemplo, é "Esquema de URL" 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 19 ou mais recente
  • Para implantar no iOS:
    • Meta 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.
  • Concluir o Guia explicativo sobre mediação

Etapa 1: definir configurações na IU de 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 seu aplicativo, selecione a plataforma e forneça o URL do aplicativo. Selecione Intersticial em vídeo como o Tipo de anúncio e clique em Atualizar.

Android

iOS

Premiado

Insira o Nome do seu aplicativo, selecione a plataforma e forneça o URL do aplicativo. 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 AdMob na próxima seção.

Android

iOS

Na página Gerenciamento da zona, anote o ID da zona. Ele também será necessário para configurar seu bloco de anúncios de 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 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 DE API.

Etapa 2: configurar a demanda de maio na AdMob 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 de maio

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 do link de download no Changelog para maio e extraia o GoogleMobileAdsMaioMediation.unitypackage do arquivo ZIP.

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

Em seguida, selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. A biblioteca do resolvedor do Play Services do Unity vai realizar a resolução de dependência do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do seu app Unity.

Etapa 4: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob

Os editores que usam a versão 7.26.0 ou posterior do SDK dos anúncios para dispositivos móveis do Google receberão automaticamente os anúncios de teste a partir de 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 do maio, ative os testes de uma única origem no Ad Inspector usando as maio (Bidding) and maio (Waterfall) origens de anúncios.

Códigos de erro

Se o adaptador não receber um anúncio de 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

Veja a seguir os códigos e as mensagens associadas geradas pelo adaptador maio quando o carregamento de um anúncio falhar:

Android

Código do erro Motivo
0-10 maio retornou um erro específico do SDK. Para saber mais, consulte a documentação de code e maio.
101 Maio não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, código 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. Para mais detalhes, consulte o code de maio.
101 maio ainda não tem um anúncio disponível.
102 Parâmetros de servidor inválidos (por exemplo, código da posição ausente).
103 O adaptador de maio não é compatível com o formato de anúncio solicitado.
104 Um anúncio já foi carregado para esta configuração de rede.

Registros de alterações do plug-in de mediação do Unity para maio

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

  • Atualização do plug-in para oferecer suporte à nova API Premiada.
  • Compatível com o adaptador de maio para Android versão 1.1.7.0.
  • Compatível com o adaptador de maio para iOS 1.4.6.0.

Versão 1.2.2

  • Compatível com o adaptador de maio para Android versão 1.1.6.0.
  • Compatível com o adaptador de maio para iOS 1.4.2.0.

Versão 1.2.1

  • Compatível com o adaptador de maio para Android versão 1.1.6.0.
  • Compatível com o adaptador de maio para iOS 1.4.1.0.

Versão 1.2.0

  • Compatível com o adaptador de maio para Android versão 1.1.4.1.
  • Compatível com o adaptador de maio para iOS 1.4.0.0.

Versão 1.1.3

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

Versão 1.1.2

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

Versão 1.1.1

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

Versão 1.1.0

  • Compatível com o adaptador de maio para Android versão 1.1.0.0.
  • Compatível com o adaptador de maio para iOS 1.3.0.0.

Versão 1.0.2

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

Versão 1.0.1

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

Versão 1.0.0

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