Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Pangle utilizzando la mediazione, coprendo sia le integrazioni delle aste che quelle con struttura a cascata. Spiega come Aggiungere Pangle alla configurazione di mediazione di un'unità pubblicitaria e scoprire come integrare L'SDK e l'adattatore Pangle in un'app Unity .
Integrazioni e formati degli annunci supportati
L' AdMob adattatore di mediazione per Pangle offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
Requisiti
- Versione più recente dell'SDK Google Mobile Ads
- Unity 5.6 o versioni successive
- Per eseguire il deployment su Android
- Livello API Android 21 o superiore
- Per il deployment su iOS
- Target del deployment di iOS 12.0 o versioni successive
- Un progetto Unity funzionante configurato con SDK Google Mobile Ads. Consulta Inizia per maggiori dettagli.
- Completare la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente di Pangle
Registrati o accedi al tuo account Pangle.
Aggiungi una nuova applicazione
Vai alla scheda Applications (Applicazioni) e fai clic sul pulsante Add App (Aggiungi app).
Seleziona il Sistema operativo per il quale vuoi creare un'applicazione e compila il resto del modulo. Poi, fai clic su Invia.
Android
iOS
Prendi nota dell'ID app dell'applicazione.
Android
iOS
Creare un posizionamento dell'annuncio
Una volta creata l'applicazione, fai clic sul pulsante Aggiungi per creare il posizionamento dell'annuncio.
Android
iOS
Offerte
Seleziona il formato dell'annuncio e il nome del posizionamento dell'annuncio, poi seleziona Aste in-app come Tipo di prezzo. Compila il resto del modulo. fai clic su Invia.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Android
iOS
Cascata
Seleziona il Formato dell'annuncio, il Nome del posizionamento dell'annuncio e Globale CPM 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.
Android
iOS
Individuare la chiave API Pangle Reporting
Offerte
Questo passaggio non è obbligatorio per le integrazioni di asta.
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 Chiave di sicurezza.
Attivare la modalità di test
Segui le istruzioni riportate nella guida di Pangle Come aggiungere un annuncio di prova per attivare gli annunci di prova di Pangle.
Passaggio 2: configura la domanda Pangle nell' AdMob interfaccia utente
Configurare le impostazioni di mediazione per l'unità pubblicitaria
Android
Per le istruzioni, consulta il passaggio 2 della guida per Android.
iOS
Per le istruzioni, consulta il passaggio 2 nella guida per iOS.
Passaggio 3: importa l'SDK e l'adattatore Pangle
OpenUPM-CLI
Se hai OpenUPM-CLI puoi installare Google Mobile Ads Pangle il plug-in di mediazione per Unity al tuo progetto eseguendo questo comando dalla directory radice del progetto:
openupm add com.google.ads.mobile.mediation.pangleOpenUPM
Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Gestore pacchetti per aprire le Impostazioni di Gestore pacchetti di Unity.
Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:
- Nome:
OpenUPM - URL:
https://package.openupm.com - Ambiti:
com.google
Quindi, vai a Finestra > Gestione pacchetti per aprire lo Gestore di pacchetti Unity e Seleziona I miei registri dal menu a discesa.
Seleziona il pacchetto Mediazione Pangle di Google Mobile Ads e fai clic su Installa.
Pacchetto Unity
Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per
Pangle dal link di download in
il
Log delle modifiche
ed estrarre
GoogleMobileAdsPangleMediation.unitypackage dal zip
.
Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto >
Pacchetto personalizzato e trova il
GoogleMobileAdsPangleMediation.unitypackage
file che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su
Importa.
Quindi, seleziona Asset > Gestore delle dipendenze esterne >
Risolvere Android > Forza risoluzione. La libreria External Dependency Manager effettuerà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.
Passaggio 4: aggiungi il codice richiesto
Android
Non è richiesto codice aggiuntivo per l'integrazione di Pangle.
iOS
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.
Codici di errore
Se l'adattatore non riesce a ricevere un annuncio da Pangle, i publisher possono controllare l'errore di fondo dalla risposta all'annuncio utilizzando
ResponseInfo nelle seguenti classi:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Di seguito sono riportati i codici e i relativi messaggi generati dall'adattatore Pangle quando un annuncio non viene caricato:
Android
| 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. |
iOS
| 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 del plug-in di mediazione Unity Pangle
Versione 4.3.3
- Supporta l'adattatore Pangle per Android versione 6.2.0.7.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.9.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.2.1.
Versione 4.3.2
- Supporta l'adattatore Pangle Android versione 6.2.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.8.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 4.3.1
- Supporta l'adattatore Pangle per Android versione 6.2.0.5.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.7.0.
- Creato e testato con la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 4.3.0
- Supporta l'adattatore Pangle per Android versione 6.2.0.4.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.5.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 4.2.1
- Supporta l'adattatore Pangle per Android versione 6.1.0.7.0.
- Supporta l'adattatore Pangle per iOS versione 6.1.0.6.0.
- Creato e testato con la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 4.2.0
DummyClientrinominato inPlaceholderClient.- Supporta l'adattatore Pangle per Android versione 6.1.0.6.0.
- Supporta la versione 6.1.0.5.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
Versione 4.1.0
- Supporta l'adattatore Pangle Android versione 6.0.0.8.0.
- Supporta l'adattatore Pangle per iOS versione 6.1.0.5.0.
- Sviluppato e testato con la versione 9.1.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 4.0.1
- Supporta l'adattatore Android Pangle versione 6.0.0.5.0.
- Supporta l'adattatore Pangle per iOS versione 6.0.0.6.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 4.0.0
- Supporta l'adattatore Pangle per Android versione 6.0.0.5.0.
- Supporta l'adattatore Pangle per iOS versione 6.0.0.5.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 3.0.0
- Supporta l'adattatore Pangle Android versione 6.0.0.3.0.
- Supporta l'adattatore Pangle per iOS versione 5.9.0.9.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 2.8.1
- Supporta l'adattatore Pangle per Android versione 5.9.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 5.9.0.8.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 2.8.0
- Supporta l'adattatore Pangle per Android versione 5.9.0.4.0.
- Supporta la versione 5.9.0.7.0 dell'adattatore Pangle per iOS.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 2.7.0
- Supporta l'adattatore Pangle per Android versione 5.9.0.2.0.
- Supporta l'adattatore Pangle per iOS versione 5.8.0.8.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 2.6.0
- Supporta l'adattatore Pangle per Android versione 5.8.0.9.0.
- Supporta l'adattatore Pangle per iOS versione 5.8.0.8.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.0.0.
Versione 2.5.0
- Supporta la versione 5.7.0.1.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 5.7.0.7.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.6.0.
Versione 2.4.0
- Supporta l'adattatore Pangle per Android versione 5.5.0.9.0.
- Supporta l'adattatore Pangle per iOS versione 5.5.0.9.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.6.0.
Versione 2.3.0
- Supporta l'adattatore Pangle per Android versione 5.3.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 5.3.1.2.0.
- Sviluppato e testato con la versione 8.4.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 2.2.0
- Supporta l'adattatore Pangle per Android versione 5.2.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 5.2.0.9.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.3.0.
Versione 2.1.0
- Supporta l'adattatore Pangle per Android versione 5.1.0.9.0.
- Supporta la versione 5.1.1.0.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 8.1.0.
Versione 2.0.0
- Contenuti dell'adattatore spostati in
GoogleMobileAds/Mediation/Pangle/. - Spazio dei nomi dell'adattatore sottoposto a refactoring per l'utilizzo di
GoogleMobileAds.Mediation.Pangle. - Supporta l'adattatore Pangle per Android versione 5.0.0.7.0.
- Supporta l'adattatore Pangle per iOS versione 5.0.0.6.0.
- Sviluppato e testato con la versione 7.4.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.5.1
- Supporta l'adattatore Pangle Android versione 4.9.0.7.0.
- Supporta l'adattatore Pangle per iOS versione 4.9.0.8.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.4.0.
Versione 1.5.0
- Supporta l'adattatore Pangle Android versione 4.9.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 4.9.0.7.0.
- Sviluppato e testato con la versione 7.3.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.4.0
- Supporta l'adattatore Pangle per Android versione 4.8.1.0.0.
- Supporta l'adattatore Pangle per iOS versione 4.8.1.0.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.3.1.
Versione 1.3.1
- Supporta la versione 4.7.0.6.0 dell'adattatore Pangle per Android.
- Supporta la versione 4.7.0.6.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.2.0.
Versione 1.3.0
- I seguenti metodi sono stati rinominati nella classe
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Supporta l'adattatore Pangle Android versione 4.7.0.5.0.
- Supporta l'adattatore Pangle per iOS versione 4.7.0.5.0.
- Creato e testato con la versione 7.2.0 del plug-in Unity per gli annunci per dispositivi mobili di Google.
Versione 1.2.0
- Supporta la versione 4.5.0.6.1 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 4.5.2.8.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.1.0.
Versione 1.1.0
- Supporta l'adattatore Pangle per Android versione 4.5.0.3.0.
- Supporta la versione 4.5.1.3.0 dell'adattatore Pangle per iOS.
- Sviluppato e testato con la versione 7.0.2 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.0.0
- Versione iniziale
- Supporta l'adattatore Pangle per Android versione 4.3.0.8.0.
- Supporta l'adattatore Pangle per iOS versione 4.3.0.5.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.0.0.