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, coprendo sia le integrazioni di asta sia quelle a cascata. Descrive come aggiungere la funzionalità di monetizzazione di Liftoff alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore di Vungle in un'app per Android.

Integrazioni e formati degli annunci supportati

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

¹ L'integrazione delle offerte è in versione beta aperta.

² L'integrazione con la struttura a cascata per questo formato è in versione beta aperta.

Requisiti

• Livello API Android 21 o superiore

• SDK Google Mobile Ads più recente

• Completare la mediazione Guida introduttiva

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 monetizzazione di Liftoff facendo clic sul pulsante Aggiungi applicazione.

Compila il modulo inserendo tutti i dettagli necessari.

Una volta creata, selezionala dalla dashboard di Liftoff Monetize Applications.

Prendi nota dell'ID app.

Aggiungere nuovi posizionamenti

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

Attivare la modalità di test

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

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

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

Accedi al tuo account Ad Manager.

Aggiungere Liftoff Monetize nelle aziende

Attivare la condivisione di indicatori sicuri

Configurare le offerte di 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 nelle impostazioni GDPR e nelle impostazioni relative ai regolamenti statali degli Stati Uniti per aggiungere Liftoff all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti nell'interfaccia utente di Ad Manager.

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

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 e dell'adattatore Vungle:

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

Integrazione manuale

• Scarica l'SDK Vungle per Android più recente, estrae i file .jar dalla cartella libs e aggiungili al progetto.

• Vai agli elementi dell'adattatore Liftoff Monetize nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore Vungle e aggiungilo al progetto.

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

Consenso degli utenti dell'UE e GDPR

Ai sensi delle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che determinate informative vengano fornite agli utenti nello Spazio economico europeo (SEE) e che questi abbiano dato il loro consenso all'utilizzo di identificatori dei dispositivi e dati personali. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella catena di mediazione che potrebbe raccogliere, ricevere o utilizzare dati personali e fornire informazioni sull'utilizzo di ogni rete. Al momento Google non è in grado di trasmettere automaticamente la scelta dell'utente in merito al consenso a queste reti.

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

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

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

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

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

Per ulteriori dettagli e i valori che possono essere forniti nel metodo, consulta le istruzioni di implementazione consigliate per il GDPR.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono di garantire agli utenti il diritto di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) 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 statali sulla privacy degli Stati Uniti 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 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 compliance.

Liftoff Monetize include un'API che ti consente di trasmettere il consenso all'SDK Vungle. Il seguente esempio di codice mostra come trasmettere queste informazioni sul consenso all'SDK Vungle. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli 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 alcun 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'interfaccia utente di Liftoff Monetize.

Verificare gli annunci di prova

Per verificare di ricevere annunci di prova da Liftoff Monetize, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio Liftoff Monetize (asta) e Liftoff Monetize (struttura a cascata).

Passaggi facoltativi

Parametri specifici della rete

L'adattatore di monetizzazione Liftoff 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 di 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. Compila i seguenti campi per un NativeAd.

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

Codici di errore

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

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

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

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

Versione 7.4.2.0

• Compatibilità verificata con l'SDK Vungle 7.4.2.

Creato e testato con:

• SDK Google Mobile Ads versione 23.5.0.
• Versione dell'SDK Vungle 7.4.2.

Versione 7.4.1.0

• Compatibilità verificata con l'SDK Vungle 7.4.1.

Creato e testato con:

• SDK Google Mobile Ads versione 23.3.0.
• Versione dell'SDK Vungle 7.4.1.

Versione 7.4.0.1

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

Creato e testato con:

• SDK Google Mobile Ads versione 23.2.0.
• Versione dell'SDK Vungle 7.4.0.

Versione 7.4.0.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 23.2.0.
• Versione dell'SDK Vungle 7.4.0.

Versione 7.3.2.0

• Compatibilità verificata con l'SDK Vungle 7.3.2.

Creato e testato con:

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

Versione 7.3.1.0

• Compatibilità verificata con l'SDK Vungle 7.3.1.

Creato e testato con:

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

Versione 7.3.0.0

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

Creato e testato con:

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

Versione 7.1.0.0

• Compatibilità verificata con l'SDK Vungle 7.1.0.

Creato e testato con:

• SDK Google Mobile Ads versione 22.3.0.
• Versione dell'SDK Vungle 7.1.0.

Versione 7.0.0.1

• È stato risolto un problema per cui l'SDK Google Mobile Ads non registrava le impressioni per le offerte di annunci nativi.
• È stata ripristinata la dipendenza dell'adattatore dalla versione 22.3.0 dell'SDK Google Mobile Ads.

Creato e testato con:

• SDK Google Mobile Ads versione 22.3.0.
• Versione dell'SDK Vungle 7.0.0.

Versione 7.0.0.0

• È stato aggiunto il supporto per il caricamento di più annunci con lo stesso ID posizionamento per tutti i formati degli annunci con struttura a cascata.
• Il nome dell'adattatore è stato rinominato da Vungle a Liftoff Monetize.
• Compatibilità verificata con l'SDK Vungle 7.0.0.

Creato e testato con:

• SDK Google Mobile Ads versione 22.4.0.
• Versione dell'SDK Vungle 7.0.0.

Versione 6.12.1.1

• L'adattatore è stato aggiornato per utilizzare la nuova classe VersionInfo.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 22.0.0.

Creato e testato con:

• SDK Google Mobile Ads versione 22.0.0.
• Versione dell'SDK Vungle 6.12.1.

Versione 6.12.1.0

• Compatibilità verificata con l'SDK Vungle 6.12.1.

Creato e testato con:

• SDK Google Mobile Ads versione 21.4.0.
• Versione dell'SDK Vungle 6.12.1.

Versione 6.12.0.1

• È stato aggiunto il supporto per le 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 a 21.4.0.

Creato e testato con:

• SDK Google Mobile Ads versione 21.4.0.
• Versione dell'SDK Vungle 6.12.0.

Versione 6.12.0.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 21.1.0.
• Versione dell'SDK Vungle 6.12.0.

Versione 6.11.0.3

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

Creato e testato con:

• SDK Google Mobile Ads versione 21.1.0.
• Versione dell'SDK Vungle 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.

Creato e testato con:

• SDK Google Mobile Ads versione 21.0.0.
• Versione dell'SDK Vungle 6.11.0.

Versione 6.11.0.1

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

Creato e testato con:

• SDK Google Mobile Ads versione 21.0.0.
• Versione dell'SDK Vungle 6.11.0.

Versione 6.11.0.0

• Compatibilità verificata con l'SDK Vungle 6.11.0.

Creato e testato con:

• SDK Google Mobile Ads versione 20.6.0.
• Versione dell'SDK Vungle 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 a 20.6.0.

Creato e testato con:

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

Versione 6.10.4.0

• Compatibilità verificata con l'SDK Vungle 6.10.4.

Creato e testato con:

• SDK Google Mobile Ads versione 20.5.0.
• Versione dell'SDK Vungle 6.10.4.

Versione 6.10.3.0

• Compatibilità verificata con l'SDK Vungle 6.10.3.

Creato e testato con:

• SDK Google Mobile Ads versione 20.5.0.
• Versione dell'SDK Vungle 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 a 20.5.0.

Creato e testato con:

• SDK Google Mobile Ads versione 20.5.0.
• Versione dell'SDK Vungle 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 i parametri specifici della rete Vungle quando si richiedono annunci banner e interstitial.

Creato e testato con:

• SDK Google Mobile Ads versione 20.3.0.
• Versione dell'SDK Vungle 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 a 20.3.0.
• Gli annunci MREC sono ora supportati con l'API banner di Vungle.
• Messaggi e codici di errore standardizzati aggiornati.

Creato e testato con:

• SDK Google Mobile Ads versione 20.3.0.
• Versione dell'SDK Vungle 6.10.1.

Versione 6.9.1.1

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

Creato e testato con:

• SDK Google Mobile Ads versione 20.0.0.
• Versione dell'SDK Vungle 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 per gli annunci con premio per il callback onAdViewed di Vungle.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads alla versione 19.7.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.7.0.
• Versione dell'SDK Vungle 6.9.1.

Versione 6.8.1.1

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

Creato e testato con:

• SDK Google Mobile Ads versione 19.6.0.
• Versione dell'SDK Vungle 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 a 19.5.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.5.0.
• Versione dell'SDK Vungle 6.8.1.

Versione 6.8.0.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 19.4.0.
• Versione dell'SDK Vungle 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 a 19.3.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.3.0.
• Versione dell'SDK Vungle 6.7.1.

Versione 6.7.0.0

• Compatibilità verificata con l'SDK Vungle 6.7.0.
• L'adattatore è stato aggiornato per supportare le richieste di banner adattivi in linea.
• Per impostazione predefinita, gli annunci interstitial e con premio non sono più disattivati.
• Gli annunci interstitial ora inoltrano la chiamata di callback onAdLeftApplication() quando viene fatto clic.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 19.2.0.

Creato e testato con:

• SDK Google Mobile Ads versione 19.2.0.
• Versione dell'SDK Vungle 6.7.0.

Versione 6.5.3.0

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

Creato e testato con:

• SDK Google Mobile Ads versione 19.0.1.
• Versione dell'SDK Vungle 6.5.3.

Versione 6.4.11.1

• È stato risolto un problema per cui non era possibile aggiornare gli annunci banner.

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 a 18.2.0.

Versione 6.3.24.1

• L'adattatore è stato aggiornato per supportare la nuova API con premio in versione beta aperta.
• È stata aggiornata la versione minima richiesta dell'SDK Google Mobile Ads a 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

• L'adattatore è stato aggiornato per registrare correttamente i clic nell'SDK Google Mobile Ads.

Versione 5.3.2.0

• Compatibilità verificata con l'SDK Vungle 5.3.2.
• Aggiornamento del progetto Adpater per Android Studio 3.0.
• Sono stati aggiunti i seguenti metodi alla classe Bundle Builder.
  • setOrdinalViewCount : questo campo viene utilizzato per passare l'ordinale della mediazione ogni volta che il publisher riceve i report sui dati ordinali da Vungle.
  • setFlexViewCloseTimeInSec : questa opzione viene utilizzata per fare in modo che gli annunci in visualizzazione flessibile si chiudano autonomamente 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 di annunci video interstitial e con premio.