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 integrações de hierarquia e lances. 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 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 | |
Abertura do app | 2 |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado | |
Nativo |
2 A integração de lances para esse formato está na versão Beta fechada.
Requisitos
- Destino de implantação do iOS 10.0 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Leia o Guia explicativo de mediação
Etapa 1: configurar 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.
Anote o ID do app.
Criar um posicionamento do anúncio
Depois que seu aplicativo for criado, clique no botão Add para criar o posicionamento do anúncio.
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.
Depois que a posição do anúncio for criada, anote o ID da posição do anúncio.
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.
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 Pangle Reporting 2.0. Anote o ID de função e a chave de segurança.
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 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
Usando o CocoaPods (recomendado)
Adicione a seguinte linha ao Podfile do seu projeto:
pod 'GoogleMobileAdsMediationPangle'
Na linha de comando, execute:
pod install --repo-update
Integração manual
- Faça o download da versão mais recente do
SDK do Pangle para iOS
e vincule todos os arquivos e pacotes
.framework
ao seu projeto. - Faça o download da versão mais recente do adaptador Pangle no link de download no
Changelog e no link
PangleAdapter.xcframework
no seu projeto.
Etapa 4: adicionar o código necessário
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 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 do Pangle, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Pangle (lances) e Pangle (Cascata).
Etapas opcionais
Anúncios nativos
Renderização do anúncio
O adaptador do Pangle retorna os anúncios nativos como
objetos
GADNativeAd
. Ele preenche os seguintes
campos
para um
GADNativeAd
.
Campo | Recursos sempre incluídos pelo adaptador Pangle |
---|---|
Título | |
Imagem | 1 |
Corpo | |
Ícone | |
Call-to-action | |
Star rating | |
Loja | |
Preço | |
Advertiser |
1 O adaptador do Pangle não
oferece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o
adaptador preenche a
GADMediaView
com um vídeo ou uma imagem.
Códigos de erro
Se o adaptador não receber um anúncio da Pangle, você poderá verificar o
erro subjacente da resposta do anúncio usando
GADResponseInfo.adNetworkInfoArray
nas seguintes classes:
GADMediationAdapterPangle
Confira os códigos e as mensagens que acompanham os códigos gerados pelo adaptador Pangle quando um anúncio não é carregado:
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 da Pangle para saber mais. |
Registro de alterações do adaptador de mediação para iOS da Pangle
Versão 6.3.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 6.3.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.11.0.
- SDK do Pangle versão 6.3.0.8.
Versão 6.3.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 6.3.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.11.0.
- SDK do Pangle versão 6.3.0.6.
Versão 6.2.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 6.2.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
- SDK do Pangle versão 6.2.0.9.
Versão 6.2.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 6.2.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
- SDK do Pangle versão 6.2.0.8.
Versão 6.2.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 6.2.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
- SDK do Pangle versão 6.2.0.7.
Versão 6.2.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 6.2.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
- SDK do Pangle versão 6.2.0.6.
Versão 6.2.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 6.2.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
- SDK do Pangle versão 6.2.0.5.
Versão 6.1.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 6.1.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.7.0.
- SDK do Pangle versão 6.1.0.6.
Versão 6.1.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 6.1.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.6.0.
- SDK do Pangle versão 6.1.0.5.
Versão 6.1.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 6.1.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.6.0.
- SDK do Pangle versão 6.1.0.4.
Versão 6.0.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.6.0.
- SDK do Pangle versão 6.0.0.6.
Versão 6.0.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.5.0.
- SDK do Pangle versão 6.0.0.5.
Versão 6.0.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.5.0.
- SDK do Pangle versão 6.0.0.4.
Versão 5.9.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.5.0.
- SDK do Pangle versão 5.9.0.9.
Versão 5.9.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.4.0.
- SDK do Pangle versão 5.9.0.8.
Versão 5.9.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.3.0.
- SDK do Pangle versão 5.9.0.7.
Versão 5.8.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.0.8.
- O adaptador foi atualizado para usar a nova API de coleta de indicadores do SDK do Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
- SDK do Pangle versão 5.8.0.8.
Versão 5.8.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.0.7.
- Agora requer a versão mínima do iOS 12.0.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 11.0 ou mais recente.
- Inclusão de
Info.plist
nos frameworks emPangleAdapter.xcframework
.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
- SDK do Pangle versão 5.8.0.7.
Versão 5.7.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 5.7.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
- SDK do Pangle versão 5.7.0.7.
Versão 5.7.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.7.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
- SDK do Pangle versão 5.7.0.6.
Versão 5.6.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.6.0.8.
- O método
+setCOPPA
foi refatorado substituindo a propriedadeadConfiguration.childDirectedTreatment
descontinuada pela nova propriedadeGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
- SDK do Pangle versão 5.6.0.8.
Versão 5.5.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.5.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.13.0.
- SDK do Pangle versão 5.5.0.9.
Versão 5.5.0.7.0
- Compatibilidade verificada com a versão 5.5.0.7 do SDK da Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.12.0.
- SDK do Pangle versão 5.5.0.7.
Versão 5.5.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 5.5.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.11.0.
- SDK do Pangle versão 5.5.0.5.
Versão 5.4.1.1.0
- Adição de suporte a lances para o formato de anúncio de abertura de app.
- Compatibilidade verificada com o SDK do Pangle versão 5.4.1.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.10.0.
- SDK do Pangle versão 5.4.1.1.
Versão 5.4.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.4.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.9.0.
- SDK do Pangle versão 5.4.0.9.
Versão 5.4.0.8.0
- Correção de um problema em que
GADPangleNetworkExtras
não estava em conformidade com o protocoloGADAdNetworkExtras
. - O método do protocolo
adDidShowFail
foi implementado em anúncios intersticiais, premiados e de abertura do app. - Compatibilidade verificada com o SDK do Pangle versão 5.4.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.9.0.
- SDK do Pangle versão 5.4.0.8.
Versão 5.3.1.2.0
- Compatibilidade verificada com o SDK do Pangle versão 5.3.1.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.8.0.
- SDK do Pangle versão 5.3.1.2.
Versão 5.3.1.0.0
- Compatibilidade verificada com o SDK do Pangle versão 5.3.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.8.0.
- SDK do Pangle versão 5.3.1.0.
Versão 5.2.1.1.0
- Compatibilidade verificada com o SDK do Pangle versão 5.2.1.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.7.0.
- SDK do Pangle versão 5.2.1.1.
Versão 5.2.0.9.0
- Compatibilidade verificada com a versão 5.2.0.9 do SDK da Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.5.0.
- SDK do Pangle versão 5.2.0.9.
Versão 5.2.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.2.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.5.0.
- SDK do Pangle versão 5.2.0.8.
Versão 5.2.0.7.0
- Adição de suporte à hierarquia para formatos de anúncio de abertura do app, banner (incluindo MREC), intersticial, premiado e nativo.
- Compatibilidade verificada com a versão 5.2.0.7 do SDK da Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.5.0.
- SDK do Pangle versão 5.2.0.7.
Versão 5.2.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.2.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.5.0.
- SDK do Pangle versão 5.2.0.6.
Versão 5.1.1.0.0
- Compatibilidade verificada com o SDK do Pangle versão 5.1.1.0.
- Foi adicionado suporte à arquitetura do simulador
arm64
. - Agora requer a versão 10.4.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.4.0.
- SDK do Pangle versão 5.1.1.0.
Versão 5.1.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.1.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.3.0.
- SDK do Pangle versão 5.1.0.6.
Versão 5.0.1.0.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.2.0.
- SDK do Pangle versão 5.0.1.0.
Versão 5.0.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.2.0.
- SDK do Pangle versão 5.0.0.8.
Versão 5.0.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.1.0.
- SDK do Pangle versão 5.0.0.7.
Versão 5.0.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.1.0.
- SDK do Pangle versão 5.0.0.6.
Versão 4.9.1.0.0
- A compatibilidade com a arquitetura
armv7
foi removida. - Compatibilidade verificada com o SDK do Pangle versão 4.9.1.0.
- Agora requer a versão mínima de 12.0 do iOS.
- Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.0.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 10.0.0.
- SDK do Pangle versão 4.9.1.0.
Versão 4.9.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 4.9.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
- SDK do Pangle versão 4.9.0.8.
Versão 4.9.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 4.9.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
- SDK do Pangle versão 4.9.0.7.
Versão 4.9.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 4.9.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
- SDK do Pangle versão 4.9.0.6.
Versão 4.8.1.0.0
- Compatibilidade verificada com o SDK do Pangle versão 4.8.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.14.0.
- SDK da Pangle versão 4.8.1.0.
Versão 4.8.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 4.8.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.13.0.
- SDK do Pangle versão 4.8.0.9.
Versão 4.8.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 4.8.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.13.0.
- SDK do Pangle versão 4.8.0.7.
Versão 4.8.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 4.8.0.6.
- Correção de um problema em que a linha de execução principal era bloqueada ao carregar a imagem do ícone de anúncio nativo.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.13.0.
- SDK do Pangle versão 4.8.0.6.
Versão 4.7.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 4.7.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.11.0.
- SDK do Pangle versão 4.7.0.7.
Versão 4.7.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 4.7.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.11.0.
- SDK do Pangle versão 4.7.0.6.
Versão 4.7.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 4.7.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.11.0.
- SDK do Pangle versão 4.7.0.5.
Versão 4.7.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 4.7.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.10.0.
- SDK do Pangle versão 4.7.0.4.
Versão 4.6.2.2.0
- Os métodos
setGDPR()
esetCCPA()
da classeGADMediationAdapterPangle
foram renomeados comosetGDPRConsent()
esetDoNotSell
, respectivamente. - Compatibilidade verificada com o SDK do Pangle versão 4.6.2.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.10.0.
- SDK do Pangle versão 4.6.2.2.
Versão 4.6.1.8.0
- Compatibilidade verificada com o SDK do Pangle versão 4.6.1.8.
- Adicionado suporte a lances para o formato de anúncio nativo.
- Atualizamos o adaptador para usar a API
didRewardUser
. - Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 9.8.0 ou mais recente.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.9.0.
- SDK do Pangle versão 4.6.1.8.
Versão 4.5.2.8.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.2.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.7.0.
- SDK do Pangle versão 4.5.2.8.
Versão 4.5.2.7.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.2.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.7.0.
- SDK do Pangle versão 4.5.2.7.
Versão 4.5.2.5.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.2.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.6.0.
- SDK do Pangle versão 4.5.2.5.
Versão 4.5.2.4.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.2.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.6.0.
- SDK do Pangle versão 4.5.2.4.
Versão 4.5.2.3.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.2.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.6.0.
- SDK do Pangle versão 4.5.2.3.
Versão 4.5.1.3.0
- Compatibilidade verificada com a versão 4.5.1.3 do SDK da Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.5.0.
- SDK do Pangle versão 4.5.1.3.
Versão 4.3.1.9.0
- Compatibilidade verificada com a versão 4.3.1.9 do SDK do Pangle.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.3.0.
- SDK do Pangle versão 4.3.1.9.
Versão 4.3.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.2.0.
- SDK do Pangle versão 4.3.0.5.
Versão 4.3.0.4.0
- Versão inicial.
- Adição de suporte a lances para formatos de anúncio de banner (incluindo MREC), intersticial e premiado.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 9.1.0.
- SDK do Pangle versão 4.3.0.4.