Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da Pangle usando a Mediação da AdMob, cobrindo integrações de hierarquia e lances. Ele aborda como adicionar o Pangle a configuração de mediação de um bloco de anúncios e como integrar o SDK do Pangle adaptador em um iOS 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 | |
Formatos | |
Abertura do app | 1 |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado | |
Nativo |
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 a mediação Guia explicativo
Etapa 1: definir as configurações na interface do Pangle
Inscreva-se ou faça login 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
Assim que seu aplicativo tiver sido criado, clique no botão Adicionar para criar o posicionamento do anúncio.
Lances
Selecione o Formato do anúncio e o Nome da posição do anúncio, além de Lances no app como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.
Quando o posicionamento do anúncio for criado, anote o ID do posicionamento do anúncio.
Cascata
Selecione o Formato do anúncio, o Nome da posição do anúncio e o CPM global como o Tipo de preço. Preencha o restante do formulário e clique em Enviar.
Quando o posicionamento do anúncio for criado, anote o ID do posicionamento 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 User ID no canto inferior esquerdo da página.
Clique em Integrações > SDK e API > API Pangle Reporting 2.0. Anote o ID do papel 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 saber como ativar anúncios de teste da Pangle.
Etapa 2: configurar a demanda do Pangle na AdMob interface
Definir as configurações de mediação para seu bloco de anúncios
Você precisa adicionar Pangle à configuração de mediação do seu bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar Pangle como uma origem de anúncios.
Para criar um novo grupo de mediação, selecione Criar grupo de mediação.
Insira a plataforma e o formato do anúncio e clique em Continuar.
Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúnciosAdMob existentes. Em seguida, clique em Concluído.
Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:
Adicionar Pangle como uma origem de anúncios
Lances
No card Lances, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Pangle.
Clique em Como assinar um contrato de parceria e configure uma parceria de lances com Pangle.
Clique em Reconhecer e concordar e depois em Continuar.
Se você já tem um mapeamento para Pangle, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o App ID and Ad Placement ID recebido na seção anterior. Em seguida, clique em Concluído.
Importante: o App ID precisa estar associado ao app de destino, como na interfacePangle .Cascata
No card Cascata, na seção Origens de anúncios, selecione Adicionar origem do anúncio. Em seguida, selecione Pangle.
Selecione Pangle. Em seguida, insira um valor de eCPM para Pangle e clique em Continuar.Se você já tem um mapeamento para Pangle, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o App ID and Ad Placement ID recebido na seção anterior. Em seguida, clique em Concluído.
Etapa 3: importar o SDK e o adaptador do Pangle
Como usar 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 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 pelo link de download na
o Registro de alterações e o link
PangleAdapter.xcframework
no projeto.
Etapa 4: adicionar o código obrigatório
Integração com a SKAdNetwork
Siga a documentação da Pangle.
para adicionar os identificadores SKAdNetwork ao arquivo Info.plist
do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em AdMob 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 Pangle retorna os anúncios nativos como
GADNativeAd
objetos. Ele preenche o seguinte
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
dão 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ê pode verificar
o erro subjacente da resposta do anúncio usando
GADResponseInfo.adNetworkInfoArray
nas seguintes classes:
GADMediationAdapterPangle
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador Pangle ao quando ocorre uma falha no carregamento do anúncio:
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 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.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 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 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 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
- Foi adicionado suporte a 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 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
- 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
- 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 ter 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
- 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 do iOS 12.0.
- 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()
foram renomeados da classeGADMediationAdapterPangle
parasetGDPRConsent()
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.
- O adaptador foi atualizado para usar a API
didRewardUser
. - Agora requer 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 o SDK do Pangle versão 4.5.1.3.
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.