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 integrações de de lances e hierarquia. 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 em um Flutter app.

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

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

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:
    • Destino de implantação do iOS de 12.0 ou mais recente
  • Um projeto Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
  • Conclua a mediação Guia explicativo

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 de anúncios para dispositivos móveis do Google para Pangle, extraia o arquivo transferido por download e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

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

Etapa 4: adicionar o código obrigatório

Android

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

iOS

Integração com a 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 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 classes abaixo:

Android

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

iOS

GADMediationAdapterPangle

Confira os códigos e as mensagens correspondentes 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 de servidor inválidos (por exemplo, ID do app 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 Pangle.
103 com.google.ads.mediation.pangle A resposta do lance está ausente ou é inválida.
-1-60000 com.pangle.ads O SDK do Pangle retornou um erro. Consulte a documentação da 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 app 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 Pangle.
-1-60000 Enviado pelo SDK do Pangle O SDK do Pangle retornou um erro. Consulte a documentação da Pangle para saber mais.

Registro de alterações do adaptador de mediação do Flutter para Pangle

1.1.0

  • Compatibilidade verificada com o adaptador Pangle para Android versão 5.9.0.4.0.
  • Compatibilidade verificada com o adaptador Pangle para iOS versão 5.9.0.7.0.
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.

1.0.0

  • Versão inicial.
  • Compatibilidade verificada com o adaptador Pangle para Android versão 5.8.0.9.0
  • Compatibilidade verificada com o adaptador Pangle para iOS versão 5.8.0.8.0
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.