Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di Pangle con Mediazione AdMob che copre le integrazioni con struttura a cascata e asta. Spiega come aggiungere Pangle a configurazione di mediazione di un'unità pubblicitaria, e come integrare l'SDK Pangle e in un'app. iOS
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Pangle offre le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | |
Formati | |
Apertura app | 1 |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio | |
Nativo |
Requisiti
- Target del deployment iOS 10.0 o versioni successive
Versione più recente dell'SDK Google Mobile Ads
Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nella UI 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 il resto del modulo. Poi, fai clic su Invia.
Prendi nota dell'ID app della tua applicazione.
Crea un posizionamento dell'annuncio
Una volta creata 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 la parte restante del modulo e fai clic su Invia.
Dopo aver creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Struttura a cascata
Seleziona il Formato dell'annuncio, il Nome posizionamento dell'annuncio e CPM globale come Tipo di prezzo. Compila il resto del modulo e fai clic su Invia.
Dopo aver 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 dell'asta.
Struttura a cascata
Prendi nota dello User-ID nell'angolo in basso a sinistra della pagina.
Fai clic su Integrazioni > SDK e API > API Pangle Reporting 2.0. Prendi nota di ID ruolo e Token di sicurezza.
Attivare la modalità di test
Segui le istruzioni 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 di Pangle nell' AdMob UI
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Devi aggiungere Pangle alla configurazione della mediazione per la tua unità pubblicitaria.
Innanzitutto, accedi all'account AdMob. Quindi, vai alla scheda Mediazione. Se vuoi modificare un gruppo di mediazione esistente, fai clic sul nome del gruppo per modificarlo e vai alla sezione Aggiungi Pangle come origine annuncio.
Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.
Inserisci il formato dell'annuncio e la piattaforma, poi fai clic su Continua.
Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.
Associa questo gruppo di mediazione a una o più unità pubblicitarieAdMob esistenti. Poi, fai clic su Fine.
A questo punto, dovresti vedere la scheda delle unità pubblicitarie compilata con quelle selezionate:
Aggiungi Pangle come origine annuncio
Offerte
Nella scheda Offerte nella sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Pangle.
Fai clic su Come firmare un contratto di partnership e instaura una partnership di asta con Pangle.
Fai clic su Confermo e accetto e poi su Continua.
Se hai già una mappatura per Pangle, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' App ID and Ad Placement ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Importante: App ID deve essere associato all'app scelta come target come nell'Pangle UI.Struttura a cascata
Nella scheda Con struttura a cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Seleziona Pangle.
Seleziona Pangle. Inserisci un valore eCPM perPangle e fai clic su Continua.Se hai già una mappatura per Pangle, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.
Quindi, inserisci l' App ID and Ad Placement ID ottenuto nella sezione precedente. Poi, fai clic su Fine.
Passaggio 3: importa l'SDK e l'adattatore Pangle
Utilizzo di CocoaPods (consigliato)
Aggiungi la seguente riga al podfile del progetto:
pod 'GoogleMobileAdsMediationPangle'
Dalla riga di comando, esegui:
pod install --repo-update
Integrazione manuale
- Scarica l'ultima versione di
SDK Pangle per iOS
e collegare tutti i
.framework
file e pacchetti nel tuo progetto. - Scarica la versione più recente dell'adattatore Pangle dal link di download in
Il Log delle modifiche e il link
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
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per AdMob e abilitare la modalità di test nell'interfaccia Pangle UI.
Verifica annunci di prova
Per verificare di ricevere annunci di prova daPangle, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le Pangle (Bidding) and Pangle (Waterfall) origini annuncio.
Passaggi facoltativi
Annunci nativi
Rendering degli annunci
L'adattatore Pangle restituisce gli annunci nativi
GADNativeAd
di oggetti strutturati. Compila i seguenti campi
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
fornire accesso diretto all'asset immagine principale per gli annunci nativi. Invece,
l'adattatore compila la
GADMediaView
con un video o un'immagine.
Codici di errore
Se l'adattatore non riceve un annuncio da Pangle, puoi controllare
un errore sottostante della risposta all'annuncio
GADResponseInfo.adNetworkInfoArray
:
nelle seguenti classi:
GADMediationAdapterPangle
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore Pangle quando un annuncio non viene caricato:
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 | Inviato 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.1.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.1.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.7.0.
- SDK Pangle versione 6.1.0.6.
Versione 6.1.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.1.0.5.
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
- È stata verificata la compatibilità con l'SDK Pangle versione 6.1.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.6.0.
- SDK Pangle versione 6.1.0.4.
Versione 6.0.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.6.0.
- SDK Pangle versione 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.
- SDK Pangle versione 6.0.0.5.
Versione 6.0.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.5.0.
- SDK Pangle versione 6.0.0.4.
Versione 5.9.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.5.0.
- SDK Pangle versione 5.9.0.9.
Versione 5.9.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.4.0.
- SDK Pangle versione 5.9.0.8.
Versione 5.9.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.3.0.
- SDK Pangle versione 5.9.0.7.
Versione 5.8.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.0.8.
- È stato aggiornato l'adattatore per usare la nuova API di raccolta indicatori dell'SDK Pangle.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.2.0.
- SDK Pangle versione 5.8.0.8.
Versione 5.8.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.0.7.
- Ora è necessaria la versione minima di iOS 12.0.
- Ora è necessaria la versione 11.0 o versioni successive dell'SDK Google Mobile Ads.
Info.plist
incluso nei framework all'interno diPangleAdapter.xcframework
.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 11.0.1.
- SDK Pangle versione 5.8.0.7.
Versione 5.7.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.7.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK Pangle versione 5.7.0.7.
Versione 5.7.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.7.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK Pangle versione 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
deprecata con la nuova proprietàGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.14.0.
- SDK Pangle versione 5.6.0.8.
Versione 5.5.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.13.0.
- SDK Pangle versione 5.5.0.9.
Versione 5.5.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.12.0.
- SDK Pangle versione 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.
- SDK Pangle versione 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 l'SDK Pangle versione 5.4.1.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.10.0.
- SDK Pangle versione 5.4.1.1.
Versione 5.4.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.4.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.9.0.
- SDK Pangle versione 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 del protocollo
adDidShowFail
negli annunci interstitial, con premio e apertura app. - È stata verificata la compatibilità con l'SDK Pangle versione 5.4.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.9.0.
- SDK Pangle versione 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.
- SDK Pangle versione 5.3.1.2.
Versione 5.3.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.3.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.8.0.
- SDK Pangle versione 5.3.1.0.
Versione 5.2.1.1.0
- Compatibilità verificata con l'SDK Pangle versione 5.2.1.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.7.0.
- SDK Pangle versione 5.2.1.1.
Versione 5.2.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.9.
Sviluppato e testato 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.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.5.0.
- SDK Pangle versione 5.2.0.8.
Versione 5.2.0.7.0
- È stato aggiunto il supporto della struttura a cascata per i formati di annunci apertura app, banner (incluso MREC), interstitial, con premio e nativi.
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.5.0.
- SDK Pangle versione 5.2.0.7.
Versione 5.2.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.5.0.
- SDK Pangle versione 5.2.0.6.
Versione 5.1.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.1.1.0.
- Aggiunto il supporto per l'architettura del simulatore
arm64
. - Ora è necessaria la versione 10.4.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato 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.
- SDK Pangle versione 5.1.0.6.
Versione 5.0.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.2.0.
- SDK Pangle versione 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.
- SDK Pangle versione 5.0.0.8.
Versione 5.0.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.1.0.
- SDK Pangle versione 5.0.0.7.
Versione 5.0.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 10.1.0.
- SDK Pangle versione 5.0.0.6.
Versione 4.9.1.0.0
- Rimosso il supporto per l'architettura
armv7
. - È stata verificata la compatibilità con l'SDK Pangle versione 4.9.1.0.
- Ora richiede 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.
- SDK Pangle versione 4.9.1.0.
Versione 4.9.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.14.0.
- SDK Pangle versione 4.9.0.8.
Versione 4.9.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.14.0.
- SDK Pangle versione 4.9.0.7.
Versione 4.9.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.14.0.
- SDK Pangle versione 4.9.0.6.
Versione 4.8.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.14.0.
- SDK Pangle versione 4.8.1.0.
Versione 4.8.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK Pangle versione 4.8.0.9.
Versione 4.8.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK Pangle versione 4.8.0.7.
Versione 4.8.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.0.6.
- È stato risolto un problema per cui il thread principale veniva bloccato durante il caricamento dell'immagine dell'icona dell'annuncio nativo.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.13.0.
- SDK Pangle versione 4.8.0.6.
Versione 4.7.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.11.0.
- SDK Pangle versione 4.7.0.7.
Versione 4.7.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.11.0.
- SDK Pangle versione 4.7.0.6.
Versione 4.7.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.11.0.
- SDK Pangle versione 4.7.0.5.
Versione 4.7.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.10.0.
- SDK Pangle versione 4.7.0.4.
Versione 4.6.2.2.0
- I metodi
setGDPR()
esetCCPA()
della classeGADMediationAdapterPangle
sono stati rinominati rispettivamente asetGDPRConsent()
esetDoNotSell
. - Compatibilità verificata con l'SDK Pangle versione 4.6.2.2.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.10.0.
- SDK Pangle versione 4.6.2.2.
Versione 4.6.1.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.6.1.8.
- Aggiunto il supporto delle offerte per il formato dell'annuncio nativo.
- È stato aggiornato l'adattatore in modo che utilizzi l'API
didRewardUser
. - Ora è necessaria la versione 9.8.0 o versioni successive dell'SDK Google Mobile Ads.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.9.0.
- SDK Pangle versione 4.6.1.8.
Versione 4.5.2.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.2.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.7.0.
- SDK Pangle versione 4.5.2.8.
Versione 4.5.2.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.2.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.7.0.
- SDK Pangle versione 4.5.2.7.
Versione 4.5.2.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.2.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.6.0.
- SDK Pangle versione 4.5.2.5.
Versione 4.5.2.4.0
- Compatibilità verificata con l'SDK Pangle versione 4.5.2.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.6.0.
- SDK Pangle versione 4.5.2.4.
Versione 4.5.2.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.2.3.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.6.0.
- SDK Pangle versione 4.5.2.3.
Versione 4.5.1.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.1.3.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.5.0.
- SDK Pangle versione 4.5.1.3.
Versione 4.3.1.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.1.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.3.0.
- SDK Pangle versione 4.3.1.9.
Versione 4.3.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.2.0.
- SDK Pangle versione 4.3.0.5.
Versione 4.3.0.4.0
- Versione iniziale
- Aggiunto il supporto delle offerte per i formati di annunci banner (incluso MREC), interstitial e con premio.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 9.1.0.
- SDK Pangle versione 4.3.0.4.