Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare annunci di Pangle con mediazione, 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. Android
Integrazioni e formati degli annunci supportati
L'adattatore di mediazione per Pangle ha le seguenti funzionalità:
Integrazione | |
---|---|
Offerte | |
Cascata | 1 |
Formati | |
Apertura app | 2 |
Banner | |
Interstitial | |
Con premio | |
Interstitial con premio | |
Nativo |
2 Integrazione delle offerte per questo formato è in versione beta chiusa.
Requisiti
- Livello API Android 21 o superiore
Versione più recente dell'SDK Google Mobile Ads
Completare la mediazione Guida introduttiva
Passaggio 1: configura le configurazioni nella UI di Pangle
Passaggio 2: configura la domanda di Pangle nell' Ad Manager UI
Passaggio 3: importa l'SDK e l'adattatore Pangle
Integrazione di Android Studio (consigliata)
Nel file settings.gradle.kts
a livello di progetto, aggiungi quanto segue
repository:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
}
Poi, nel file build.gradle.kts
a livello di app, aggiungi quanto segue
delle dipendenze e configurazioni dell'implementazione. Utilizza le versioni più recenti
SDK e adattatore Pangle:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:pangle:6.1.0.9.0")
}
Integrazione manuale
Scarica l'ultima versione di SDK Pangle per Android ed estrai
open_ad_sdk.aar
in dalla cartella di archivio scaricata e aggiungerla al progetto.Vai alla sezione Artefatti dell'adattatore Pangle sul Repository Maven di Google. Seleziona la versione più recente e scarica Pangle del file
.aar
dell'adattatore e aggiungilo al tuo progetto.
Passaggio 4: aggiungi il codice richiesto
Offuscamento ProGuard
Se utilizzi ProGuard per offuscare il codice Android, segui le istruzioni in Documentazione di Pangle per garantire che il codice dell'SDK Pangle non sia offuscato.
Passaggio 5: testa l'implementazione
Attiva annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager 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
NativeAd
di oggetti strutturati. Compila i seguenti campi
campi
per un
NativeAd
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
MediaView
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
ResponseInfo.getAdapterResponses()
nelle seguenti classi:
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
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. |
103 | com.google.ads.mediation.pangle | Risposta all'offerta mancante o non valida. |
-1-60000 | com.pangle.ads | L'SDK Pangle ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di Pangle. |
Log delle modifiche dell'adattatore di mediazione Android di Pangle
Versione 6.1.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.1.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Pangle versione 6.1.0.9.
Versione 6.1.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.1.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.2.0.
- SDK Pangle versione 6.1.0.7.
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 23.2.0.
- SDK Pangle versione 6.1.0.6.
Versione 6.0.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Pangle versione 6.0.0.8.
Versione 6.0.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Pangle versione 6.0.0.7.
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 23.1.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 23.1.0.
- SDK Pangle versione 6.0.0.4.
Versione 6.0.0.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 6.0.0.3.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Pangle versione 6.0.0.3.
Versione 5.9.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Pangle versione 5.9.0.6.
Versione 5.9.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.1.0.
- SDK Pangle versione 5.9.0.5.
Versione 5.9.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Pangle versione 5.9.0.4.
Versione 5.9.0.2.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.9.0.2.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Pangle versione 5.9.0.2.
Versione 5.8.1.0.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Pangle versione 5.8.1.0.
Versione 5.8.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.0.9.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 23.0.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 23.0.0.
- SDK Pangle versione 5.8.0.9.
Versione 5.8.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.8.0.7.
Versione 5.8.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.8.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.8.0.6.
Versione 5.7.0.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.7.0.3.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.7.0.3.
Versione 5.7.0.2.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.7.0.2.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.7.0.2.
Versione 5.7.0.1.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.7.0.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.7.0.1.
Versione 5.6.0.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.6.0.3.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.6.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.6.0.
- SDK Pangle versione 5.6.0.3.
Versione 5.5.0.9.0
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.5.0.
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.5.0.
- SDK Pangle versione 5.5.0.9.
Versione 5.5.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Pangle versione 5.5.0.8.
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 22.3.0.
- SDK Pangle versione 5.5.0.7.
Versione 5.5.0.6.0
- Il formato dell'annuncio apertura app per l'asta non è supportato in questa versione perché questa versione dell'adattatore è stata ripristinata per dipendere dalla versione 22.3.0 dell'SDK Google Mobile Ads.
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Pangle versione 5.5.0.6.
Versione 5.5.0.4.0
- Aggiunto il supporto delle aste per il formato dell'annuncio apertura app.
- È stato aggiunto il supporto della filigrana per gli annunci con asta.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.4.0.
- È stata verificata la compatibilità con l'SDK Pangle versione 5.5.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.4.0.
- SDK Pangle versione 5.5.0.4.
Versione 5.4.1.1.0
- Risolto un problema per cui l'adattatore non veniva inizializzato.
- Compatibilità verificata con l'SDK Pangle versione 5.4.1.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.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.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.3.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.3.0.
- SDK Pangle versione 5.4.0.9.
Versione 5.4.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.4.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Pangle versione 5.4.0.8.
Versione 5.3.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.3.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Pangle versione 5.3.0.6.
Versione 5.3.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.3.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Pangle versione 5.3.0.5.
Versione 5.3.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.3.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.2.0.
- SDK Pangle versione 5.3.0.4.
Versione 5.2.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.1.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 22.1.0.
- SDK Pangle versione 5.2.0.6.
Versione 5.2.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.1.0.
- SDK Pangle versione 5.2.0.5.
Versione 5.2.0.3.0
- È stato aggiunto il supporto della struttura a cascata per apertura app, banner (incluso MREC), interstitial formati di annunci con premio e nativi.
- È stata verificata la compatibilità con l'SDK Pangle versione 5.2.0.3.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Pangle versione 5.2.0.3.
Versione 5.1.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.1.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Pangle versione 5.1.0.9.
Versione 5.1.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.1.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Pangle versione 5.1.0.8.
Versione 5.1.0.6.0
- Adattatore aggiornato per utilizzare la nuova classe
VersionInfo
. - La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 22.0.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 22.0.0.
- SDK Pangle versione 5.1.0.6.
Versione 5.0.1.1.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.1.1.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Pangle versione 5.0.1.1.
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 21.5.0.
- SDK Pangle versione 5.0.1.0.
Versione 5.0.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 5.0.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Pangle versione 5.0.0.9.
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 21.5.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 21.5.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 21.5.0.
- SDK Pangle versione 5.0.0.6.
Versione 4.9.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.9.0.9.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.5.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.5.0.
- SDK Pangle versione 4.9.0.9.
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 21.4.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 21.4.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 21.4.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.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.4.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.4.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 21.3.0.
- SDK Pangle versione 4.8.0.9.
Versione 4.8.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.8.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.0.
- SDK Pangle versione 4.8.0.8.
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 21.3.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.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.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.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.3.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.3.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 21.2.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 21.2.0.
- SDK Pangle versione 4.7.0.5.
Versione 4.7.0.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.7.0.3.
- Ora l'adattatore tenta di inizializzare l'SDK Pangle prima di caricare gli annunci.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.2.0.
- SDK Pangle versione 4.7.0.3.
Versione 4.6.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.6.0.9.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.2.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.2.0.
- SDK Pangle versione 4.6.0.9.
Versione 4.5.0.6.1
- Aggiunto il supporto delle offerte per il formato dell'annuncio nativo.
- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.1.0.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.1.0.
- SDK Pangle versione 4.5.0.6.
Versione 4.5.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Pangle versione 4.5.0.6.
Versione 4.5.0.5.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.0.5.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Pangle versione 4.5.0.5.
Versione 4.5.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Pangle versione 4.5.0.4.
Versione 4.5.0.3.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.5.0.3.
compileSdkVersion
etargetSdkVersion
aggiornati all'API 31.- La versione minima richiesta dell'SDK Google Mobile Ads è stata aggiornata alla versione 21.0.0.
- Il livello API Android minimo richiesto è stato aggiornato a 19.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 21.0.0.
- SDK Pangle versione 4.5.0.3.
Versione 4.3.0.9.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.9.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.6.0.
- SDK Pangle versione 4.3.0.9.
Versione 4.3.0.8.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.8.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.6.0.
- SDK Pangle versione 4.3.0.8.
Versione 4.3.0.7.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.7.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.6.0.
- SDK Pangle versione 4.3.0.7.
Versione 4.3.0.6.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.6.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.6.0.
- SDK Pangle versione 4.3.0.6.
Versione 4.3.0.4.0
- È stata verificata la compatibilità con l'SDK Pangle versione 4.3.0.4.
Sviluppato e testato con:
- SDK Google Mobile Ads versione 20.6.0.
- SDK Pangle versione 4.3.0.4.
Versione 4.2.5.3.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 20.6.0.
- SDK Pangle versione 4.2.5.3.