Esta página foi traduzida pela API Cloud Translation.

Integrar o Pangle com a mediação

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	¹
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

¹ Integração de lances para este 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
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

¹ 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 em PangleAdapter.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 propriedade adConfiguration.childDirectedTreatment descontinuada pela nova propriedade GADMobileAds.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 protocolo GADAdNetworkExtras
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 exige 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() e setCCPA() foram renomeados da classe GADMediationAdapterPangle para setGDPRConsent() e setDoNotSell, 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: