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 che quelle con struttura a cascata. Descrive come aggiungere Pangle alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Pangle in un' Unity app.
Integrazioni e formati degli annunci supportati
L' Ad Manager adattatore di mediazione per Pangle offre le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | 1 |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
Requisiti
- SDK Google Mobile Ads più recente
- Unity 5.6 o versioni successive
- [Per le offerte]: per integrare tutti i formati di annunci supportati nelle offerte, utilizza il plug-in di mediazione Google Mobile Ads per Pangle 2.4.0 o versioni successive (è consigliata la versione più recente)
- Per eseguire il deployment su Android
- Livello API Android 21 o superiore
- Per eseguire il deployment su iOS
- Target di deployment iOS 12.0 o versioni successive
- Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la guida introduttiva.
- Completa la mediazione Guida introduttiva
Passaggio 1: configura le impostazioni nell'interfaccia utente di Pangle
Registrati o accedi al tuo account Pangle.
Aggiungere 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.
Android
iOS
Prendi nota dell'ID app della tua applicazione.
Android
iOS
Creare un posizionamento dell'annuncio
Dopo aver creato 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 e 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 e il nome del posizionamento dell'annuncio, nonché il CPM globale come Tipo di prezzo. Compila la parte restante del modulo e fai clic su Invia.
Una volta creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Android
iOS
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' Ad Manager interfaccia utente
Configura le impostazioni di mediazione per l'unità pubblicitaria
Android
Per istruzioni, vedi il passaggio 2 della guida per Android.
iOS
Per istruzioni, vedi il passaggio 2 della guida per iOS.
Passaggio 3: importa l'SDK e l'adattatore Pangle
OpenUPM-CLI
Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Pangle di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale 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 basati su ambito, aggiungi OpenUPM come registry basato su ambito con i seguenti dettagli:
- Nome:
OpenUPM - URL:
https://package.openupm.com - Ambiti:
com.google
Quindi, vai a Finestra > Gestore pacchetti per aprire Gestore pacchetti Unity e selezionare I miei registry dal menu a discesa.
Seleziona il pacchetto Mediazione Pangle di Google Mobile Ads e fai clic su Installa.
Pacchetto Unity
Scarica la versione più recente del plug-in di mediazione Google Mobile Ads per Pangle dal link di download nel log delle modifiche ed estrai il file GoogleMobileAdsPangleMediation.unitypackage dal file 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 è necessario alcun 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
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per Ad Manager e di attivare la modalità di test nell'interfaccia utente 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).
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 messaggi associati generati dall'adattatore Pangle quando non riesce a caricare un annuncio:
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.4.2
- Supporta la versione 6.3.0.4.0 dell'adattatore Pangle per Android.
- Supporta la versione 6.3.1.0.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.4.0.
Versione 4.4.1
- Supporta la versione 6.3.0.4.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 6.3.0.8.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.3.0.
Versione 4.4.0
- Supporta la versione 6.3.0.2.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 6.3.0.6.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.3.0.
Versione 4.3.3
- Supporta l'adattatore Android Pangle 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 per 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 il plug-in Unity di Google Mobile Ads versione 9.2.0.
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 la versione 6.1.0.7.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 6.1.0.6.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 9.2.0.
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 per Android versione 6.0.0.8.0.
- Supporta la versione 6.1.0.5.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.1.
Versione 4.0.1
- Supporta la versione 6.0.0.5.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 6.0.0.6.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 4.0.0
- Supporta la versione 6.0.0.5.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 6.0.0.5.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 3.0.0
- Supporta l'adattatore Pangle per 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 5.9.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 5.9.0.8.0.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 2.8.0
- Supporta la versione 5.9.0.4.0 dell'adattatore Pangle per Android.
- Supporta la versione 5.9.0.7.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.0.
Versione 2.7.0
- Supporta la versione 5.9.0.2.0 dell'adattatore Pangle per Android.
- 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.1.0.
Versione 2.6.0
- Supporta l'adattatore Pangle per Android 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 la versione 5.5.0.9.0 dell'adattatore Pangle per iOS.
- 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 5.3.0.6.0.
- Supporta la versione 5.3.1.2.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.4.1.
Versione 2.2.0
- Supporta la versione 5.2.0.6.0 dell'adattatore Android Pangle.
- Supporta la versione 5.2.0.9.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.3.0.
Versione 2.1.0
- Supporta la versione 5.1.0.9.0 dell'adattatore Pangle per Android.
- Supporta la versione 5.1.1.0.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 8.1.0.
Versione 2.0.0
- I contenuti dell'adattatore sono stati spostati in
GoogleMobileAds/Mediation/Pangle/. - Spazio dei nomi dell'adattatore sottoposto a refactoring per utilizzare
GoogleMobileAds.Mediation.Pangle. - Supporta l'adattatore Pangle per Android versione 5.0.0.7.0.
- Supporta la versione 5.0.0.6.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.4.1.
Versione 1.5.1
- Supporta la versione 4.9.0.7.0 dell'adattatore Pangle per Android.
- 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 la versione 4.9.0.6.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 4.9.0.7.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.3.1.
Versione 1.4.0
- Supporta la versione 4.8.1.0.0 dell'adattatore Pangle per Android.
- 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 della classe
Panglesono stati rinominati:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Supporta l'adattatore Pangle per Android versione 4.7.0.5.0.
- Supporta la versione 4.7.0.5.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.2.0.
Versione 1.2.0
- Supporta la versione 4.5.0.6.1 dell'adattatore Android Pangle.
- Supporta la versione 4.5.2.8.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 7.1.0.
Versione 1.1.0
- Supporta la versione 4.5.0.3.0 dell'adattatore Pangle per Android.
- Supporta la versione 4.5.1.3.0 dell'adattatore Pangle per iOS.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.0.2.
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 per Google Mobile Ads versione 7.0.0.