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

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
• Flutter 3.7.0 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 funcional do Flutter 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

Integração pelo pub.dev

(Somente Android) Adicione os seguintes repositórios ao arquivo build.gradle no diretório android do projeto:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Pangle ao arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_pangle: ^

Integração manual

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, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, referencie o plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

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 adaptador de mediação do Flutter da Pangle

Versão 3.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 a versão 6.0.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

Versão 3.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 a versão 6.0.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

Versão 3.0.0

• 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 a versão 6.0.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

Versão 2.2.0

• 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 a versão 6.0.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

Versão 2.1.0

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

Versão 2.0.0

• 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 a versão 5.3.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.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 a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

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