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
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.
Anote o ID do app.
Criar um posicionamento do anúncio
Depois que o aplicativo for criado, clique no botão Adicionar para criar a posição do anúncio.
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.
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 Reporting 2.0 da Pangle. 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 da Pangle
Como usar 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
no 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 em 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.
Etapas opcionais
Anúncios nativos
Renderização de anúncios
O adaptador do Pangle retorna os anúncios nativos como
objetos
GADNativeAd
. Ela preenche os seguintes
campos
para uma
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 o
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 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 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 para iOS
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 a versão 6.2.0.9 do SDK da Pangle.
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 a versão 6.1.0.4 do SDK do Pangle.
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 a versão 5.9.0.7 do SDK da Pangle.
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 exige a versão mínima do iOS 12.0.
- Agora requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
- 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
- Agora é possível usar lances para o formato do anúncio de abertura do 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 a versão 5.4.0.9 do SDK da Pangle.
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
- Implementamos o método do protocolo
adDidShowFail
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 o SDK do Pangle versão 5.2.0.9.
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 é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 10.4.0 ou mais recente.
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 o SDK do Pangle versão 4.3.1.9.
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 os formatos de banner (inclui 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.