Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Pangle usando mediação, cobrindo as integrações de e em cascata. Ele aborda como adicionar a Pangle à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Pangle a um Unity app.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação AdMob para Pangle tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
| Intersticial premiado | |
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Unity 5.6 ou mais recente
- [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para Pangle 2.4.0 ou mais recente (recomenda-se a versão 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 12.0 ou mais recente
- Um projeto Unity funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes de mediação
Etapa 1: configurar as configurações na interface do Pangle
Crie ou faça login na sua conta do Pangle.
Adicionar um novo aplicativo
Navegue até a guia Aplicativos e clique no botão Adicionar app.
Selecione o sistema operacional para o qual você quer criar um aplicativo e preencha o restante do formulário. Em seguida, clique em Enviar.
Android
iOS
Anote o ID do app.
Android
iOS
Criar uma posição de anúncio
Depois que o aplicativo for criado, clique no botão Adicionar para criar a posição do anúncio.
Android
iOS
Lances
Selecione o Formato do anúncio e o Nome do posicionamento do anúncio e selecione Lances no app como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.
Depois que a posição do anúncio for criada, anote o ID da posição do anúncio.
Android
iOS
Cascata
Selecione o formato do anúncio e o nome do posicionamento do anúncio e CPM global como tipo de preço. Preencha o restante do formulário e clique em Enviar.
Depois que a posição do anúncio for criada, anote o ID da posição do anúncio.
Android
iOS
Localizar a chave da API Pangle Reporting
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Anote o ID do usuário no canto inferior esquerdo da página.
Clique em Integrações > SDK e API > API Reporting 2.0 da Pangle. Anote o ID de função e a chave de segurança.
Ativar o modo de teste
Siga as instruções no guia Como adicionar um anúncio de teste do Pangle para ativar os anúncios de teste do Pangle.
Etapa 2: configurar a demanda do Pangle na AdMob interface
Configurar as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 no guia para Android.
iOS
Para ver as instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador da Pangle
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da Pangle para anúncios do Google para dispositivos móveis no seu projeto executando o comando abaixo no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.pangleOpenUPM
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
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 Pangle Mediation e clique em Install.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para
Pangle no link de download no
Changelog
e extraia o
GoogleMobileAdsPangleMediation.unitypackage do arquivo
zip.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o
arquivo GoogleMobileAdsPangleMediation.unitypackage
que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em
Import.
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 do Unity.
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração com a Pangle.
iOS
Integração da SKAdNetwork
Siga a documentação da Pangle
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 na AdMob e ative o modo de teste na interface da Pangle.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Pangle, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Pangle (lances) e Pangle (hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio da Pangle, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo nas
seguintes classes:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Confira os códigos e as mensagens que acompanham os códigos gerados pelo adaptador Pangle quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição ausente). |
| 102 | com.google.ads.mediation.pangle | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Pangle. |
| 103 | com.google.ads.mediation.pangle | Resposta de lance ausente ou inválida. |
| -1-60000 | com.pangle.ads | O SDK do Pangle retornou um erro. Consulte a documentação do Pangle para mais detalhes. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição ausente). |
| 102 | com.google.ads.mediation.pangle | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Pangle. |
| -1-60000 | Enviado pelo SDK da Pangle | O SDK do Pangle retornou um erro. Consulte a documentação do Pangle para mais detalhes. |
Registro de alterações do plug-in de mediação da Pangle para Unity
Versão 4.4.2
- Suporte para a versão 6.3.0.4.0 do adaptador Pangle para Android.
- Suporte à versão 6.3.1.0.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.4.1
- Suporte para a versão 6.3.0.4.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 6.3.0.8.0.
- Criado e testado com a versão 9.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.4.0
- Suporte à versão 6.3.0.2.0 do adaptador Pangle para Android.
- Suporte à versão 6.3.0.6.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.3.3
- Suporte para a versão 6.2.0.7.0 do adaptador Pangle para Android.
- Suporte à versão 6.2.0.9.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.3.2
- Suporte à versão 6.2.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 6.2.0.8.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.3.1
- Suporte à versão 6.2.0.5.0 do adaptador Pangle para Android.
- Suporte à versão 6.2.0.7.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.3.0
- Suporte à versão 6.2.0.4.0 do adaptador Pangle para Android.
- Suporte à versão 6.2.0.5.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.2.1
- Suporte para a versão 6.1.0.7.0 do adaptador Pangle para Android.
- Suporte à versão 6.1.0.6.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.2.0
DummyClientfoi renomeado comoPlaceholderClient- Suporte à versão 6.1.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 6.1.0.5.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.1.0
- Suporte à versão 6.0.0.8.0 do adaptador Pangle para Android.
- Suporte à versão 6.1.0.5.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 9.1.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 4.0.1
- Suporte à versão 6.0.0.5.0 do adaptador Pangle para Android.
- Suporte à versão 6.0.0.6.0 do adaptador Pangle para iOS.
- 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 4.0.0
- Suporte à versão 6.0.0.5.0 do adaptador Pangle para Android.
- Suporte à versão 6.0.0.5.0 do adaptador Pangle para iOS.
- 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 3.0.0
- Suporte para a versão 6.0.0.3.0 do adaptador Pangle para Android.
- Suporte à versão 5.9.0.9.0 do adaptador Pangle para iOS.
- 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.8.1
- Suporte à versão 5.9.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 5.9.0.8.0 do adaptador Pangle para iOS.
- 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.8.0
- Suporte para a versão 5.9.0.4.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 5.9.0.7.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.7.0
- Suporte à versão 5.9.0.2.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 5.8.0.8.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.6.0
- Suporte à versão 5.8.0.9.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 5.8.0.8.0.
- Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.5.0
- Suporte para a versão 5.7.0.1.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 5.7.0.7.0.
- Criado e testado com a versão 8.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.4.0
- Suporte à versão 5.5.0.9.0 do adaptador Pangle para Android.
- Suporte à versão 5.5.0.9.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 8.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.3.0
- Suporte para a versão 5.3.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 5.3.1.2.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 8.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.2.0
- Suporte à versão 5.2.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 5.2.0.9.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 8.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.1.0
- Suporte à versão 5.1.0.9.0 do adaptador Pangle para Android.
- Suporte à versão 5.1.1.0.0 do adaptador Pangle para iOS.
- 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 2.0.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/Pangle/. - O namespace do adaptador foi refatorado para usar
GoogleMobileAds.Mediation.Pangle. - Suporte para a versão 5.0.0.7.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 5.0.0.6.0.
- Criado e testado com a versão 7.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.1
- Suporte à versão 4.9.0.7.0 do adaptador Pangle para Android.
- Suporte à versão 4.9.0.8.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.0
- Suporte à versão 4.9.0.6.0 do adaptador Pangle para Android.
- Suporte para a versão 4.9.0.7.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.4.0
- Suporte à versão 4.8.1.0.0 do adaptador Pangle para Android.
- Suporte à versão 4.8.1.0.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.1
- Suporte para a versão 4.7.0.6.0 do adaptador Pangle para Android.
- Suporte à versão 4.7.0.6.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.0
- Renomeação dos seguintes métodos na classe
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Suporte à versão 4.7.0.5.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 4.7.0.5.0.
- Criado e testado com a versão 7.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.0
- Suporte à versão 4.5.0.6.1 do adaptador Pangle para Android.
- Suporte à versão 4.5.2.8.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.0
- Suporte à versão 4.5.0.3.0 do adaptador Pangle para Android.
- Suporte à versão 4.5.1.3.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 7.0.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.0.0
- Versão inicial.
- Suporte à versão 4.3.0.8.0 do adaptador Pangle para Android.
- Suporte ao adaptador Pangle para iOS versão 4.3.0.5.0.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.