Integrar o Pangle com a mediação

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 bidding e em hierarquia. 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 Ad Manager para Pangle tem os seguintes recursos:

Integração
Lances
Cascata	^1
Formatos
Banner
Intersticial
Premiado
Intersticial premiado

¹ A integração em hierarquia está na versão Beta fechada.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Unity 5.6 ou versão 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 12.0 ou mais recente
• Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
• Conclua 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 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.

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, o Nome do posicionamento do anúncio e CPM global 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

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 do papel 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 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 do Pangle

Observação: a falha na integração das versões compatíveis do Pangle e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

OpenUPM-CLI

Importante: se você estiver migrando de um .unitypackage para usar o OpenUPM-CLI, desinstale manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/Pangle.

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

Importante: se você estiver migrando de um .unitypackage para o OpenUPM, será necessário desinstalar manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/Pangle.

No editor de projetos do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com 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 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 Unity.

Etapa 4: adicionar o código obrigatório

Android

Nenhum código adicional é necessário para a integração do 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 em Ad Manager e ative o modo de teste na Pangle interface.

Importante: desative o modo de teste para Ad Manager e Pangle antes de lançar o app.

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 classes abaixo:

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 de servidor inválidos (por exemplo, ID do app ou 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 de servidor inválidos (por exemplo, ID do app ou 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.
-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 do Pangle para Unity

Versão 4.3.3

• Oferece suporte ao adaptador para Android Pangle versão 6.2.0.7.0.
• Oferece suporte ao adaptador para iOS Pangle versão 6.2.0.9.0.
• 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.
• 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.

Versão 4.2.1

• Oferece suporte ao adaptador para Android Pangle versão 6.1.0.7.0.
• Oferece suporte ao adaptador para iOS Pangle versão 6.1.0.6.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.2.0

• DummyClient foi renomeado como PlaceholderClient
• Oferece suporte ao adaptador para Android Pangle versão 6.1.0.6.0.
• Oferece suporte ao adaptador para iOS Pangle versão 6.1.0.5.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.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

• Oferece suporte ao adaptador para Android Pangle versão 6.0.0.5.0.
• 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.

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

• 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.
• Oferece suporte ao adaptador para iOS Pangle 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.

Versão 2.6.0

• Oferece suporte ao adaptador para Android Pangle versão 5.8.0.9.0.
• Oferece suporte ao adaptador para iOS Pangle 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.0.0.

Versão 2.5.0

• Oferece suporte ao adaptador para Android Pangle versão 5.7.0.1.0.
• 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

• Oferece suporte ao adaptador para Android Pangle versão 5.5.0.9.0.
• Oferece suporte ao adaptador para iOS Pangle versão 5.5.0.9.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.3.0

• Suporte para a versão 5.3.0.6.0 do adaptador Pangle para Android.
• Suporte para a 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

• 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.3.0.

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.
• Oferece suporte ao adaptador para Android Pangle versão 5.0.0.7.0.
• 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

• Oferece suporte ao adaptador para Android Pangle versão 4.9.0.7.0.
• 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

• Oferece suporte ao adaptador para Android Pangle versão 4.9.0.6.0.
• Oferece suporte ao adaptador para iOS Pangle versão 4.9.0.7.0.
• 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.
• Oferece suporte ao adaptador para iOS Pangle versão 4.8.1.0.0.
• 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

• Oferece suporte ao adaptador para Android Pangle versão 4.7.0.6.0.
• 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 para a 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.2.0.

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 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.
• Oferece suporte ao adaptador para iOS Pangle versão 4.3.0.5.0.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.