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
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
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é Janela > Package Manager para abrir o O Unity Package Manager e selecione Meus registros no menu suspenso.
Selecione o pacote Google Mobile Ads Mediation e Clique em Instalar.
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.
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
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 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 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
- 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 a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.0.2
- Compatível com o adaptador para Android principal 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
- Compatível com o adaptador para Android principal versão 1.1.16.2.
- 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
- Compatível com o adaptador para Android principal versão 1.1.16.2.
- Compatível com o adaptador do iOS da Maio versão 2.1.1.0.
- 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/
. - Suporte à versão 1.1.16.2 do adaptador Android maiô.
- Compatível com o adaptador para iOS da Maio versão 1.6.3.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.
Versão 1.4.2
- 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.3.0.
- 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.
- Suporte para a versão 1.6.2.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 7.1.0.
Versão 1.4.0
- Suporte à versão 1.1.16.0 do adaptador Android maiô.
- Suporte à versão 1.6.0.1 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.0.0.
Versão 1.3.6
- Suporte à versão 1.1.16.0 do adaptador Android maiô.
- Compatível com o adaptador para iOS da Maio 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 o adaptador do Android principal versão 1.1.11.1.
- 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 do Android principal versão 1.1.10.0.
- Compatível com o adaptador do iOS da Maio versão 1.5.1.0.
Versão 1.3.0
- Compatível com o adaptador do 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.
- 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.