Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios do Pangle usando mediação, abrangendo 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 iOS .
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
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 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 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.
Assim 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 da Pangle sobre como ativar anúncios de teste da Pangle.
Etapa 2: configurar a demanda do Pangle na Ad Manager interface
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
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 em Ad Manager 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
. 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 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 Pangle. |
-1-60000 | Enviado pelo SDK do 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.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 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 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.
- Incluiu
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 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
- Foi adicionado suporte à hierarquia para os formatos de anúncio de abertura do app, banner (inclui 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
- Remoção da compatibilidade com a arquitetura
armv7
. - 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 requer a versão 10.0.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.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 do 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.
- Adicionado suporte a lances para o formato de anúncio nativo.
- Atualizamos o adaptador para usar a API
didRewardUser
. - Agora é necessário ter a versão 9.8.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 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 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.