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 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 Applications (Applicazioni) e fai clic sul pulsante Add App (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
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 la parte rimanente del modulo e fai clic su Invia.
Una volta 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 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.
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 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 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
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 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 > 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
Attivare gli annunci di prova
Assicurati di registrare il dispositivo di test per AdMob 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 Pangle Unity
Versione 4.4.0
- Supporta l'adattatore Pangle per Android versione 6.3.0.2.0.
- Supporta l'adattatore Pangle per iOS versione 6.3.0.6.0.
- Creato e testato con la versione 9.3.0 del plug-in Unity degli annunci per dispositivi mobili di Google.
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.
- 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 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 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 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 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 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 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 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 la versione 5.8.0.8.0 dell'adattatore Pangle per iOS.
- 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 la versione 5.8.0.8.0 dell'adattatore Pangle per iOS.
- 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 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 l'adattatore Pangle per iOS versione 5.1.1.0.0.
- Creato e testato con il plug-in Unity per 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 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.
- 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 per 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 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.
- 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 l'adattatore Pangle per iOS versione 4.7.0.6.0.
- 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 della classe
Panglesono stati rinominati: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 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 Pangle per Android.
- 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 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.