Integra Liftoff Monetize con la mediazione

Questa guida mostra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare gli annunci di Liftoff Monetize utilizzando la mediazione, che copre sia le integrazioni di bidding sia quelle a cascata. Spiega come aggiungere Liftoff Monetize alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Vungle in un'app per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per Liftoff Monetize offre le seguenti funzionalità:

Requisiti

• Livello API Android 23 o superiore

• [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore Liftoff Monetize 7.3.0.0 o versioni successive (consigliata l'ultima versione)

• L'ultima versione dell'SDK Google Mobile Ads.

• Completa la Guida introduttiva alla mediazione.

Passaggio 1: configura le configurazioni 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.

Una volta creata l'app, selezionala dalla dashboard Applicazioni di Liftoff Monetize.

Prendi nota dell'ID app.

Aggiungere nuovi posizionamenti

Per creare un nuovo posizionamento da utilizzare con la mediazione di Ad Manager, vai alla dashboard dei 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:

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

Individuare la chiave API di Reporting

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario pubblicitario della tua app solo in canali che hai indicato 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 ulteriori informazioni, consulta app-ads.txt.

Attivare la modalità di test

Per attivare gli annunci di prova, vai alla dashboard di Liftoff Monetize e seleziona 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.

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

Accedi al tuo account Ad Manager.

Aggiungere Liftoff Monetize in Società

Attivare la condivisione di indicatori sicuri

Condividere indicatori sicuri nelle richieste di offerta

Consenti la condivisione di indicatori sicuri per SDK Bidding

Configurare le offerte Liftoff Monetize

Configurare la mappatura delle unità pubblicitarie

Aggiungere Liftoff all'elenco dei partner pubblicitari per il GDPR e i regolamenti statali degli Stati Uniti

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

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

Integrazione di Android Studio (consigliata)

Nel file build.gradle.kts a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione. Utilizza le versioni più recenti dell'SDK Vungle e dell'adattatore:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:vungle:7.5.1.0")
}

Integrazione manuale

• Scarica l'ultima versione dell'SDK Android Vungle ed estrai i file .aar e JAR dalla cartella libs e aggiungili al tuo progetto.

• Vai agli artefatti dell'adattatore Liftoff Monetize nel repository Maven di Google. Seleziona l'ultima versione, scarica il file .aar dell'adattatore Vungle e aggiungilo al progetto.

Passaggio 4: implementa le impostazioni della privacy nell'SDK Vungle

Consenso degli utenti dell'UE e GDPR

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 che il consenso venga propagato a ogni origine annuncio nella tua catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta del consenso dell'utente a queste reti.

A partire dalla versione 7.4.1 dell'SDK Vungle, Liftoff Monetize legge automaticamente il consenso al GDPR impostato dalle piattaforme di gestione del consenso che supportano la specifica per il consenso aggiuntivo di Google, incluso l'SDK UMP. Per saperne di più, consulta le istruzioni per l'implementazione consigliata del GDPR.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti il diritto di disattivare la "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di questi termini fornita dalla legge), mediante un link ben visibile 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 dati personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

Liftoff Monetize include un'API che ti consente di trasmettere il consenso all'SDK Vungle. Il seguente codice campione mostra come trasmettere queste informazioni sul consenso all'SDK Vungle. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere annunci tramite l'SDK Google Mobile Ads.

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

Per ulteriori dettagli e i valori che possono essere forniti nel metodo, consulta la sezione Implementazione del CCPA.

Passaggio 5: aggiungi il codice richiesto

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

Passaggio 6: 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'UI di Liftoff Monetize.

Verificare gli annunci di prova

Per verificare di ricevere annunci di test 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 (cascata).

Passaggi facoltativi

Parametri specifici per la rete

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

userId

Una stringa che rappresenta l'ID utente incentivato di Liftoff Monetize.

adOrientation

Un numero intero che specifica l'orientamento della presentazione per gli annunci a schermo intero.

Di seguito è riportato un esempio di codice per creare una richiesta annuncio che imposta questi parametri:

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

Rendering degli annunci nativi

L'adattatore Liftoff Monetize restituisce i suoi annunci nativi come NativeAd oggetti. Vengono compilati i seguenti campi per un NativeAd.

¹ L'adattatore Liftoff Monetize non fornisce l'accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece MediaView con un video o un'immagine.

Codici di errore

Se l'adattatore non riceve un annuncio da Liftoff Monetize, i publisher possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo.getAdapterResponses() nelle seguenti classi:

Ecco i codici e i messaggi associati generati dall'adattatore Liftoff Monetize quando un annuncio non viene caricato:

Per gli errori provenienti dall'SDK Vungle, consulta Error Codes: Vungle SDK for iOS and Android.

Log delle modifiche dell'adattatore di mediazione Android di Liftoff Monetize

Versione 7.5.1.0

• Compatibilità verificata con l'SDK Vungle 7.5.1.

Creata e testata con:

• SDK Google Mobile Ads versione 24.5.0.
• SDK Vungle versione 7.5.1.

Versione 7.5.0.1

• Imposta overrideImpressionRecording su true sia per gli annunci nativi con struttura a cascata sia per quelli RTB.

Creata e testata con:

• SDK Google Mobile Ads versione 24.4.0.
• SDK Vungle versione 7.5.0.

Versione 7.5.0.0

• Compatibilità verificata con l'SDK Vungle 7.5.0.

Creata e testata con:

• SDK Google Mobile Ads versione 24.2.0.
• SDK Vungle versione 7.5.0.

Versione 7.4.3.1

• È stato aggiornato il livello API Android minimo richiesto a 23.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 24.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 24.0.0.
• SDK Vungle versione 7.4.3.

Versione 7.4.3.0

• Compatibilità verificata con l'SDK Vungle 7.4.3.

Creata e testata con:

• SDK Google Mobile Ads versione 23.6.0.
• SDK Vungle versione 7.4.3.

Versione 7.4.2.0

• Compatibilità verificata con l'SDK Vungle 7.4.2.

Creata e testata con:

• SDK Google Mobile Ads versione 23.5.0.
• Vungle SDK versione 7.4.2.

Versione 7.4.1.0

• Compatibilità verificata con l'SDK Vungle 7.4.1.

Creata e testata con:

• SDK Google Mobile Ads versione 23.3.0.
• SDK Vungle versione 7.4.1.

Versione 7.4.0.1

• È stato aggiunto il supporto delle dimensioni degli annunci personalizzate per le offerte e gli annunci banner a cascata.

Creata e testata con:

• SDK Google Mobile Ads versione 23.2.0.
• SDK Vungle versione 7.4.0.

Versione 7.4.0.0

• Estensione della classe VungleInterstitialAdapter da VungleMediationAdapter per aggiungere il supporto della cascata per il formato dell'annuncio di apertura dell'app su Google Ad Manager.
• Compatibilità verificata con l'SDK Vungle 7.4.0.

Creata e testata con:

• SDK Google Mobile Ads versione 23.2.0.
• SDK Vungle versione 7.4.0.

Versione 7.3.2.0

• Compatibilità verificata con l'SDK Vungle 7.3.2.

Creata e testata con:

• SDK Google Mobile Ads versione 23.0.0.
• Versione 7.3.2 dell'SDK Vungle.

Versione 7.3.1.0

• Compatibilità verificata con l'SDK Vungle 7.3.1.

Creata e testata con:

• SDK Google Mobile Ads versione 23.0.0.
• SDK Vungle versione 7.3.1.

Versione 7.3.0.0

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 23.0.0.
• Compatibilità verificata con l'SDK Vungle 7.3.0.
• Aggiunto il supporto della struttura a cascata e dell'asta per il formato annuncio apertura app.

Creata e testata con:

• SDK Google Mobile Ads versione 23.0.0.
• SDK Vungle versione 7.3.0.

Versione 7.1.0.0

• Compatibilità verificata con l'SDK Vungle 7.1.0.

Creata e testata con:

• SDK Google Mobile Ads versione 22.3.0.
• SDK Vungle versione 7.1.0.

Versione 7.0.0.1

• È stato risolto un problema a causa del quale l'SDK Google Mobile Ads non registrava le impressioni per gli annunci nativi con offerta.
• È stato ripristinato l'adattatore in modo che dipenda dalla versione 22.3.0 dell'SDK Google Mobile Ads.

Creata e testata con:

• SDK Google Mobile Ads versione 22.3.0.
• SDK Vungle versione 7.0.0.

Versione 7.0.0.0

• È stato aggiunto il supporto per caricare più annunci con lo stesso ID posizionamento per tutti i formati degli annunci a cascata.
• Nome dell'adattatore modificato da Vungle a Liftoff Monetize.
• Compatibilità verificata con l'SDK Vungle 7.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 22.4.0.
• SDK Vungle versione 7.0.0.

Versione 6.12.1.1

• Adattatore aggiornato per utilizzare la nuova classe VersionInfo.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 22.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 22.0.0.
• Vungle SDK versione 6.12.1.

Versione 6.12.1.0

• Compatibilità verificata con l'SDK Vungle 6.12.1.

Creata e testata con:

• SDK Google Mobile Ads versione 21.4.0.
• Vungle SDK versione 6.12.1.

Versione 6.12.0.1

• È stato aggiunto il supporto delle offerte per il formato dell'annuncio banner.
• Compatibilità verificata con l'SDK Vungle 6.12.0.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 21.4.0.

Creata e testata con:

• SDK Google Mobile Ads versione 21.4.0.
• SDK Vungle versione 6.12.0.

Versione 6.12.0.0

• È stato aggiunto il supporto della mediazione a cascata e delle offerte per il formato dell'annuncio interstitial con premio.
• È stato aggiunto il supporto delle offerte per il formato dell'annuncio nativo.

Creata e testata con:

• SDK Google Mobile Ads versione 21.1.0.
• SDK Vungle versione 6.12.0.

Versione 6.11.0.3

• È stato aggiunto il supporto della mediazione a cascata per il formato dell'annuncio nativo.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 21.1.0.

Creata e testata con:

• SDK Google Mobile Ads versione 21.1.0.
• SDK Vungle versione 6.11.0.

Versione 6.11.0.2

• È stato aggiunto il supporto per il caricamento di più annunci per lo stesso ID posizionamento negli annunci con asta con premio.

Creata e testata con:

• SDK Google Mobile Ads versione 21.0.0.
• SDK Vungle versione 6.11.0.

Versione 6.11.0.1

• compileSdkVersion e targetSdkVersion aggiornati all'API 31.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 21.0.0.
• È stato aggiornato il livello API Android minimo richiesto a 19.

Creata e testata con:

• SDK Google Mobile Ads versione 21.0.0.
• SDK Vungle versione 6.11.0.

Versione 6.11.0.0

• Compatibilità verificata con l'SDK Vungle 6.11.0.

Creata e testata con:

• SDK Google Mobile Ads versione 20.6.0.
• SDK Vungle versione 6.11.0.

Versione 6.10.5.0

• Compatibilità verificata con l'SDK Vungle 6.10.5.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 20.6.0.

Creata e testata con:

• SDK Google Mobile Ads versione 20.6.0.
• Versione 6.10.5 dell'SDK Vungle.

Versione 6.10.4.0

• Compatibilità verificata con l'SDK Vungle 6.10.4.

Creata e testata con:

• SDK Google Mobile Ads versione 20.5.0.
• Vungle SDK versione 6.10.4.

Versione 6.10.3.0

• Compatibilità verificata con l'SDK Vungle 6.10.3.

Creata e testata con:

• SDK Google Mobile Ads versione 20.5.0.
• Vungle SDK versione 6.10.3.

Versione 6.10.2.1

• Compatibilità verificata con l'SDK Vungle 6.10.2.
• È stato aggiunto il supporto delle offerte per i formati degli annunci interstitial e con premio.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 20.5.0.

Creata e testata con:

• SDK Google Mobile Ads versione 20.5.0.
• Vungle SDK versione 6.10.2.

Versione 6.10.2.0

• Compatibilità verificata con l'SDK Vungle 6.10.2.
• È stato risolto un problema relativo all'adattatore sostituendo il parametro serverParameters con mediationExtras per ottenere parametri specifici della rete Vungle quando si richiedono annunci banner e interstitial.

Creata e testata con:

• SDK Google Mobile Ads versione 20.3.0.
• Vungle SDK versione 6.10.2.

Versione 6.10.1.0

• Compatibilità verificata con l'SDK Vungle 6.10.1.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 20.3.0.
• Gli annunci MREC ora sono supportati dall'API banner di Vungle.
• Codici e messaggi di errore standardizzati aggiornati.

Creata e testata con:

• SDK Google Mobile Ads versione 20.3.0.
• Vungle SDK versione 6.10.1.

Versione 6.9.1.1

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 20.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 20.0.0.
• Vungle SDK versione 6.9.1.

Versione 6.9.1.0

• Compatibilità verificata con l'SDK Vungle 6.9.1.
• È stato aggiunto il supporto per OMSDK.
• Correzione di diversi bug.
• Supporto degli annunci con premio per Vungle nel callback onAdViewed.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.7.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.7.0.
• Vungle SDK versione 6.9.1.

Versione 6.8.1.1

• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.6.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.6.0.
• Vungle SDK versione 6.8.1.

Versione 6.8.1.0

• Compatibilità verificata con l'SDK Vungle 6.8.1.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.5.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.5.0.
• Vungle SDK versione 6.8.1.

Versione 6.8.0.0

• Compatibilità verificata con l'SDK Vungle 6.8.0.
• È stato aggiornato l'adattatore in modo da non inoltrare onAdClosed() quando gli annunci banner vengono aggiornati o eliminati.
• Rimuovi FlexFeed e FlexView (deprecati in Vungle 6.8.0).
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.4.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.4.0.
• SDK Vungle versione 6.8.0.

Versione 6.7.1.0

• Compatibilità verificata con l'SDK Vungle 6.7.1.
• È stato corretto un bug per cui gli annunci non venivano caricati se un annuncio veniva caricato utilizzando un contesto dell'applicazione.
• targetSdkVersion aggiornato all'API 29.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.3.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.3.0.
• Vungle SDK versione 6.7.1.

Versione 6.7.0.0

• Compatibilità verificata con l'SDK Vungle 6.7.0.
• È stato aggiornato l'adattatore per supportare le richieste di banner adattivi in linea.
• Gli annunci interstitial e con premio ora sono riattivati per impostazione predefinita.
• Ora gli annunci interstitial inoltrano il callback onAdLeftApplication() quando viene effettuato un clic.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.2.0.

Creata e testata con:

• SDK Google Mobile Ads versione 19.2.0.
• SDK Vungle versione 6.7.0.

Versione 6.5.3.0

• Compatibilità verificata con l'SDK Vungle 6.5.3.
• Aggiungi il supporto per il formato banner di Vungle appena introdotto.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 19.0.1.

Creata e testata con:

• SDK Google Mobile Ads versione 19.0.1.
• Vungle SDK versione 6.5.3.

Versione 6.4.11.1

• È stato risolto un problema per cui gli annunci banner non venivano aggiornati.

Versione 6.4.11.0

• Compatibilità verificata con l'SDK Vungle 6.4.11.
• È stato aggiunto il supporto per gli annunci banner.
• È stata eseguita la migrazione dell'adattatore ad AndroidX.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 18.2.0.

Versione 6.3.24.1

• Adattatore aggiornato per supportare la nuova API Rewarded in versione beta aperta.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla 17.2.0.

Versione 6.3.24.0

• Compatibilità verificata con l'SDK Vungle 6.3.24.

Versione 6.3.17.0

• Compatibilità verificata con l'SDK Vungle 6.3.17.

Versione 6.3.12.0

• Compatibilità verificata con l'SDK Vungle 6.3.12.

Versione 6.2.5.1

• È stato aggiornato l'adattatore per richiamare l'evento annuncio onRewardedVideoComplete().

Versione 6.2.5.0

• Compatibilità verificata con l'SDK Vungle 6.2.5.

Versione 5.3.2.1

• Adattatore aggiornato per segnalare correttamente i clic all'SDK Google Mobile Ads.

Versione 5.3.2.0

• Compatibilità verificata con l'SDK Vungle 5.3.2.
• È stato aggiornato il progetto Adapter per Android Studio 3.0.
• Sono stati aggiunti i seguenti metodi alla classe Bundle builder.
  • setOrdinalViewCount : questo campo viene utilizzato per trasmettere l'ordinale di mediazione, ogni volta che il publisher riceve i report sui dati ordinali da Vungle.
  • setFlexViewCloseTimeInSec : questa opzione viene utilizzata per chiudere automaticamente gli annunci con visualizzazione flessibile dopo il numero di secondi specificato.

Versione 5.3.0.0

• Compatibilità verificata con l'SDK Vungle 5.3.0.

Versione 5.1.0.0

• L'adattatore è stato aggiornato per renderlo compatibile con l'SDK Vungle 5.1.0.
• È stato modificato il sistema di denominazione delle versioni in [Vungle SDK version].[adapter patch version].

Versioni precedenti

• È stato aggiunto il supporto per i formati degli annunci interstitial e video con premio.