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 lances 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 app.

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

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

Integração
Lances
Cascata  1
Formatos
Banner
Intersticial
Premiado
Intersticial premiado
1 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 implantar no Android
    • API do Android 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 em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua a mediação Guia explicativo

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

Inscreva-se ou faça login (links em inglês) 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 uma posição de anúncio

Depois que seu aplicativo for criado, clique no botão Add 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. Em seguida, selecione Lances no app como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.

Assim 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, o Nome do posicionamento do anúncio e CPM global como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.

Assim que a posição do anúncio for criada, anote o ID da posição 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 ID do usuário no canto inferior esquerdo da página.

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

Ativar o modo de teste

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

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

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

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

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até 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

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 no link de download no Changelog e extraia o GoogleMobileAdsPangleMediation.unitypackage do arquivo zip.

No editor de projetos 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 Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app Unity.

Forçar resolução

Etapa 4: adicionar o código necessá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

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do , ative os testes de uma única origem no Ad Inspector usando as 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 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 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 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 Pangle.
-1-60000 Enviado pelo SDK do 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 Flutter para Pangle

Próxima versão

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

2.0.0

  • Compatibilidade verificada com o adaptador Pangle para Android versão 6.1.0.9.0.
  • 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 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 de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.