Integrar o Pangle com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da Pangle usando a mediação, incluindo integrações em hierarquia e de lances. Ele explica 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 do Ad Manager para a Pangle tem os seguintes recursos:

Integração
Lances  1
Cascata
Formatos
Abertura do aplicativo  2
Banner  2
Intersticial
Premiado
Intersticial premiado
Nativo  2

1 As origens de anúncios dos lances da Pangle disponíveis incluem Pangle US, Pangle KR e Pangle ROW.

2 Esse formato não é compatível com as seguintes origens de anúncios dos lances da Pangle: Pangle US.

Pré-requisitos

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • [Para lances da Pangle nos EUA]: use a versão 5.1.0 ou mais recente do adaptador da Pangle.
  • Unity Editor versão 5.6 ou mais recente.
  • [Para lances da Pangle KR e da Pangle ROW]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação do Google Mobile Ads para Pangle 2.4.0 ou mais recente (recomendamos usar a última versão).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

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

    Inscreva-se ou faça login na sua conta da Pangle.

    Adicionar um novo aplicativo

    Acesse 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 o posicionamento do anúncio.

    Android

    iOS

    Lances

    Selecione o Formato do anúncio e o Nome do posicionamento do anúncio e escolha Lances no app como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.

    Depois de criar o posicionamento do anúncio, anote o ID do posicionamento do anúncio.

    Android

    iOS

    Cascata

    Selecione o formato do anúncio, o nome da posição do anúncio e o CPM global como o tipo de preço. Preencha o restante do formulário e clique em Enviar.

    Depois de criar o posicionamento do anúncio, anote o ID do posicionamento do anúncio.

    Android

    iOS

    Atualizar o app-ads.txt

    Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é 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, crie um arquivo app-ads.txt para o Ad Manager.

    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 no guia da Pangle sobre como adicionar um anúncio de teste para saber como ativar os anúncios de teste da plataforma.

    Etapa 2: configurar a demanda da Pangle na interface do Ad Manager

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

    Android

    Para ver as instruções, consulte a etapa 2 no guia para Android.

    iOS

    Para instruções, consulte a etapa 2 no guia para iOS.

    Adicionar a Pangle DSP à 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 do Ad Manager.

    Etapa 3: importar o SDK e o adaptador da Pangle

    OpenUPM-CLI

    Se a CLI do OpenUPM estiver instalada, você poderá instalar o plug-in de mediação da Pangle para Unity dos 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 > Configurações do projeto > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

    Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Google Mobile Ads Pangle Mediation e clique em Install.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a Pangle no link de download do registro de alterações 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

    Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Forçar resolução. A biblioteca do Gerenciador de Dependências Externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

    Forçar resolução

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

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

    Na versão 5.9.0 e mais recentes do adaptador da Pangle para Unity, a Pangle lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP.

    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 desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade 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 publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

    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 Google Mobile Ads Unity Plugin 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 informações que podem ser inseridas em cada método.

    Etapa 5: adicionar o código necessário

    Android

    Não é necessário nenhum código adicional para a integração da 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 6: testar a implementação

    Ativar anúncios de teste

    Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar 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 (hierarquia), SDK da Pangle nos EUA (lances), SDK da Pangle na Coreia do Sul (lances) e SDK da Pangle no resto do mundo (lances).

    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:

    Android

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

    iOS

    GADMediationAdapterPangle

    Confira os códigos e as mensagens geradas pelo adaptador da 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 de anúncio solicitado não corresponde a um tamanho de banner aceito pela Pangle.
    103 com.google.ads.mediation.pangle O SDK da Pangle não é compatível com usuários menores de idade.
    -1-60000 com.pangle.ads O SDK da Pangle retornou um erro. Consulte a documentação da empresa para mais detalhes.

    iOS

    Código do erro Domínio Motivo
    101 com.google.mediation.pangle Parâmetros de servidor inválidos (por exemplo, ID do app ou ID de posição ausente).
    102 com.google.mediation.pangle O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Pangle.
    104 com.google.mediation.pangle O SDK da Pangle não é compatível com usuários menores de idade.
    -1-60000 Enviado pelo SDK da Pangle. O SDK da Pangle retornou um erro. Consulte a documentação da Pangle para mais detalhes.

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

    Versão 7.2.2 (em andamento)

    Versão 7.2.1

    Versão 7.2.0

    Versão 7.1.1

    Versão 7.1.0

    Versão 7.0.0 (revertida)

    Versão 6.0.1

    Versão 6.0.0

    Versão 5.9.2

    Versão 5.9.1

    Versão 5.9.0

    Versão 5.8.5

    Versão 5.8.4

    Versão 5.8.3

    Versão 5.8.2

    Versão 5.8.1

    Versão 5.8.0

    Versão 5.7.1

    Versão 5.7.0

    Versão 5.6.0

    Versão 5.5.3

    Versão 5.5.2

    Versão 5.5.1

    Versão 5.5.0

    Versão 5.4.0

    Versão 5.3.0

    Versão 5.2.2

    Versão 5.2.1

    Versão 5.2.0

    Versão 5.1.1

    Versão 5.1.0

    Versão 5.0.0

    Versão 4.6.2

    Versão 4.6.1

    Versão 4.6.0

    Versão 4.5.4

    Versão 4.5.3

    Versão 4.5.2

    Versão 4.5.1

    Versão 4.5.0

    Versão 4.4.2

    Versão 4.4.1

    Versão 4.4.0

    Versão 4.3.3

    Versão 4.3.2

    Versão 4.3.1

    Versão 4.3.0

    Versão 4.2.1

    Versão 4.2.0

    Versão 4.1.0

    Versão 4.0.1

    Versão 4.0.0

    Versão 3.0.0

    Versão 2.8.1

    Versão 2.8.0

    Versão 2.7.0

    Versão 2.6.0

    Versão 2.5.0

    Versão 2.4.0

    Versão 2.3.0

    Versão 2.2.0

    Versão 2.1.0

    Versão 2.0.0

    Versão 1.5.1

    Versão 1.5.0

    Versão 1.4.0

    Versão 1.3.1

    Versão 1.3.0

    Versão 1.2.0

    Versão 1.1.0

    Versão 1.0.0