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. Descrive come aggiungere Pangle alla configurazione di mediazione di un'unità pubblicitaria e 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 ha le seguenti funzionalità:
| Integrazione | |
|---|---|
| Offerte | |
| Cascata | |
| Formati | |
| Banner | |
| Interstitial | |
| Con premio | |
| Interstitial con premio | |
Requisiti
- SDK Google Mobile Ads più recente
- 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 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 la parte restante 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 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 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 delle offerte.
Cascata
Prendi nota dello User-ID 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.
Attiva la modalità di test
Segui le istruzioni riportate nella guida di Pangle Come aggiungere un annuncio di prova per attivare gli annunci di prova 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 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.pangle
OpenUPM
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 per gli annunci per dispositivi mobili di Google e fai clic su Installa.
Pacchetto Unity
Scarica l'ultima versione del plug-in di mediazione di Google Mobile Ads per Pangle dal link di download nel Changelog ed estrai il 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
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 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 | Inviato 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 la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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 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 Pangle per Android versione 6.0.0.5.0.
- 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 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 per Android versione 6.0.0.3.0.
- Supporta l'adattatore Pangle per iOS versione 5.9.0.9.0.
- Creato e testato con la versione 9.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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 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 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 la versione 5.8.0.8.0 dell'adattatore Pangle per iOS.
- Creato e testato con la versione 9.0.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 2.5.0
- Supporta l'adattatore Pangle per Android versione 5.7.0.1.0.
- 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 versione 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 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 la versione 5.1.0.9.0 dell'adattatore Pangle per Android.
- Supporta l'adattatore Pangle per iOS versione 5.1.1.0.0.
- Creato e testato con la versione 8.1.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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 l'adattatore Pangle per iOS versione 5.0.0.6.0.
- 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 l'adattatore Pangle per Android versione 4.8.1.0.0.
- Supporta l'adattatore Pangle per iOS versione 4.8.1.0.0.
- Sviluppato e testato con la versione 7.3.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 1.3.1
- Supporta l'adattatore Pangle per Android versione 4.7.0.6.0.
- Supporta la versione 4.7.0.6.0 dell'adattatore Pangle per iOS.
- Creato e testato con la versione 7.2.0 del plug-in Unity per gli annunci per dispositivi mobili di Google.
Versione 1.3.0
- I seguenti metodi sono stati rinominati nella classe
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Supporta l'adattatore Pangle per 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 l'adattatore Pangle per Android versione 4.5.0.6.1.
- 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 l'adattatore Pangle per Android versione 4.5.0.3.0.
- Supporta la versione 4.5.1.3.0 dell'adattatore Pangle per iOS.
- Creato 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 la versione 4.3.0.8.0 dell'adattatore Pangle per Android.
- 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.