Integrare AppLovin con la mediazione

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

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci display di AppLovin utilizzando la mediazione AdMob, che copre sia le integrazioni con struttura a cascata sia quelle con asta. Viene illustrato come aggiungere AppLovin alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore AppLovin in un'app per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per AppLovin ha le seguenti funzionalità:

¹ Il formato dell'annuncio apertura app è disponibile solo per le integrazioni con struttura a cascata.

² La struttura a cascata supporta solo le dimensioni dei banner 320 x 50 e 728 x 90. Le offerte non supportano gli annunci banner.

Requisiti

• Livello API Android 24 o versioni successive

• [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l' adattatore AppLovin 9.4.2.0 o versioni successive (consigliamo la versione più recente).

• Più recente GMA Next-Gen SDK

• Completa la Guida introduttiva alla mediazione

Passaggio 1: configura le impostazioni nell'UI di AppLovin

Registrati o accedi al tuo account AppLovin.

Per configurare l'unità pubblicitaria AdMob, avrai bisogno della chiave SDK e della chiave report di AppLovin. Per trovarle, vai all' UI di AppLovin > Account > Chiavi per visualizzare entrambi i valori.

Se prevedi di integrare solo le offerte, puoi procedere a configurare le impostazioni di mediazione.

Seleziona l'app per la mediazione

Crea una zona

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario di annunci per app 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, configura un file app-ads.txt per la tua app.

Per implementare app-ads.txt per AppLovin, aggiungi AppLovin al file app-ads.txt.

Attiva la modalità di test

Segui le istruzioni riportate nella guida alla modalità di test MAX di AppLovin su come attivare gli annunci di test di AppLovin.

Passaggio 2: configura la domanda di AppLovin nell'UI di AdMob

Configura le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere AppLovin alla configurazione di mediazione per l'unità pubblicitaria.

Innanzitutto, accedi all'account AdMob. Poi, vai alla scheda Mediazione. Se hai un gruppo di mediazione esistente che vuoi modificare, fai clic sul nome del gruppo di mediazione per modificarlo e vai a Aggiungere AppLovin come origine annuncio.

Per creare un nuovo gruppo di mediazione, seleziona Crea gruppo di mediazione.

Inserisci il formato dell'annuncio e la piattaforma, quindi fai clic su Continua.

Assegna un nome al gruppo di mediazione e seleziona le località da scegliere come target. Poi, imposta lo stato del gruppo di mediazione su Attivato e fai clic su Aggiungi unità pubblicitarie.

Associa questo gruppo di mediazione a una o più delle unità pubblicitarie AdMob esistenti. Quindi, fai clic su Fine.

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie selezionate:

Aggiungi AppLovin come origine annuncio

Asta

Nella scheda Offerte della sezione Origini annuncio, seleziona Aggiungi origine annuncio. Poi, seleziona AppLovin.

Fai clic su Come firmare un contratto di partnership e configura una partnership per le offerte con AppLovin.



Fai clic su Riconosci e accetta, quindi su Continua.



Se hai già una mappatura per AppLovin, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.



Poi, inserisci la chiave SDK ottenuta nella sezione precedente. Quindi, fai clic su Fine.

A cascata

Nella scheda Cascata della sezione Origini annuncio, seleziona Aggiungi origine annuncio.

Seleziona AppLovin e attiva l'opzione Ottimizza. Inserisci la chiave report ottenuta nella sezione precedente per configurare l'ottimizzazione dell'origine annuncio per AppLovin. Poi, inserisci un valore eCPM per AppLovin e fai clic su Continua.



Se hai già una mappatura per AppLovin, puoi selezionarla. In caso contrario, fai clic su Aggiungi mappatura.

Poi, inserisci l' ID pacchetto della tua app insieme alla chiave SDK e all'ID zona ottenuti nella sezione precedente. Quindi, fai clic su Fine.

Aggiungi AppLovin Corp. all'elenco dei partner pubblicitari per il GDPR e le normative statali degli Stati Uniti

Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere AppLovin Corp. all'elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'UI di AdMob.

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

Integrazione di Android Studio (consigliata)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:applovin:13.6.1.0")
}

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.25.0-beta01'
    implementation 'com.google.ads.mediation:applovin:13.6.1.0'
}

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'SDK Android di AppLovin , estrai applovin-sdk-x.y.z.jar, e aggiungilo al tuo progetto.

• Vai agli artefvin adapter artifacts nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore AppLovin e aggiungilo al tuo progetto.

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK AppLovin

Consenso degli utenti dell'UE e GDPR

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, è obbligatorio informare i tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ricevere il loro consenso per l'utilizzo dei cookie o di altri tipi di archiviazione locale, laddove richiesto dalla legge, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali ai fini della personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta di consenso dell'utente a queste reti.

A partire dalla versione 12.0.0 dell'SDK, AppLovin supporta la lettura della stringa di consenso dalle preferenze condivise e l'impostazione dello stato del consenso di conseguenza.

Se non utilizzi la versione 12.0.0 o successive dell'SDK AppLovin o non utilizzi una CMP che scrive la stringa di consenso nelle preferenze condivise , puoi utilizzare il metodo setHasUserConsent. L'esempio seguente trasmette le informazioni sul consenso all'SDK AppLovin. Devi impostare queste opzioni prima di inizializzare GMA Next-Gen SDK per assicurarti che vengano inoltrate correttamente all'SDK AppLovin.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

Per maggiori informazioni, consulta le impostazioni sulla privacy di AppLovin's.

Dichiara gli utenti minorenni

A partire dall'SDK AppLovin 13.0.0, AppLovin non supporta più i flag utente con limitazioni di età e non puoi inizializzare o utilizzare l'SDK AppLovin in relazione a un "minore" come definito dalle leggi applicabili. Per maggiori informazioni, consulta la documentazione di AppLovin's su Divieto di dati dei minori o Utilizzo dei servizi per i minori o delle app destinate esclusivamente ai minori .

La versione 13.0.0.1 o successive dell'adattatore AppLovin disattiva automaticamente la mediazione AppLovin per le app che dichiarano una delle seguenti impostazioni con l' GMA Next-Gen SDK:

• Impostazione rivolta ai minori

• Utenti di età inferiore a quella del consenso digitale

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben in evidenza 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 catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

L'SDK AppLovin include il metodo setDoNotSell per consentire ai publisher di disattivare la vendita di informazioni personali.

L'esempio seguente trasmette queste informazioni sul consenso all'SDK AppLovin. Devi impostare queste opzioni prima di inizializzare GMA Next-Gen SDK per assicurarti che vengano inoltrate correttamente all'SDK AppLovin.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

Per maggiori informazioni, consulta la documentazione sulla privacy di AppLovin's.

Passaggio 5: aggiungi il codice richiesto

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

Passaggio 6: verifica l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per AdMob e attivare la modalità di test nell' UI di AppLovin.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da AppLovin, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio AppLovin (Offerte) e AppLovin (Cascata).

Passaggi facoltativi

Parametri specifici della rete

L'adattatore AppLovin supporta setMuteAudio() che può disattivare l'audio degli annunci video. Questo metodo può essere chiamato da un oggetto AppLovinExtras.Builder():

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Ottimizzazioni

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da AppLovin, i publisher possono controllare il errore sottostante dalla risposta dell'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore AppLovin quando un annuncio non viene caricato: