Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios do Pangle usando a mediação, abrangendo lances de lances e hierarquia. 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 em um app.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para Pangle tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | 1 |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado |
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Flutter 3.7.0 ou 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 de 12.0 ou mais recente
- Um projeto em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Conclua a mediação Guia explicativo
Etapa 1: definir 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.
Android
iOS
Anote o ID do app.
Android
iOS
Criar uma posição de anúncio
Depois que seu aplicativo for criado, clique no botão Add para criar o posicionamento do anúncio.
Android
iOS
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.
Assim 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, o Nome do posicionamento do anúncio e CPM global como o 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.
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 do papel 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 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
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.
Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:
- Nome:
OpenUPM
- URL:
https://package.openupm.com
- Escopo(s):
com.google
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads Pangle Mediation e clique em Install.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para
Pangle no link de download no
Changelog
e extraia o
GoogleMobileAdsPangleMediation.unitypackage
do arquivo
zip.
No editor de projetos do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsPangleMediation.unitypackage
que você salvou. Verifique se todos os arquivos estão selecionados e clique em
Importar.
Em seguida, selecione Assets > External Dependency Manager >
Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas para o diretório Assets/Plugins/Android
do
app Unity.
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração do Pangle.
iOS
Integração com a 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
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do , ative os testes de uma única origem no Ad Inspector usando as origens de anúncios.
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 correspondentes gerados 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 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 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 Flutter para Pangle
Próxima versão
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.2.0.
2.0.0
- Compatibilidade verificada com o adaptador Pangle para Android versão 6.1.0.9.0.
- 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 o adaptador Pangle para iOS versão 5.9.0.7.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.0.0
- Versão inicial.
- Compatibilidade verificada com o adaptador Pangle para Android versão 5.8.0.9.0
- 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.