Integra Liftoff Monetize con la mediazione

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Questa guida mostra come utilizzare Google Mobile Ads Unity Plugin per caricare e visualizzare gli annunci di Liftoff Monetize utilizzando la mediazione, che copre sia le integrazioni di Asta sia quelle con struttura a cascata. Viene spiegato come aggiungere Liftoff Monetize alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Liftoff Monetize in un'app Unity.

Integrazioni e formati degli annunci supportati

Integrazione
Offerte
Cascata
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio

Prerequisiti

Prima di continuare, verifica quanto segue:

  • Ultima versione di Google Mobile Ads Unity Plugin.
  • Unity Editor versione 4 o successive.
  • [Per l'asta]: per integrare tutti i formati degli annunci supportati nell'asta, utilizza il plug-in di mediazione di Google Mobile Ads per Liftoff Monetize 5.1.0 o versioni successive (consigliata l'ultima versione).
  • Per il deployment su Android
    • Livello API Android 24 o versioni successive.
  • Per il deployment su iOS
    • Target di deployment iOS 13.0 o versioni successive.
  • Un progetto Unity funzionante configurato con Google Mobile Ads Unity Plugin. Per informazioni dettagliate, consulta Configura Google Mobile Ads Unity Plugin.
  • Configura la mediazione.

    • Passaggio 1: configura le impostazioni nell'interfaccia utente di Liftoff Monetize

    Registrati o accedi al tuo account Liftoff Monetize.

    Aggiungi la tua app alla dashboard di Liftoff Monetize facendo clic sul pulsante Aggiungi applicazione.

    Compila il modulo inserendo tutti i dettagli necessari.

    Android

    iOS

    Una volta creata l'app, selezionala dalla dashboard delle applicazioni Liftoff Monetize.

    Android

    iOS

    Prendi nota dell'ID app.

    Android

    iOS

    Aggiungi nuovi posizionamenti

    Per creare un nuovo posizionamento da utilizzare con la mediazione, vai alla dashboard Posizionamenti di Liftoff Monetize, fai clic sul pulsante Aggiungi posizionamento e seleziona la tua app dall'elenco a discesa.

    Di seguito sono riportati i dettagli per l'aggiunta di nuovi posizionamenti:

    Seleziona Banner, inserisci un nome del posizionamento e compila il resto del modulo. [Solo offerte] In Monetizzazione, imposta l'opzione Offerte in-app su Attivata. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Banner 300 x 250

    Seleziona MREC, inserisci un nome del posizionamento e compila il resto del modulo. [Solo per l'asta] Nella sezione Monetizzazione, imposta l'opzione Asta in-app su Attivata. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Interstitial

    Seleziona Interstitial, inserisci un nome posizionamento e compila il resto del modulo. [Solo per l'asta] Nella sezione Monetizzazione, imposta l'opzione Asta in-app su Attivata. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Con premio

    Seleziona Con premio, inserisci un Nome posizionamento e compila il resto del modulo. [Solo per l'asta] Nella sezione Monetizzazione, imposta l'opzione Asta in-app su Attivata. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Interstitial con premio

    Seleziona Con premio. Inserisci un nome del posizionamento, attiva Ignorabile e compila il resto del modulo. [Solo per l'asta] Nella sezione Monetizzazione, attiva l'opzione Asta in-app. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Nativo

    Seleziona Nativo, inserisci un Nome posizionamento e compila il resto del modulo. [Solo per l'asta] Nella sezione Monetizzazione, imposta l'opzione Asta in-app su Attivata. Fai clic sul pulsante Continua nella parte inferiore della pagina per creare il posizionamento.

    Prendi nota dell'ID di riferimento e fai clic su Ok.

    Banner 300 x 250

    Interstitial

    Con premio

    Interstitial con premio

    Nativo

    Individuare la chiave API di Reporting

    Offerte

    Questo passaggio non è obbligatorio per le integrazioni di asta.

    Cascata

    Oltre all'ID app e all'ID riferimento, avrai bisogno anche della chiave API di reporting di Liftoff Monetize per configurare l'ID unità pubblicitaria di Ad Manager. Vai alla dashboard dei report di Liftoff Monetize e fai clic sul pulsante Chiave API di reporting per visualizzare la tua chiave API di reporting.

    Aggiorna il file app-ads.txt

    Authorized Sellers for Apps (app-ads.txt) è un'iniziativa di IAB Tech Lab che contribuisce a garantire che l'inventario pubblicitario della tua app venga venduto solo tramite canali che hai identificato come autorizzati. Per evitare una perdita significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, crea un file app-ads.txt per Ad Manager.

    Per implementare app-ads.txt per Liftoff Monetize, scarica e aggiungi le voci app-ads.txt di Liftoff Monetize al file app-ads.txt esistente. Per saperne di più, consulta app-ads.txt.

    Attiva la modalità di test

    Per attivare gli annunci di prova, vai alla dashboard di Liftoff Monetize e poi ad Applications (Applicazioni).

    Seleziona l'app per la quale vuoi attivare gli annunci di test nella sezione ID riferimento posizionamento dell'app. Gli annunci di test possono essere attivati selezionando Modalità di test su Mostra solo annunci di test nella sezione Stato.

    Android

    iOS

    Passaggio 2: configura la domanda di Liftoff Monetize nell'interfaccia utente di Ad Manager

    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.

    Aggiungere Liftoff all'elenco dei partner pubblicitari ai sensi del GDPR e delle normative statali degli Stati Uniti

    Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Liftoff all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di Ad Manager.

    Passaggio 3: importa l'SDK e l'adattatore Liftoff Monetize

    OpenUPM-CLI

    Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Liftoff Monetize di Google Mobile Ads per Unity nel tuo progetto eseguendo il seguente comando dalla directory root del progetto:

    openupm add com.google.ads.mobile.mediation.liftoffmonetize

    OpenUPM

    Nell'editor del progetto Unity, seleziona Edit > Impostazioni progetto > Package Manager per aprire le impostazioni di Unity Package Manager.

    Nella scheda Scoped Registries (Registri con ambito), aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Ambiti: com.google

    Dettagli OpenUPM

    Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries dal menu a discesa.

    Unity Registries

    Seleziona il pacchetto Google Mobile Ads LiftoffMonetize Mediation e fai clic su Installa.

    Installa da OpenUPM

    Pacchetto Unity

    Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per Liftoff Monetize dal link di download nella cronologia delle modifiche ed estrai GoogleMobileAdsLiftoffMonetizeMediation.unitypackage dal file zip.

    Nell'editor del progetto Unity, seleziona Assets (Asset) > Import Package (Importa pacchetto) > Custom Package (Pacchetto personalizzato) e individua il file GoogleMobileAdsLiftoffMonetizeMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

    Importa da Unity

    Poi, seleziona Assets > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager eseguirà la risoluzione delle dipendenze da zero e copierà le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

    Forza risoluzione

    Passaggio 4: implementa le impostazioni della privacy nell'SDK Liftoff Monetize

    Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi fornire determinate informative ai tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso all'utilizzo di cookie o di altro spazio di archiviazione locale ove richiesto dalla legge e alla raccolta, alla condivisione e all'utilizzo dei dati personali per la personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Sei responsabile della verifica della propagazione del consenso a ogni origine annuncio nella tua catena di mediazione.

    A partire dalla versione 5.2.2 del plug-in Unity di Liftoff Monetize, Liftoff Monetize legge automaticamente il consenso GDPR impostato dalle piattaforme di gestione del consenso che supportano la specifica Consenso aggiuntivo di Google, incluso l'SDK UMP. Per saperne di più, consulta le istruzioni di implementazione consigliate del GDPR per Android e iOS.

    Leggi statali sulla privacy degli Stati Uniti

    Le leggi statali sulla privacy degli Stati Uniti richiedono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), mediante un link ben visibile e recante la dicitura "Non vendere i miei dati personali" nella home page del "venditore". La Guida alla conformità alle leggi sulla privacy degli stati USA offre la possibilità di attivare il trattamento dati limitato per la pubblicazione di annunci Google, ma Google non è in grado di applicare questa impostazione a ogni rete pubblicitaria nella tua catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

    Il plug-in di mediazione Google Mobile Ads per Liftoff Monetize include metodi per trasferire le informazioni sul consenso all'SDK Liftoff Monetize. Il seguente codice campione mostra come trasmettere le informazioni sul consenso all'SDK Liftoff Monetize. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite Google Mobile Ads Unity Plugin.

    using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

    Per maggiori dettagli e per i valori che possono essere forniti nel metodo, consulta le istruzioni di implementazione consigliate per il CCPA per Android e iOS.

    Passaggio 5: aggiungi il codice richiesto

    Android

    Non è necessario alcun codice aggiuntivo per l'integrazione di Liftoff Monetize.

    iOS

    Integrazione di SKAdNetwork

    Segui la documentazione di Liftoff Monetize per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

    Passaggio 6: testa l'implementazione

    Attiva gli annunci di prova

    Assicurati di registrare il tuo dispositivo di test per Ad Manager e di attivare la modalità di test nell'interfaccia utente di Liftoff Monetize.

    Verifica gli annunci di prova

    Per verificare di ricevere annunci di prova da Liftoff Monetize, attiva il test di singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Liftoff Monetize (Bidding) e Liftoff Monetize (Waterfall).

    Passaggi facoltativi

    Parametri specifici per la rete

    L'adattatore Liftoff Monetize supporta i seguenti parametri di richiesta aggiuntivi che possono essere passati all'adattatore:

    SetBackButtonImmediatelyEnabled(bool)
    Un valore booleano per attivare o disattivare immediatamente il pulsante Indietro negli annunci apertura app. Imposta su true per attivare immediatamente il pulsante Indietro, altrimenti su false. Il valore predefinito è false. Per saperne di più, consulta la documentazione di Liftoff Monetize su come integrare gli annunci apertura app.

    Il seguente esempio di codice crea una richiesta di annuncio che imposta questi parametri:

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

var adRequest = new AdRequest();
var liftoffExtras = new LiftoffMonetizeMediationExtras();
liftoffExtras.SetBackButtonImmediatelyEnabled(true);
adRequest.MediationExtras.Add(liftoffExtras);

    Codici di errore

    Se l'adattatore non riesce a ricevere un annuncio da Liftoff Monetize, i publisher possono controllare l'errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo nelle seguenti classi:

    Android

    Formato Nome classe
    Apertura app (asta) com.google.ads.mediation.vungle.VungleMediationAdapter
    Apertura app (cascata) com.google.ads.mediation.vungle.VungleMediationAdapter
    Banner (offerta) com.google.ads.mediation.vungle.VungleMediationAdapter
    Banner (struttura a cascata) com.vungle.mediation.VungleInterstitialAdapter
    Interstitial (Bidding) com.google.ads.mediation.vungle.VungleMediationAdapter
    Interstitial (struttura a cascata) com.vungle.mediation.VungleInterstitialAdapter
    Con premio (Bidding) com.google.ads.mediation.vungle.VungleMediationAdapter
    Con premio (cascata) com.vungle.mediation.VungleAdapter
    Interstitial con premio (offerta) com.google.ads.mediation.vungle.VungleMediationAdapter
    Interstitial con premio (a cascata) com.google.ads.mediation.vungle.VungleMediationAdapter

    iOS

    Formato Nome classe
    Apertura app (offerte) GADMediationAdapterVungle
    Apertura app (cascata) GADMediationAdapterVungle
    Banner (asta) GADMediationAdapterVungle
    Banner (struttura a cascata) GADMAdapterVungleInterstitial
    Interstitial (offerta) GADMediationAdapterVungle
    Interstitial (struttura a cascata) GADMAdapterVungleInterstitial
    Con premio (Bidding) GADMediationAdapterVungle
    Con premio (cascata) GADMAdapterVungleRewardBasedVideoAd
    Interstitial con premio (asta) GADMediationAdapterVungle
    Interstitial con premio (cascata) GADMediationAdapterVungle

    Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Liftoff Monetize quando non è possibile caricare un annuncio:

    Android

    Codice di errore Motivo
    101 Parametri del server non validi (ad es. ID app o ID posizionamento).
    102 Le dimensioni del banner richieste non corrispondono a dimensioni degli annunci Liftoff Monetize valide.
    103 Liftoff Monetize richiede un contesto Activity per richiedere gli annunci.
    104 L'SDK Vungle non può caricare più annunci per lo stesso ID posizionamento.
    105 Inizializzazione dell'SDK Vungle non riuscita.
    106 L'SDK Vungle ha restituito un callback di caricamento riuscito, ma Banners.getBanner() o Vungle.getNativeAd() hanno restituito null.
    107 L'SDK Vungle non è pronto per riprodurre l'annuncio.
    108 L'SDK Vungle ha restituito un token di asta non valido.

    iOS

    Codice di errore Motivo
    101 Parametri del server non validi (ad es. ID app o ID posizionamento).
    102 È già stato caricato un annuncio per questa configurazione di rete. L'SDK Vungle non può caricare un secondo annuncio per lo stesso ID posizionamento.
    103 Le dimensioni dell'annuncio richiesto non corrispondono a una dimensione banner supportata da Liftoff Monetize.
    104 L'SDK Vungle non è riuscito a eseguire il rendering dell'annuncio banner.
    105 L'SDK Vungle supporta il caricamento di un solo annuncio banner alla volta, indipendentemente dall'ID posizionamento.
    106 L'SDK Vungle ha inviato un callback che indica che l'annuncio non è riproducibile.
    107 L'SDK Vungle non è pronto per riprodurre l'annuncio.

    Per gli errori provenienti dall'SDK Vungle, consulta Codici di errore: SDK Vungle per iOS e Android.

    Log delle modifiche del plug-in di mediazione Unity di Liftoff Monetize

    Versione 5.7.9

    Versione 5.7.8

    Versione 5.7.7

    Versione 5.7.6

    Versione 5.7.5

    Versione 5.7.4

    Versione 5.7.3

    Versione 5.7.2

    Versione 5.7.1

    Versione 5.7.0

    Versione 5.6.0

    Versione 5.5.3

    Versione 5.5.2

    Versione 5.5.1

    Versione 5.5.0

    Versione 5.4.1

    Versione 5.4.0

    Versione 5.3.5

    Versione 5.3.4

    Versione 5.3.3

    • Risolto un problema per cui l'installazione tramite OpenUPM impediva al plug-in di importare correttamente i pacchetti.

    Versione 5.3.2

    • Risolto un problema per cui l'installazione tramite OpenUPM impediva l'importazione corretta dei pacchetti da parte del plug-in.

    Versione 5.3.1

    Versione 5.3.0

    Versione 5.2.6

    Versione 5.2.5

    Versione 5.2.4

    Versione 5.2.3

    Versione 5.2.2

    Versione 5.2.1

    Versione 5.2.0

    Versione 5.1.1

    Versione 5.1.0

    • Risolto un NullPointerException che causava un errore di build durante l'esportazione come progetto Android.
    • Aggiornamento delle API per la privacy:
      • Sono stati rimossi i metodi UpdateConsentStatus() e UpdateCCPAStatus().
      • Sono state rimosse le enumerazioni VungleConsentStatus e VungleCCPAStatus.
      • Il metodo SetGDPRStatus(bool) è stato aggiornato a SetGDPRStatus(bool, String).
    • Sono stati rimossi i seguenti metodi dalla classe LiftoffMonetizeMediationExtras:
      • SetAllPlacements(String[])
      • SetSoundEnabled(bool)
    • Supporta l'adattatore Android Liftoff Monetize versione 7.3.1.0.
    • Supporta la versione 7.3.1.0 dell'adattatore iOS di Liftoff Monetize.
    • Sviluppato e testato con il plug-in Unity di Google Mobile Ads versione 9.1.0.

    Versione 5.0.0

    Versione 4.0.0

    • Il plug-in di mediazione Unity è stato rinominato da Vungle a Liftoff Monetize.
    • I contenuti dell'adattatore sono stati spostati in GoogleMobileAds/Mediation/LiftoffMonetize/.
    • Rifattorizzato lo spazio dei nomi dell'adattatore per utilizzare GoogleMobileAds.Mediation.LiftoffMonetize.
    • Sono stati aggiunti i seguenti metodi alla classe LiftoffMonetize:
      • SetGDPRStatus(bool)
      • SetGDPRMessageVersion(String)
      • SetCCPAStatus(bool)
    • Supporta l'adattatore Android Liftoff Monetize versione 6.12.1.1.
    • Supporta l'adattatore iOS Liftoff Monetize versione 7.0.1.0.
    • Creato e testato con il plug-in Unity di Google Mobile Ads versione 8.4.1.

    Versione 3.9.2

    Versione 3.9.1

    Versione 3.9.0

    Versione 3.8.2

    Versione 3.8.1

    Versione 3.8.0

    Versione 3.7.5

    Versione 3.7.4

    Versione 3.7.3

    Versione 3.7.2

    Versione 3.7.1

    Versione 3.7.0

    Versione 3.6.0

    Versione 3.5.1

    Versione 3.5.0

    Versione 3.4.1

    Versione 3.4.0

    Versione 3.3.1

    Versione 3.3.0

    Versione 3.2.0

    Versione 3.1.4

    • Supporta la versione 6.3.24.1 dell'adattatore Android.
    • Supporta la versione 6.3.2.3 dell'adattatore per iOS.

    Versione 3.1.3

    • Supporta la versione 6.3.24.1 dell'adattatore Android.
    • Supporta l'adattatore per iOS versione 6.3.2.2.

    Versione 3.1.2

    • Aggiornato il plug-in per supportare la nuova API per gli annunci con premio in versione beta aperta.
    • Supporta la versione 6.3.24.1 dell'adattatore Android.
    • Supporta la versione 6.3.2.1 dell'adattatore iOS.

    Versione 3.1.1

    • Supporta l'adattatore Android versione 6.3.24.0.
    • Supporta la versione 6.3.2.0 dell'adattatore per iOS.
    • Aggiornato il metodo Vungle.UpdateConsentStatus() per rendere facoltativo il parametro consentMessageVersion. Il valore di consentMessageVersion ora viene ignorato per iOS.
    • Vungle.GetCurrentConsentMessageVersion() deprecato per iOS.

    Versione 3.1.0

    • Supporta la versione 6.3.17.0 dell'adattatore Android.
    • Supporta la versione 6.3.0.0 dell'adattatore iOS.
    • Aggiornato il metodo Vungle.UpdateConsentStatus() per accettare un parametro String aggiuntivo per la versione del messaggio per il consenso fornito dal publisher.
    • È stato aggiunto il metodo Vungle.GetCurrentConsentMessageVersion() per ottenere la versione del messaggio di consenso fornita dal publisher.

    Versione 3.0.1

    • Supporta la versione 6.2.5.1 dell'adattatore Android.
    • Supporta la versione 6.2.0.3 dell'adattatore per iOS.

    Versione 3.0.0

    • Supporta l'adattatore Android versione 6.2.5.0.
    • Supporta la versione 6.2.0.2 dell'adattatore iOS.
    • Sono stati aggiunti i seguenti metodi:
      • Metodo Vungle.UpdateConsentStatus() per impostare lo stato del consenso che verrà registrato nell'SDK Vungle.
      • Vungle.GetCurrentConsentStatus() per ottenere lo stato del consenso attuale dell'utente.

    Versione 2.0.0

    • Supporta la versione 5.3.2.1 dell'adattatore Android.
    • Supporta la versione 6.2.0.0 dell'adattatore iOS.

    Versione 1.1.0

    • Supporta la versione 5.3.2.1 dell'adattatore Android.
    • Supporta la versione 5.4.0.0 dell'adattatore per iOS.

    Versione 1.0.0

    • Prima release.
    • Supporta la versione 5.3.0.0 dell'adattatore Android.
    • Supporta la versione 5.3.0.0 dell'adattatore per iOS.