Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Pangle utilizzando la mediazionee le integrazioni sia con la struttura a cascata sia con l'asta. Spiega come aggiungere Pangle alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Pangle in un' iOS app.
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Pangle offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | 1 |
Formati | |
Apertura app | 2 |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio | |
Nativo |
2 L'integrazione delle offerte per questo formato è in versione beta chiusa.
Requisiti
- Target di deployment iOS 10.0 o versioni successive
SDK Google Mobile Ads più recente
Completa la Guida introduttiva di mediazione
Passaggio 1: configura le impostazioni nell'interfaccia utente di Pangle
Registrati o accedi al tuo account Pangle.
Aggiungi una nuova applicazione
Vai alla scheda Applicazioni e fai clic sul pulsante Aggiungi app.
Seleziona il Sistema operativo per cui vuoi creare un'applicazione e compila la parte restante del modulo. Quindi, fai clic su Invia.
Prendi nota dell'ID app dell'applicazione.
Crea un posizionamento dell'annuncio
Dopo aver creato l'applicazione, fai clic sul pulsante Aggiungi per creare il posizionamento dell'annuncio.
Offerte
Seleziona il formato dell'annuncio e il nome del posizionamento dell'annuncio, quindi seleziona Offerte in-app come Tipo di prezzo. Compila il resto del modulo e fai clic su Invia.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Cascata
Seleziona il formato dell'annuncio e il nome del posizionamento dell'annuncio, nonché il CPM globale come Tipo di prezzo. Compila la parte rimanente del modulo e fai clic su Invia.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Individuare la chiave API Pangle Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni delle offerte.
Cascata
Prendi nota dell'ID utente nell'angolo in basso a sinistra della pagina.
Fai clic su Integrations (Integrazioni) > SDK & API (SDK e API) > Pangle Reporting API 2.0 (API di reporting Pangle 2.0). Prendi nota di ID ruolo e Token di sicurezza.
Attiva la modalità di test
Segui le istruzioni riportate nella guida Come aggiungere un annuncio di prova di Pangle per informazioni su come attivare gli annunci di prova di Pangle.
Passaggio 2: configura la domanda Pangle nell' Ad Manager interfaccia utente
Passaggio 3: importa l'SDK e l'adattatore Pangle
Utilizzo di CocoaPods (opzione consigliata)
Aggiungi la seguente riga al Podfile del progetto:
pod 'GoogleMobileAdsMediationPangle'
Dalla riga di comando, esegui:
pod install --repo-update
Integrazione manuale
- Scarica la versione più recente dell'SDK Pangle per iOS e collega tutti i file e i bundle
.framework
nel tuo progetto. - Scarica la versione più recente dell'adattatore Pangle dal link di download nel Changelog e collegalo
PangleAdapter.xcframework
nel tuo progetto.
Passaggio 4: aggiungi il codice richiesto
Integrazione di SKAdNetwork
Segui la documentazione di Pangle per aggiungere gli identificatori SKAdNetwork al file Info.plist
del progetto.
Passaggio 5: testa l'implementazione
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob e di attivare la modalità di test nella UI di Pangle.
Verificare gli annunci di prova
Per verificare di ricevere annunci di prova da Pangle, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Pangle (asta) e Pangle (struttura a cascata).
Passaggi facoltativi
Annunci nativi
Visualizzazione dell'annuncio
L'adattatore Pangle restituisce gli annunci nativi come oggetti
GADNativeAd
. Compila i seguenti
campi
per un
GADNativeAd
.
Campo | Asset sempre inclusi dall'adattatore Pangle |
---|---|
Titolo | |
Immagine | 1 |
Corpo | |
Icona | |
Call to action | |
Valutazione a stelle | |
Negozio | |
Prezzo | |
Inserzionista |
1 L'adattatore Pangle non fornisce accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece il valore
GADMediaView
con un video o un'immagine.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Pangle, puoi controllare l'errore di fondo dalla risposta all'annuncio utilizzando
GADResponseInfo.adNetworkInfoArray
nelle seguenti classi:
GADMediationAdapterPangle
Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Pangle quando non riesce a caricare un annuncio:
Codice di errore | Dominio | Motivo |
---|---|---|
101 | com.google.ads.mediation.pangle | Parametri del server non validi (ad es. ID app o ID posizionamento mancante). |
102 | com.google.ads.mediation.pangle | La dimensione dell'annuncio richiesta non corrisponde a una dimensione del banner supportata da Pangle. |
-1-60000 | Inviata dall'SDK Pangle | L'SDK Pangle ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di Pangle. |
Log delle modifiche dell'adattatore di mediazione Pangle per iOS
Versione 6.3.0.8.0
- Compatibilità verificata con la versione 6.3.0.8 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.11.0.
- Versione dell'SDK Pangle 6.3.0.8.
Versione 6.3.0.6.0
- Compatibilità verificata con la versione 6.3.0.6 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.11.0.
- SDK Pangle versione 6.3.0.6.
Versione 6.2.0.9.0
- Compatibilità verificata con la versione 6.2.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.10.0.
- Versione dell'SDK Pangle 6.2.0.9.
Versione 6.2.0.8.0
- Compatibilità verificata con la versione 6.2.0.8 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.10.0.
- Versione dell'SDK Pangle 6.2.0.8.
Versione 6.2.0.7.0
- Compatibilità verificata con la versione 6.2.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.8.0.
- Versione dell'SDK Pangle 6.2.0.7.
Versione 6.2.0.6.0
- Compatibilità verificata con la versione 6.2.0.6 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.8.0.
- SDK Pangle versione 6.2.0.6.
Versione 6.2.0.5.0
- Compatibilità verificata con la versione 6.2.0.5 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.8.0.
- Versione dell'SDK Pangle 6.2.0.5.
Versione 6.1.0.6.0
- Compatibilità verificata con la versione 6.1.0.6 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.7.0.
- SDK Pangle versione 6.1.0.6.
Versione 6.1.0.5.0
- Compatibilità verificata con la versione 6.1.0.5 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.6.0.
- SDK Pangle versione 6.1.0.5.
Versione 6.1.0.4.0
- Compatibilità verificata con la versione 6.1.0.4 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.6.0.
- Versione dell'SDK Pangle 6.1.0.4.
Versione 6.0.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.6.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.6.0.
- Versione dell'SDK Pangle 6.0.0.6.
Versione 6.0.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.5.0.
- Versione dell'SDK Pangle 6.0.0.5.
Versione 6.0.0.4.0
- Compatibilità verificata con la versione 6.0.0.4 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.5.0.
- SDK Pangle versione 6.0.0.4.
Versione 5.9.0.9.0
- Compatibilità verificata con la versione 5.9.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.5.0.
- Versione dell'SDK Pangle 5.9.0.9.
Versione 5.9.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.8.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.4.0.
- Versione dell'SDK Pangle 5.9.0.8.
Versione 5.9.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.7.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.3.0.
- Versione dell'SDK Pangle 5.9.0.7.
Versione 5.8.0.8.0
- Compatibilità verificata con la versione 5.8.0.8 dell'SDK Pangle.
- È stato aggiornato l'adattatore per usare la nuova API di raccolta indicatori dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.2.0.
- Versione dell'SDK Pangle 5.8.0.8.
Versione 5.8.0.7.0
- Compatibilità verificata con la versione 5.8.0.7 dell'SDK Pangle.
- Ora è richiesta la versione minima iOS 12.0.
- Ora è richiesta la versione 11.0 o successive dell'SDK Google Mobile Ads.
Info.plist
è stato incluso nei framework diPangleAdapter.xcframework
.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK Pangle versione 5.8.0.7.
Versione 5.7.0.7.0
- Compatibilità verificata con la versione 5.7.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.14.0.
- Versione dell'SDK Pangle 5.7.0.7.
Versione 5.7.0.6.0
- Compatibilità verificata con la versione 5.7.0.6 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.14.0.
- Versione dell'SDK Pangle 5.7.0.6.
Versione 5.6.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.6.0.8.
- È stato eseguito il refactoring del metodo
+setCOPPA
sostituendo la proprietàadConfiguration.childDirectedTreatment
ritirata con la nuova proprietàGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.14.0.
- Versione dell'SDK Pangle 5.6.0.8.
Versione 5.5.0.9.0
- Compatibilità verificata con la versione 5.5.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.13.0.
- Versione dell'SDK Pangle 5.5.0.9.
Versione 5.5.0.7.0
- Compatibilità verificata con la versione 5.5.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.12.0.
- Versione dell'SDK Pangle 5.5.0.7.
Versione 5.5.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.11.0.
- Versione dell'SDK Pangle 5.5.0.5.
Versione 5.4.1.1.0
- Aggiunto il supporto delle aste per il formato dell'annuncio apertura app.
- Compatibilità verificata con la versione 5.4.1.1 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.10.0.
- Versione dell'SDK Pangle 5.4.1.1.
Versione 5.4.0.9.0
- Compatibilità verificata con la versione 5.4.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.9.0.
- Versione dell'SDK Pangle 5.4.0.9.
Versione 5.4.0.8.0
- È stato risolto un problema per cui
GADPangleNetworkExtras
non era conforme al protocolloGADAdNetworkExtras
. - È stato implementato il metodo di protocollo
adDidShowFail
negli annunci interstitial, con premio e apertura app. - Compatibilità verificata con la versione 5.4.0.8 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.9.0.
- Versione dell'SDK Pangle 5.4.0.8.
Versione 5.3.1.2.0
- Compatibilità verificata con l'SDK Pangle versione 5.3.1.2.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.8.0.
- Versione dell'SDK Pangle 5.3.1.2.
Versione 5.3.1.0.0
- Compatibilità verificata con la versione 5.3.1.0 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.8.0.
- Versione dell'SDK Pangle 5.3.1.0.
Versione 5.2.1.1.0
- Compatibilità verificata con la versione 5.2.1.1 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.7.0.
- Versione dell'SDK Pangle 5.2.1.1.
Versione 5.2.0.9.0
- Compatibilità verificata con la versione 5.2.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.5.0.
- SDK Pangle versione 5.2.0.9.
Versione 5.2.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.8.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.5.0.
- Versione dell'SDK Pangle 5.2.0.8.
Versione 5.2.0.7.0
- È stato aggiunto il supporto della struttura a cascata per i formati degli annunci apertura app, banner (inclusi gli annunci MREC), interstitial, con premio e nativi.
- Compatibilità verificata con la versione 5.2.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.5.0.
- Versione dell'SDK Pangle 5.2.0.7.
Versione 5.2.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.6.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.5.0.
- Versione dell'SDK Pangle 5.2.0.6.
Versione 5.1.1.0.0
- Compatibilità verificata con la versione 5.1.1.0 dell'SDK Pangle.
- È stato aggiunto il supporto per l'architettura del simulatore
arm64
. - Ora è richiesta la versione 10.4.0 o successive dell'SDK Google Mobile Ads.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.4.0.
- SDK Pangle versione 5.1.1.0.
Versione 5.1.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.1.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.3.0.
- Versione dell'SDK Pangle 5.1.0.6.
Versione 5.0.1.0.0
- Compatibilità verificata con la versione 5.0.1.0 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.2.0.
- Versione dell'SDK Pangle 5.0.1.0.
Versione 5.0.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.2.0.
- Versione dell'SDK Pangle 5.0.0.8.
Versione 5.0.0.7.0
- È stata verificata la compatibilità con la versione 5.0.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.1.0.
- Versione dell'SDK Pangle 5.0.0.7.
Versione 5.0.0.6.0
- Compatibilità verificata con la versione 5.0.0.6 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 10.1.0.
- Versione dell'SDK Pangle 5.0.0.6.
Versione 4.9.1.0.0
- È stato rimosso il supporto per l'architettura
armv7
. - Compatibilità verificata con la versione 4.9.1.0 dell'SDK Pangle.
- Ora è richiesta la versione minima di iOS 12.0.
- Ora è necessaria la versione 10.0.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.0.0.
- Versione dell'SDK Pangle 4.9.1.0.
Versione 4.9.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.8.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.14.0.
- Versione dell'SDK Pangle 4.9.0.8.
Versione 4.9.0.7.0
- Compatibilità verificata con la versione 4.9.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.14.0.
- Versione dell'SDK Pangle 4.9.0.7.
Versione 4.9.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.6.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.14.0.
- Versione dell'SDK Pangle 4.9.0.6.
Versione 4.8.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.1.0.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.14.0.
- Versione dell'SDK Pangle 4.8.1.0.
Versione 4.8.0.9.0
- Compatibilità verificata con la versione 4.8.0.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.13.0.
- Versione dell'SDK Pangle 4.8.0.9.
Versione 4.8.0.7.0
- Compatibilità verificata con la versione 4.8.0.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.13.0.
- Versione dell'SDK Pangle 4.8.0.7.
Versione 4.8.0.6.0
- Compatibilità verificata con la versione 4.8.0.6 dell'SDK Pangle.
- È stato risolto un problema per cui il thread principale veniva bloccato durante il caricamento dell'immagine dell'icona dell'annuncio nativo.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK Pangle versione 4.8.0.6.
Versione 4.7.0.7.0
- Compatibilità verificata con la versione 4.7.0.7 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.11.0.
- Versione dell'SDK Pangle 4.7.0.7.
Versione 4.7.0.6.0
- Compatibilità verificata con la versione 4.7.0.6 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.11.0.
- Versione dell'SDK Pangle 4.7.0.6.
Versione 4.7.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.5.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.11.0.
- Versione dell'SDK Pangle 4.7.0.5.
Versione 4.7.0.4.0
- Compatibilità verificata con la versione 4.7.0.4 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.10.0.
- Versione dell'SDK Pangle 4.7.0.4.
Versione 4.6.2.2.0
- I metodi
setGDPR()
esetCCPA()
della classeGADMediationAdapterPangle
sono stati rinominati rispettivamente insetGDPRConsent()
esetDoNotSell
. - Compatibilità verificata con la versione 4.6.2.2 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.10.0.
- Versione dell'SDK Pangle 4.6.2.2.
Versione 4.6.1.8.0
- Compatibilità verificata con la versione 4.6.1.8 dell'SDK Pangle.
- È stato aggiunto il supporto delle offerte per il formato dell'annuncio nativo.
- L'adattatore è stato aggiornato in modo da utilizzare l'API
didRewardUser
. - Ora è necessaria la versione 9.8.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.9.0.
- Versione dell'SDK Pangle 4.6.1.8.
Versione 4.5.2.8.0
- Compatibilità verificata con la versione 4.5.2.8 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.7.0.
- SDK Pangle versione 4.5.2.8.
Versione 4.5.2.7.0
- Compatibilità verificata con la versione 4.5.2.7 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.7.0.
- Versione dell'SDK Pangle 4.5.2.7.
Versione 4.5.2.5.0
- Compatibilità verificata con la versione 4.5.2.5 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.6.0.
- Versione dell'SDK Pangle 4.5.2.5.
Versione 4.5.2.4.0
- Compatibilità verificata con l'SDK Pangle versione 4.5.2.4.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.6.0.
- Versione dell'SDK Pangle 4.5.2.4.
Versione 4.5.2.3.0
- Compatibilità verificata con la versione 4.5.2.3 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.6.0.
- Versione dell'SDK Pangle 4.5.2.3.
Versione 4.5.1.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.1.3.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.5.0.
- Versione dell'SDK Pangle 4.5.1.3.
Versione 4.3.1.9.0
- Compatibilità verificata con la versione 4.3.1.9 dell'SDK Pangle.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.3.0.
- Versione dell'SDK Pangle 4.3.1.9.
Versione 4.3.0.5.0
- Compatibilità verificata con la versione 4.3.0.5 dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.2.0.
- Versione dell'SDK Pangle 4.3.0.5.
Versione 4.3.0.4.0
- Versione iniziale
- È stato aggiunto il supporto per le offerte per i formati degli annunci banner (inclusi gli annunci MREC), interstitial e con premio.
Sviluppata e testata con:
- SDK Google Mobile Ads versione 9.1.0.
- Versione dell'SDK Pangle 4.3.0.4.