Integrar o Pangle com a mediação

Observação: consulte a documentação da Pangle para regiões com suporte.

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 app Unity .

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 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 explicativo 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 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.

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 Ad Manager interface

Configurar as configurações de mediação para o 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

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 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 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.

Importante: desative o modo de teste da AdMob e da Pangle antes de lançar o app.

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 do Pangle para Unity

Versão 4.4.1

• Suporte à 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 à 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

• DummyClient foi renomeado como PlaceholderClient
• 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 à 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 à 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 à 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.