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 mostrar anúncios do Pangle usando a mediação, abrangendo a hierarquia e integrações. Ele aborda como adicionar o Pangle à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Pangle a um Flutter app.

Integrações e formatos de anúncio compatíveis

O AdMob adaptador de mediação do Pangle tem os recursos abaixo:

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

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Flutter 3.7.0 ou mais recente
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS:
    • Meta de implantação do iOS 12.0 ou mais recente
  • Um projeto Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo sobre mediação

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

Inscreva-se ou faça login na sua conta da 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 um posicionamento do anúncio

Assim que seu aplicativo tiver sido 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 da posição do anúncio, além de Lances no app como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.

Quando o posicionamento do anúncio for criado, 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.

Quando o posicionamento do anúncio for criado, anote o ID do posicionamento 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 User ID no canto inferior esquerdo da página.

Clique em Integrações > SDK e API > API Pangle Reporting 2.0. Anote o ID do papel e a Chave de segurança.

Ativar modo de teste

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

Etapa 2: configurar a demanda do Pangle na AdMob 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

Integração pelo pub.dev

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

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

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

dependencies:
  gma_mediation_pangle: ^1.0.0

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

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

Etapa 4: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração com o Pangle.

iOS

Integração da SKAdNetwork

Siga a documentação do 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 AdMob e ative o modo de teste na Pangle interface.

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

Android

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

iOS

GADMediationAdapterPangle

Confira os códigos e as mensagens associadas gerados 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 aplicativo 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 o 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 saber mais.

iOS

Código do erro Domínio Motivo
101 com.google.ads.mediation.pangle Parâmetros de servidor inválidos (por exemplo, ID do aplicativo 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 o Pangle.
-1-60000 Enviado pelo SDK do Pangle O SDK do Pangle retornou um erro. Consulte a documentação do Pangle para saber mais.

1.0.0

  • Versão inicial.
  • Compatibilidade verificada com o adaptador do Pangle para Android versão 5.8.0.9.0
  • Compatibilidade verificada com o adaptador do Pangle para iOS versão 5.8.0.8.0