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 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 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 la parte restante del modulo. Poi, fai clic su Invia.
Android
iOS
Prendi nota dell'ID app dell'applicazione.
Android
iOS
Crea 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, quindi seleziona Offerte in-app 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
Cascata
Seleziona il formato dell'annuncio, il nome del posizionamento dell'annuncio e il CPM globale come Tipo di prezzo. Compila la parte rimanente del modulo e fai clic su Invia.
Dopo aver creato il posizionamento dell'annuncio, prendi nota dell'ID posizionamento dell'annuncio.
Android
iOS
Individua 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 e API > Pangle Reporting API 2.0. Prendi nota di ID ruolo e Token di sicurezza.
Attiva la modalità di test
Segui le istruzioni riportate 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 Pangle nell' Ad Manager 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 comando seguente dalla directory principale del progetto:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Gestione pacchetti per aprire le Impostazioni del gestore di pacchetti 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
Successivamente, seleziona Finestra > Gestione pacchetti per aprire il Gestore di pacchetti Unity e seleziona I miei registri 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 > External Dependency Manager > Risoluzione 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 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.
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 non è possibile 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 Android versione 6.2.0.7.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.9.0.
- Sviluppato e testato con la versione 9.2.1 del plug-in Unity degli annunci per dispositivi mobili di Google.
Versione 4.3.2
- Supporta l'adattatore Android Pangle versione 6.2.0.6.0.
- Supporta l'adattatore Pangle per iOS versione 6.2.0.8.0.
- Creato e testato con la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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 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 la versione 9.2.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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.
- Creato e testato con il plug-in Unity per Google Mobile Ads versione 9.1.1.
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 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 la versione 5.9.0.2.0 dell'adattatore Pangle per Android.
- Supporta la versione 5.8.0.8.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.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 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.
- 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 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 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 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 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 per Android versione 4.7.0.5.0.
- Supporta l'adattatore Pangle per iOS versione 4.7.0.5.0.
- Creato e testato con il plug-in Unity di Google Mobile Ads versione 7.2.0.
Versione 1.2.0
- Supporta l'adattatore Pangle per Android versione 4.5.0.6.1.
- Supporta l'adattatore Pangle per iOS versione 4.5.2.8.0.
- Sviluppato e testato con la versione 7.1.0 del plug-in Unity per gli annunci per dispositivi mobili di Google.
Versione 1.1.0
- Supporta l'adattatore Pangle per Android versione 4.5.0.3.0.
- Supporta l'adattatore Pangle per iOS versione 4.5.1.3.0.
- 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 l'adattatore Pangle Android versione 4.3.0.8.0.
- Supporta l'adattatore Pangle per iOS versione 4.3.0.5.0.
- Creato e testato con la versione 7.0.0 del plug-in Unity per gli annunci per dispositivi mobili di Google.