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 a mediação, cobrindo integrações de leilão e de lances. Ele aborda como adicionar a Pangle à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Pangle a um app Flutter.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação da AdMob para Pangle tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado | |
Nativo |
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Flutter 3.7.0 ou mais recente
- [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para Pangle 2.4.0 ou mais recente (recomenda-se a versão mais recente).
- Para implantar no Android
- API do Android de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes 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.
Android
iOS
Anote o ID do app.
Android
iOS
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.
Android
iOS
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.
Android
iOS
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.
Android
iOS
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 da Pangle na interface da AdMob
Configurar as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 no guia para Android.
iOS
Para ver as instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador da Pangle
Integração pelo pub.dev
(Somente Android) Adicione os repositórios abaixo ao arquivo build.gradle
no
diretório android
do projeto:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Adicione a dependência abaixo com as versões mais recentes do
SDK e do adaptador do Pangle no
arquivo pubspec.yaml
do pacote:
dependencies:
gma_mediation_pangle: ^1.0.0
Integração manual
Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para
Pangle,
extraia o arquivo baixado e adicione a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo
pubspec.yaml
adicionando a seguinte dependência:
dependencies:
gma_mediation_pangle:
path: path/to/local/package
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração com a Pangle.
iOS
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 na AdMob e ative o modo de teste na interface da Pangle.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Pangle, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Pangle (lances) e Pangle (hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio da Pangle, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo
nas
seguintes classes:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Confira os códigos e as mensagens exibidas pelo adaptador Pangle quando um anúncio não é carregado:
Android
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 a Pangle. |
103 | com.google.ads.mediation.pangle | Resposta de lance ausente ou inválida. |
-1-60000 | com.pangle.ads | O SDK do Pangle retornou um erro. Consulte a documentação do Pangle para mais detalhes. |
iOS
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 a Pangle. |
-1-60000 | Enviado pelo SDK do 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 Flutter
Próxima versão
- Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
2.0.0
- Compatibilidade verificada com a versão 6.1.0.9.0 do adaptador Pangle para Android.
- Compatibilidade verificada com o adaptador Pangle para iOS versão 6.2.0.5.0.
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
1.1.0
- Compatibilidade verificada com a versão 5.9.0.4.0 do adaptador Pangle para Android.
- Compatibilidade verificada com a versão 5.9.0.7.0 do adaptador Pangle para iOS.
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
1.0.0
- Versão inicial.
- Compatibilidade verificada com a versão 5.8.0.9.0 do adaptador Pangle para Android
- Compatibilidade verificada com o adaptador Pangle para iOS versão 5.8.0.8.0
- Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.