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 o 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 de 10.0 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir 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 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.
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 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
Usando o CocoaPods (recomendado)
Adicione a seguinte linha ao Podfile do 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 pelo link de download no
Changelog e vincule
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 do anúncio
O adaptador Pangle retorna os anúncios nativos como
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 Pangle não fornece acesso direto ao recurso de imagem principal para os 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 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 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 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 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 é 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 a versão 5.5.0.9 do SDK da Pangle.
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 o SDK do Pangle versão 5.5.0.7.
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 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 o SDK do Pangle versão 5.2.0.7.
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 do 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.
- Agora é possível definir 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.