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, 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 Android 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 Integração de lances para este formato está na versão Beta fechada.
Requisitos
- Android API de nível 21 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
Etapa 2: configurar a demanda do Pangle na Ad Manager interface
Etapa 3: importar o SDK e o adaptador do Pangle
Integração com o Android Studio (recomendado)
No arquivo settings.gradle.kts
no nível do projeto, adicione o seguinte:
repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
}
Em seguida, no arquivo build.gradle.kts
no nível do app, adicione o seguinte:
dependências e configurações de implementação. Use as versões mais recentes do
SDK e adaptador do Pangle:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:pangle:6.1.0.9.0")
}
Integração manual
Faça download da versão mais recente do SDK do Pangle para Android e extraia o
open_ad_sdk.aar
da pasta do arquivo transferido por download e adicioná-lo ao seu projeto.Acesse o Artefatos do adaptador Pangle no repositório Maven do Google. Selecione a versão mais recente e faça o download do Pangle
.aar
do adaptador e adicione-o ao projeto.
Etapa 4: adicionar o código obrigatório
Ocultação do ProGuard
Se você usa o ProGuard para ofuscar o código do Android, siga as instruções em Documentação da Pangle para garantir que o código do SDK do Pangle não seja ofuscado.
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 de anúncios
O adaptador Pangle retorna os anúncios nativos
NativeAd
objetos. Ele preenche os seguintes campos:
campos
para um
NativeAd
.
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
MediaView
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
ResponseInfo.getAdapterResponses()
nas seguintes classes:
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
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. |
103 | com.google.ads.mediation.pangle | A resposta do lance está ausente ou é inválida. |
-1-60000 | com.pangle.ads | 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 Android da Pangle
Versão 6.1.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 6.1.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
- SDK do Pangle versão 6.1.0.9.
Versão 6.1.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 6.1.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
- SDK do Pangle versão 6.1.0.7.
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 23.2.0.
- SDK do Pangle versão 6.1.0.6.
Versão 6.0.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do Pangle versão 6.0.0.8.
Versão 6.0.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do Pangle versão 6.0.0.7.
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 23.1.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 23.1.0.
- SDK do Pangle versão 6.0.0.4.
Versão 6.0.0.3.0
- Compatibilidade verificada com o SDK do Pangle versão 6.0.0.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do Pangle versão 6.0.0.3.
Versão 5.9.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do Pangle versão 5.9.0.6.
Versão 5.9.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.1.0.
- SDK do Pangle versão 5.9.0.5.
Versão 5.9.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do Pangle versão 5.9.0.4.
Versão 5.9.0.2.0
- Compatibilidade verificada com o SDK do Pangle versão 5.9.0.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do Pangle versão 5.9.0.2.
Versão 5.8.1.0.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do Pangle versão 5.8.1.0.
Versão 5.8.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.0.9.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do Pangle versão 5.8.0.9.
Versão 5.8.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.8.0.7.
Versão 5.8.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.8.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.8.0.6.
Versão 5.7.0.3.0
- Compatibilidade verificada com o SDK do Pangle versão 5.7.0.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.7.0.3.
Versão 5.7.0.2.0
- Compatibilidade verificada com o SDK do Pangle versão 5.7.0.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.7.0.2.
Versão 5.7.0.1.0
- Compatibilidade verificada com o SDK do Pangle versão 5.7.0.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.7.0.1.
Versão 5.6.0.3.0
- Compatibilidade verificada com o SDK do Pangle versão 5.6.0.3.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 22.6.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do Pangle versão 5.6.0.3.
Versão 5.5.0.9.0
- Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 22.5.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 22.5.0.
- SDK do Pangle versão 5.5.0.9.
Versão 5.5.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.5.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- SDK do Pangle versão 5.5.0.8.
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 22.3.0.
- SDK do Pangle versão 5.5.0.7.
Versão 5.5.0.6.0
- O formato de anúncio de abertura do app de lances não é compatível com esta versão porque a versão do adaptador foi revertida para depender do SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- Compatibilidade verificada com o SDK do Pangle versão 5.5.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- SDK do Pangle versão 5.5.0.6.
Versão 5.5.0.4.0
- Foi adicionado suporte a lances para o formato do anúncio de abertura do app.
- Adição de compatibilidade com marca d'água para anúncios de lances.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 22.4.0.
- Compatibilidade verificada com o SDK do Pangle versão 5.5.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.4.0.
- SDK do Pangle versão 5.5.0.4.
Versão 5.4.1.1.0
- Correção de um problema em que o adaptador falha ao inicializar.
- 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 22.3.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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 22.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- SDK do Pangle versão 5.4.0.9.
Versão 5.4.0.8.0
- 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 22.2.0.
- SDK do Pangle versão 5.4.0.8.
Versão 5.3.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 5.3.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
- SDK do Pangle versão 5.3.0.6.
Versão 5.3.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 5.3.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
- SDK do Pangle versão 5.3.0.5.
Versão 5.3.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 5.3.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.2.0.
- SDK do Pangle versão 5.3.0.4.
Versão 5.2.0.7.0
- 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 22.1.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 22.1.0.
- SDK do Pangle versão 5.2.0.6.
Versão 5.2.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 5.2.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.1.0.
- SDK do Pangle versão 5.2.0.5.
Versão 5.2.0.3.0
- Foi adicionado suporte à hierarquia para abertura do app, banner (inclui MREC), intersticial, formatos de anúncios premiados e nativos.
- Compatibilidade verificada com o SDK do Pangle versão 5.2.0.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do Pangle versão 5.2.0.3.
Versão 5.1.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.1.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do Pangle versão 5.1.0.9.
Versão 5.1.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 5.1.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do Pangle versão 5.1.0.8.
Versão 5.1.0.6.0
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do Pangle versão 5.1.0.6.
Versão 5.0.1.1.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.1.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do Pangle versão 5.0.1.1.
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 21.5.0.
- SDK do Pangle versão 5.0.1.0.
Versão 5.0.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 5.0.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do Pangle versão 5.0.0.9.
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 21.5.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 21.5.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 21.5.0.
- SDK do Pangle versão 5.0.0.6.
Versão 4.9.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 4.9.0.9.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do Pangle versão 4.9.0.9.
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 21.4.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 21.4.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 21.4.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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.4.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 21.3.0.
- SDK do Pangle versão 4.8.0.9.
Versão 4.8.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 4.8.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
- SDK do Pangle versão 4.8.0.8.
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 21.3.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.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.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.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.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 21.2.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 21.2.0.
- SDK do Pangle versão 4.7.0.5.
Versão 4.7.0.3.0
- Compatibilidade verificada com o SDK do Pangle versão 4.7.0.3.
- O adaptador agora tenta inicializar o SDK do Pangle antes de carregar os anúncios.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.2.0.
- SDK do Pangle versão 4.7.0.3.
Versão 4.6.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 4.6.0.9.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.2.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.2.0.
- SDK do Pangle versão 4.6.0.9.
Versão 4.5.0.6.1
- Agora é possível definir lances para o formato de anúncio nativo.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
- SDK do Pangle versão 4.5.0.6.
Versão 4.5.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Pangle versão 4.5.0.6.
Versão 4.5.0.5.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.0.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Pangle versão 4.5.0.5.
Versão 4.5.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Pangle versão 4.5.0.4.
Versão 4.5.0.3.0
- Compatibilidade verificada com o SDK do Pangle versão 4.5.0.3.
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.0.0.
- O nível mínimo necessário da API do Android foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Pangle versão 4.5.0.3.
Versão 4.3.0.9.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.9.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Pangle versão 4.3.0.9.
Versão 4.3.0.8.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.8.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Pangle versão 4.3.0.8.
Versão 4.3.0.7.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Pangle versão 4.3.0.7.
Versão 4.3.0.6.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Pangle versão 4.3.0.6.
Versão 4.3.0.4.0
- Compatibilidade verificada com o SDK do Pangle versão 4.3.0.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Pangle versão 4.3.0.4.
Versão 4.2.5.3.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 20.6.0.
- SDK do Pangle versão 4.2.5.3.