Integrare AppLovin con la mediazione

Seleziona la piattaforma: Android (beta) New-selected Android iOS Unity Flutter

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e visualizzare gli annunci di AppLovin utilizzando la mediazione AdMob, che copre sia l'integrazione a cascata che quella tramite asta. Spiega 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à:

Integrazione
Offerte
Cascata
Formati
Apertura app  1
Banner  2
Interstitial
Con premio
Nativo

1 Il formato annuncio apertura app è disponibile solo per le integrazioni a cascata.

La 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 superiore
  • [Per le offerte]: per integrare tutti i formati dell'annuncio supportati nelle offerte, utilizza l'adattatore AppLovin 9.4.2.0 o versioni successive (consigliata l'ultima versione).

Passaggio 1: configura le configurazioni nell'interfaccia utente 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 trovarli, vai a Interfaccia utente AppLovin > Account > Chiavi per visualizzare entrambi i valori.

Se prevedi di integrare solo le offerte, puoi procedere con la configurazione delle impostazioni di mediazione.

Seleziona l'app per la mediazione

Offerte

Questo passaggio non è obbligatorio per le integrazioni delle offerte.

Cascata

Nell'interfaccia utente di AppLovin, seleziona Applications (Applicazioni) nella sezione Monetization (Monetizzazione) per accedere alle tue app registrate. Seleziona l'app che vuoi utilizzare con la mediazione dall'elenco delle app disponibili.

Creare una zona

Offerte

Questo passaggio non è obbligatorio per le integrazioni delle offerte.

Cascata

Nell'interfaccia utente di AppLovin, seleziona Zone nella sezione Monetizzazione per visualizzare gli ID zona registrati. Se hai già creato le zone richieste per la tua app, vai al passaggio 2. Per creare un nuovo ID zona, fai clic su Crea zona.

Inserisci il nome dell'ID zona, seleziona Android come Piattaforma e scegli il Tipo di annuncio.

Configura i prezzi per la zona selezionando CPM fisso o Ottimizzato da AppLovin. I CPM possono essere configurati in base al paese per l'opzione CPM fisso. Poi, fai clic su Salva.

Una volta creata la zona, l'ID zona si trova nella colonna ID zona.

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, configura un file app-ads.txt per la tua app.

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

Attivare la modalità di test

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

Passaggio 2: configura la domanda di AppLovin nell'interfaccia utente di AdMob

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Devi aggiungere AppLovin alla configurazione della mediazione per la tua unità pubblicitaria.

Innanzitutto, accedi al tuo 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 alla sezione Aggiungere AppLovin come origine annuncio.

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

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

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

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

Ora dovresti vedere la scheda delle unità pubblicitarie compilata con le unità pubblicitarie che hai selezionato:

Aggiungere AppLovin come origine annuncio

Offerte


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 l'asta con AppLovin.



Fai clic su Riconosci e accetta, poi su Continua.



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



A questo punto, inserisci la chiave SDK ottenuta nella sezione precedente. Poi fai clic su Fine.

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 bundle della tua app insieme alla chiave SDK e all'ID zona ottenuti nella sezione precedente. Poi fai clic su Fine.

Aggiungere AppLovin Corp. 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 AppLovin Corp. all'elenco dei partner pubblicitari ai sensi dei regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di AdMob.

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.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")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.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

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

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 12.0.0, l'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 una CMP che scrive la stringa del 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.

Java 

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

Kotlin 

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

Per saperne di più, consulta le impostazioni della privacy di AppLovin'.

Dichiarare 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 vigenti. Per ulteriori informazioni, consulta la documentazione di AppLovin relativa al Divieto di utilizzare i servizi per bambini o app destinate esclusivamente ai bambini.

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 GMA Next-Gen SDK:

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à.

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

Il seguente esempio 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.

Java 

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

Kotlin 

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

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

Passaggio 5: aggiungi il codice richiesto

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

Passaggio 6: testa l'implementazione

Attivare gli annunci di prova

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

Verificare 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 (asta) e AppLovin (cascata).

Passaggi facoltativi

Parametri specifici per la rete

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

Java 


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

Kotlin 


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

Ottimizzazioni

Inizializza l'SDK AppLovin all'avvio dell'app. In questo modo, AppLovin può iniziare a monitorare gli eventi immediatamente."

Codici di errore

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

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

Ecco i codici e i messaggi associati restituiti dall'adattatore AppLovin quando un annuncio non viene caricato:

Codice di errore Motivo
Da -1009 a -1, 204 L'SDK AppLovin ha restituito un errore. Per ulteriori dettagli, consulta la documentazione di AppLovin.
101 La dimensione dell'annuncio richiesta non corrisponde a una dimensione banner supportata da AppLovin.
103 Il contesto è nullo.
104 Il token di offerta di AppLovin è vuoto.
105 Sono stati richiesti più annunci per la stessa zona. AppLovin può caricare un solo annuncio alla volta per zona.
106 L'annuncio non è pronto per essere visualizzato.
108 L'adattatore AppLovin non supporta il formato dell'annuncio richiesto.
109 Il contesto non è un'istanza di Attività.
110 Chiave SDK mancante.
112 L'utente è un bambino.
113 L'ID unità pubblicitaria non è presente.