Integra Liftoff Monetize con la mediazione

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

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di Liftoff Monetize utilizzando la mediazione che copre le integrazioni di asta e con struttura 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

• Ultimo GMA Next-Gen SDK.

• 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, 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:

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

Trovare la chiave API di Reporting

Aggiorna il file app-ads.txt

Authorized Sellers for Apps (Venditori autorizzati per app) 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 riduzione 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 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 Vungle e l'adattatore Liftoff Monetize

Integrazione di Android Studio (consigliata)

Nel file Gradle a livello di app, aggiungi le seguenti dipendenze di implementazione e configurazioni:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:vungle:7.7.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integrazione manuale

• Scarica l'ultima versione dell'SDK Android di 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 tuo 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 per l'utilizzo di cookie o altro spazio di archiviazione locale ove legalmente richiesto, nonché per la raccolta, la condivisione e l'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 sulla privacy degli stati degli Stati Uniti impongono di garantire agli utenti il diritto di disattivare la "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 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 utilizzare questo metodo, ti consigliamo di farlo prima di richiedere annunci tramite GMA Next-Gen SDK.

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSnippets.kt

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 (asta) 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.

setBackButtonImmediatelyEnabled

Un valore booleano per attivare o disattivare immediatamente il pulsante Indietro negli annunci apertura app. Imposta su true per attivare immediatamente il pulsante Indietro, false altrimenti. Il valore predefinito è false. Per maggiori informazioni, consulta la documentazione di Liftoff Monetize su come integrare gli annunci per l'apertura dell'app.

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);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
LiftoffMonetizeMediationSnippets.java

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
LiftoffMonetizeMediationSnippets.kt

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 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.getAdSourceResponses() 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.