Esta página foi traduzida pela API Cloud Translation.

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 mediação, cobrindo bidding e em cascata. 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 Flutter app.

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

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

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

¹ A integração em hierarquia está na versão Beta fechada.

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 com suporte nos 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 (recomenda-se a versão mais recente).
Para implantar no Android
- API do Android de nível 21 ou mais recente
Para implantar no iOS
- Destino de implantação do iOS 12.0 ou mais recente
Um projeto Flutter funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
Concluir o Guia para iniciantes de mediação

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

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

Android

iOS

Anote o ID do app.

Android

iOS

Criar uma posição de anúncio

Depois que o aplicativo for criado, clique no botão Adicionar para criar a posição do anúncio.

Android

iOS

Lances

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

Depois que a posição do anúncio for criada, anote o ID da posição do anúncio.

Android

iOS

Cascata

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

Depois que a posição do anúncio for criada, anote o ID da posição do anúncio.

Android

iOS

Ativar o modo de teste

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

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

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

Android

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

iOS

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

Etapa 3: importar o SDK e o adaptador da Pangle

Integração pelo pub.dev

(Somente Android) Adicione os repositórios a seguir ao arquivo build.gradle no 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 SDK e do adaptador do Pangle 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 baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do 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 necessário

Android

Nenhum código adicional é necessário para a integração com a 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 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager 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 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 que acompanham os códigos 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 do servidor inválidos (por exemplo, ID do app ou ID 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 a 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 mais detalhes.

iOS

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

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

Próxima versão

Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

2.0.0

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

1.1.0

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

1.0.0

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