Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios de maio usando mediação, cobrindo integrações de 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 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, é "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
- API do Android 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 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: configurar as configurações na interface do Maio
Primeiro, cadastre-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ê quer.
Intersticial
Insira o Nome do seu app, selecione a plataforma e insira URL do aplicativo. Selecione Intersticial em vídeo como o Tipo de anúncio e, em seguida, Clique em Atualizar.
Android
iOS
Premiado
Insira o Nome do seu app, selecione a plataforma e insira 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 o 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
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 da 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
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads maio Mediation e clique em Install.
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 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.
Depois, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Forçar resolução. 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.
Etapa 4: adicionar o código obrigatório
Android
Nenhum código extra é necessário para a integração com maio.
iOS
Integração com a 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
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 (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
o erro subjacente da resposta do anúncio usando
ResponseInfo
no
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 | pode ter retornado um erro específico do SDK. Consulte 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
- Compatível com o adaptador para Android principal versão 1.1.16.3.
- Compatível com o adaptador para iOS da Maio versão 2.1.5.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 2.0.2
- Suporte para o adaptador Android maiô versão 1.1.16.3.
- Compatível com o adaptador do iOS da Maio versão 2.1.4.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 2.0.1
- Suporte à versão 1.1.16.2 do adaptador Android maiô.
- Compatível com o adaptador do iOS da Maio versão 2.1.3.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 2.0.0
- Suporte à versão 1.1.16.2 do adaptador Android maiô.
- Suporte para a versão 2.1.1.0 do adaptador iOS do maiô.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 1.4.3
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/Maio/
. - Compatível com o adaptador para Android principal versão 1.1.16.2.
- Suporte à versão 1.6.3.1 do adaptador iOS do maiô.
- Criado e testado com a versão 8.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.4.2
- Compatível com o adaptador para Android principal versão 1.1.16.1.
- Suporte para a versão 1.6.3.0 do adaptador iOS do maio.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.0.
Versão 1.4.1
- Compatível com o adaptador para Android principal versão 1.1.16.1.
- Compatível com o adaptador para iOS da Maio versão 1.6.2.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.1.0.
Versão 1.4.0
- Suporte ao adaptador Android maiô versão 1.1.16.0.
- Compatível com o adaptador para iOS da Maio versão 1.6.0.1.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.6
- Suporte ao maio Android Adapter versão 1.1.16.0.
- Suporte ao maio iOS adapter versão 1.5.8.0.
Versão 1.3.5
- Compatível com o adaptador para Android principal versão 1.1.15.0.
- Compatível com o adaptador do iOS da Maio versão 1.5.6.1.
Versão 1.3.4
- Compatível com a versão 1.1.11.1 do adaptador Android maiô.
- Suporte ao adaptador iOS maiô versão 1.5.4.0.
Versão 1.3.3
- Compatível com o adaptador do Android principal versão 1.1.11.1.
- Compatível com o adaptador para iOS da Maio versão 1.5.3.1.
Versão 1.3.2
- Compatível com o adaptador do Android principal versão 1.1.11.0.
- Compatível com o adaptador para iOS da Maio versão 1.5.2.1.
Versão 1.3.1
- Compatível com o adaptador para Android principal versão 1.1.10.0.
- Suporte à versão 1.5.1.0 do adaptador iOS do maiô.
Versão 1.3.0
- Compatível com o adaptador para Android principal versão 1.1.10.0.
- Compatível com o adaptador para iOS da Maio versão 1.5.0.0.
Versão 1.2.3
- O plug-in foi atualizado para oferecer suporte à nova API Premiada.
- Suporte à versão 1.1.7.0 do adaptador Android.
- Compatível com o adaptador maio para iOS versão 1.4.6.0.
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.
- Oferece suporte ao adaptador de iOS de maio versão 1.4.1.0.
Versão 1.2.0
- Suporte à versão 1.1.4.1 do adaptador Android.
- Oferece suporte ao adaptador de iOS de maio versão 1.4.0.0.
Versão 1.1.3
- Suporte à versão 1.1.3.1 do adaptador Android.
- Compatível com o adaptador maio para iOS versão 1.3.2.0.
Versão 1.1.2
- Suporte à versão 1.1.3.0 do adaptador Android.
- Compatível com o adaptador maio para iOS versão 1.3.2.0.
Versão 1.1.1
- Oferece suporte ao adaptador maio do Android versão 1.1.1.0.
- 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
- Suporte à versão 1.0.7 do SDK do Android.
- Suporte à versão 1.2.19 do SDK para iOS.
Versão 1.0.0
- Primeira versão!
- Oferece suporte ao SDK do Android Maio versão 1.0.6.
- Oferece suporte ao SDK para iOS de maio versão 1.2.18.