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 a mediação, abrangendo integrações em cascata e de lances. 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 aceitos

O adaptador de mediação da AdMob para Pangle tem os seguintes recursos:

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 aceitos em 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 (versão mais recente recomendada).
• Para fazer a implantação no Android,
  • API do Android de nível 23 ou mais recente
• Para fazer a implantação no iOS:
  • Destino de implantação do iOS 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 Começar para mais detalhes.
• Conclua o guia de primeiros passos da mediação.

Etapa 1: definir configurações na interface da Pangle

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

Anote o ID do app do aplicativo.

Criar uma posição de anúncio

Depois que o aplicativo for criado, clique no botão Adicionar para criar sua veiculação de anúncio.

Localizar a chave da API Reporting da Pangle

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

Para implementar app-ads.txt na Pangle, consulte Como adicionar a Pangle ao arquivo app-ads.txt.

Ativar o modo de teste

Siga as instruções do guia da Pangle Como adicionar um anúncio de teste para ativar os anúncios de teste da Pangle.

Etapa 2: configurar a demanda da Pangle na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

Adicionar a DSP da Pangle à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a DSP da Pangle à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da Pangle

openupm add com.google.ads.mobile.mediation.pangle

Etapa 4: implementar configurações de privacidade no SDK da Pangle

Consentimento da UE e GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para Pangle inclui o método Pangle.SetGDPRConsent(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Pangle. Defina as informações de consentimento antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente ao SDK da Pangle.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

Consulte o guia de integração da Pangle para mais detalhes e os valores que podem ser fornecidos em cada método.

Leis estaduais de privacidade dos EUA

As leis de privacidade dos estados dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para Pangle inclui o método Pangle.SetPAConsent(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Pangle. Defina as informações de consentimento antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente ao SDK da Pangle.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

Consulte o guia de integração da Pangle para mais detalhes e os valores que podem ser fornecidos em cada método.

Etapa 5: adicionar o código necessário

Etapa 6: 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 na resposta do anúncio usando ResponseInfo nas seguintes classes:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

GADMediationAdapterPangle

Confira os códigos e as mensagens acompanhantes gerados pelo adaptador da Pangle quando um anúncio não é carregado:

Registro de alterações do plug-in de mediação do Unity da Pangle

Versão 5.1.1

• Compatível com a versão 7.2.0.6.0 do adaptador do Android da Pangle.
• Compatível com a versão 7.2.0.5.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.2.0.

Versão 5.1.0

• Compatibilidade com a versão 7.2.0.4.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 7.2.0.4.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.2.0.

Versão 5.0.0

• Substituímos SetDoNotSell() por SetPAConsent() da classe Pangle.
  • O valor transmitido para SetDoNotSell() pode não ser o correto para SetPAConsent(). Verifique se o valor correto foi transmitido para SetPAConsent(). Consulte https://www.pangleglobal.com/integration/android-initialize-pangle-sdk para saber quais valores podem ser definidos para o consentimento da PA.
• Compatibilidade com a versão 7.1.0.8.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 7.1.1.1.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.

Versão 4.6.2

• Compatível com a versão 6.5.0.9.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.5.0.9.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.

Versão 4.6.1

• Compatibilidade com a versão 6.5.0.8.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.5.0.9.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.

Versão 4.6.0

• Compatível com a versão 6.5.0.6.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.5.0.9.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.

Versão 4.5.4

• Compatível com a versão 6.4.0.6.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.4.1.1.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.

Versão 4.5.3

• Compatibilidade com a versão 6.4.0.5.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.4.1.0.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.

Versão 4.5.2

• Compatibilidade com a versão 6.4.0.4.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.4.0.8.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.

Versão 4.5.1

• Compatibilidade com a versão 6.4.0.3.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.4.0.7.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.

Versão 4.5.0

• Compatibilidade com a versão 6.4.0.2.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.4.0.6.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.

Versão 4.4.2

• Compatibilidade com a versão 6.3.0.4.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.3.1.0.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 6.3.0.4.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.3.0.8.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.3.0.

Versão 4.4.0

• Compatibilidade com a versão 6.3.0.2.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.3.0.6.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.3.0.

Versão 4.3.3

• Compatível com a versão 6.2.0.7.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.2.0.9.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.1.

Versão 4.3.2

• Compatível com a versão 6.2.0.6.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.2.0.8.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 6.2.0.5.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.2.0.7.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 6.2.0.4.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.2.0.5.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 6.1.0.7.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.1.0.6.0 do adaptador do iOS da Pangle.
• 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
• Compatibilidade com a versão 6.1.0.6.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.1.0.5.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 6.0.0.8.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.1.0.5.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 6.0.0.5.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 6.0.0.6.0 do adaptador do iOS da Pangle.
• 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 4.0.0

• Compatibilidade com a versão 6.0.0.5.0 do adaptador do Android da Pangle.
• Compatível com a versão 6.0.0.5.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 6.0.0.3.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.9.0.9.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 5.9.0.6.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.9.0.8.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 5.9.0.4.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.9.0.7.0 do adaptador do iOS da Pangle.
• 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.7.0

• Compatível com a versão 5.9.0.2.0 do adaptador do Android da Pangle.
• Compatível com a versão 5.8.0.8.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 5.8.0.9.0 do adaptador do Android da Pangle.
• Compatível com a versão 5.8.0.8.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 5.7.0.1.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.7.0.7.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 5.5.0.9.0 do adaptador Android da Pangle.
• Compatibilidade com a versão 5.5.0.9.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 5.3.0.6.0 do adaptador do Android da Pangle.
• Compatível com a versão 5.3.1.2.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.4.1.

Versão 2.2.0

• Suporte à versão 5.2.0.6.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.2.0.9.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 5.1.0.9.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 5.1.1.0.0 do adaptador do iOS da Pangle.
• 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 2.0.0

• Conteúdo do adaptador movido para GoogleMobileAds/Mediation/Pangle/.
• Refatoração do namespace do adaptador para usar GoogleMobileAds.Mediation.Pangle.
• Compatibilidade com a versão 5.0.0.7.0 do adaptador do Android da Pangle.
• Compatível com a versão 5.0.0.6.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 4.9.0.7.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 4.9.0.8.0 do adaptador do iOS da Pangle.
• 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.5.0

• Compatibilidade com a versão 4.9.0.6.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 4.9.0.7.0 do adaptador do iOS da Pangle.
• 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.4.0

• Compatível com a versão 4.8.1.0.0 do adaptador do Android da Pangle.
• Compatível com a versão 4.8.1.0.0 do adaptador do iOS da Pangle.
• 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

• Compatível com a versão 4.7.0.6.0 do adaptador do Android da Pangle.
• Compatibilidade com a versão 4.7.0.6.0 do adaptador iOS da Pangle.
• 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

• Os seguintes métodos na classe Pangle foram renomeados:
  • SetGDPR() -> SetGDPRConsent()
  • SetCCPA() -> SetDoNotSell()
• Compatibilidade com a versão 4.7.0.5.0 do adaptador do Android da Pangle.
• Compatível com a versão 4.7.0.5.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 4.5.0.6.1 do adaptador do Android da Pangle.
• Compatível com a versão 4.5.2.8.0 do adaptador do iOS da Pangle.
• 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

• Compatibilidade com a versão 4.5.0.3.0 do adaptador do Android da Pangle.
• Compatível com a versão 4.5.1.3.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.

Versão 1.0.0

• Versão inicial.
• Compatibilidade com a versão 4.3.0.8.0 do adaptador do Android da Pangle.
• Compatível com a versão 4.3.0.5.0 do adaptador do iOS da Pangle.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.