Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da Pangle usando mediação, abrangendo hierarquia e lances integrações de . 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 AdMob adaptador de mediação para Pangle tem a 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 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 Unity funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir a mediação Guia explicativo
Etapa 1: definir 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 aplicativo.
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 um posicionamento do 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.
Assim 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 Envie.
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 Pangle Reporting 2.0. Pegue anote o ID do papel e a Chave de segurança.
Ativar 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
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 Pangle
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do Pangle para anúncios para dispositivos móveis do Google no seu projeto executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
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 dos anúncios para dispositivos móveis do Google para:
Pangle usando o link de download
as
Registro de alterações
e extrair o
GoogleMobileAdsPangleMediation.unitypackage
do ZIP
.
No editor de projetos do Unity, selecione Assets > Importar pacote >
Pacote personalizado e encontre a
GoogleMobileAdsPangleMediation.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 a resolução. O Gerenciador de Dependências Externos
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 obrigatório
Android
Nenhum código adicional é necessário para a integração com a Pangle.
iOS
Integração com a 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 em AdMob e ative o modo de teste na Pangle interface.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Pangle, ative os testes de uma única origem no Ad Inspector usando as Pangle (Bidding) and Pangle (Waterfall) origens de anúncios.
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 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 da Pangle para saber mais. |
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 do Pangle | O SDK do Pangle retornou um erro. Consulte a documentação da Pangle para saber mais. |
Registro de alterações do plug-in de mediação para Unity do Pangle
Versão 4.3.3
- Oferece suporte ao adaptador para Android Pangle versão 6.2.0.7.0.
- 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 4.3.1
- Oferece suporte ao adaptador para Android Pangle versão 6.2.0.5.0.
- Oferece suporte ao adaptador para iOS Pangle versão 6.2.0.7.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 4.3.0
- Oferece suporte ao adaptador para Android Pangle versão 6.2.0.4.0.
- Oferece suporte ao adaptador para iOS Pangle versão 6.2.0.5.0.
- 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 4.2.0
DummyClient
foi 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.1.
Versão 4.0.1
- Suporte à versão 6.0.0.5.0 do adaptador Pangle para Android.
- Oferece suporte ao adaptador para iOS Pangle versão 6.0.0.6.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 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
- Oferece suporte ao adaptador para Android Pangle versão 6.0.0.3.0.
- Suporte à versão 5.9.0.9.0 do adaptador Pangle para iOS.
- 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.8.1
- Oferece suporte ao adaptador para Android Pangle versão 5.9.0.6.0.
- Oferece suporte ao adaptador para iOS Pangle versão 5.9.0.8.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.8.0
- Oferece suporte ao adaptador para Android Pangle versão 5.9.0.4.0.
- 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
- Oferece suporte ao adaptador para Android Pangle versão 5.9.0.2.0.
- Suporte ao adaptador Pangle para iOS versão 5.8.0.8.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.6.0
- Suporte à versão 5.8.0.9.0 do adaptador Pangle para Android.
- Oferece suporte ao adaptador para iOS Pangle 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
- Oferece suporte ao adaptador para Android Pangle versão 5.7.0.1.0.
- Oferece suporte ao adaptador para iOS Pangle versão 5.7.0.7.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 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.
- Oferece suporte ao adaptador para iOS Pangle versão 5.3.1.2.0.
- 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
- Oferece suporte ao adaptador para Android Pangle versão 5.2.0.6.0.
- 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 para a 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.
- Oferece suporte ao adaptador para iOS Pangle versão 5.0.0.6.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.
Versão 1.5.1
- Oferece suporte ao adaptador para Android Pangle versão 4.9.0.7.0.
- Oferece suporte ao adaptador para iOS Pangle versão 4.9.0.8.0.
- 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 à 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
- Oferece suporte ao adaptador para Android Pangle versão 4.8.1.0.0.
- Suporte à versão 4.8.1.0.0 do adaptador Pangle para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.1.
Versão 1.3.1
- Suporte para a versão 4.7.0.6.0 do adaptador Pangle para Android.
- Oferece suporte ao adaptador para iOS Pangle versão 4.7.0.6.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.2.0.
Versão 1.3.0
- Renomeação dos seguintes métodos na classe
Pangle
:SetGDPR()
->SetGDPRConsent()
SetCCPA()
->SetDoNotSell()
- Oferece suporte ao adaptador para Android Pangle versão 4.7.0.5.0.
- 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
- Oferece suporte ao adaptador para Android Pangle versão 4.5.0.6.1.
- Suporte à versão 4.5.2.8.0 do adaptador Pangle para iOS.
- 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.1.0
- Oferece suporte ao adaptador para Android Pangle versão 4.5.0.3.0.
- 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.
- Oferece suporte ao adaptador para Android Pangle versão 4.3.0.8.0.
- 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.