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 maio à propriedade de um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador de maio a um App Unity

A interface do dashboard de 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, nestas descrições e instruções, os rótulos e botões referidos pelos equivalentes em inglês. Por exemplo, "URL スキーム" é "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 Acesse Primeiros passos para ver mais detalhes.
  • Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na interface 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 Ad Manager 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 Ad Manager 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 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 de maio

OpenUPM-CLI

Se você tiver a OpenUPM-CLI instalado, é possível instalar a API Google Mobile Ads Plug-in de mediação para Unity no seu projeto executando o seguinte comando do diretório raiz do seu projeto:

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

OpenUPM

No editor de projetos do Unity, selecione Editar > Configurações do projeto > Package Manager para abrir o Configurações do Unity Package Manager.

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

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

Detalhes do OpenUPM

Em seguida, navegue até Janela > Package Manager para abrir o O Unity Package Manager e selecione Meus registros no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Mediation 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 em as Registro de alterações e extrair o GoogleMobileAdsMaioMediation.unitypackage do ZIP .

No editor de projetos do Unity, selecione Assets > Importar pacote > Pacote personalizado e encontre a GoogleMobileAdsMaioMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Importação.

Importar do Unity

Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar resolução. O resolvedor do Unity Play Services vai realizar a resolução das dependências do zero e copiar a suas dependências declaradas no diretório Assets/Plugins/Android 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.

iOS

Integração com a SKAdNetwork

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em Ad Manager

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 (Waterfall) origens de anúncios.

Códigos de erro

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

Estes são os códigos e as mensagens de acompanhamento geradas pelo adaptador de maio quando ocorre uma falha no carregamento de um anúncio:

Android

Código do erro Motivo
0-10 maio retornou um erro específico do SDK. Veja o código e a documentação de maio para mais detalhes.
101 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".

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 do canal 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.

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

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 Premiada.
  • Compatível com o adaptador maio do Android versão 1.1.7.0.
  • Compatível com o adaptador de iOS de maio versão 1.4.6.0.

Versão 1.2.2

  • Oferece suporte ao adaptador maio do Android versão 1.1.6.0.
  • Suporte para a versão 1.4.2.0 do adaptador para iOS.

Versão 1.2.1

  • Oferece suporte ao adaptador maio do Android versão 1.1.6.0.
  • Oferece suporte ao adaptador de iOS de maio versão 1.4.1.0.

Versão 1.2.0

  • Oferece suporte à versão 1.1.4.1 do adaptador do Android Maio.
  • Oferece suporte ao adaptador de iOS de maio versão 1.4.0.0.

Versão 1.1.3

  • Compatível com o adaptador maio do Android versão 1.1.3.1.
  • Oferece suporte ao adaptador de iOS de maio versão 1.3.2.0.

Versão 1.1.2

  • Suporte à versão 1.1.3.0 do adaptador Android.
  • Oferece suporte ao adaptador de iOS de maio versão 1.3.2.0.

Versão 1.1.1

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

Versão 1.1.0

  • Oferece suporte ao adaptador maio do Android versão 1.1.0.0.
  • Oferece suporte ao adaptador de iOS de maio versão 1.3.0.0.

Versão 1.0.2

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

Versão 1.0.1

  • Oferece suporte ao SDK do Android Maio versão 1.0.7.
  • 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.