Integrare AppLovin con la mediazione

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

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner  1
Interstitial
Con premio

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

Requisiti

  • SDK Google Mobile Ads più recente
  • Unity 5.6 o versioni successive
  • [Per le offerte]: per integrare tutti i formati degli annunci supportati nelle offerte, utilizza il plug-in di mediazione Google Mobile Ads per AppLovin 4.2.0 o versioni successive (consigliata l'ultima versione)
  • Per il deployment su Android
    • Livello API Android 23 o superiore
  • Per il deployment su iOS
    • Target di distribuzione iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con l'SDK Google Mobile Ads. Per maggiori dettagli, consulta la sezione Guida introduttiva.
  • Completa la mediazione Guida introduttiva

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 Applicazioni nella sezione 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 la determinazione del prezzo per la zona selezionando CPM fisso o Ottimizzato da AppLovin. I CPM possono essere configurati in base al paese per l'opzione CPM fisso. Quindi, fai clic su Salva.

Android

iOS

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

Android

iOS

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

Android

Per istruzioni, vedi il passaggio 2 della guida per Android.

iOS

Per istruzioni, vedi il passaggio 2 della guida per iOS.

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

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

OpenUPM-CLI

Se hai installato OpenUPM-CLI, puoi installare il plug-in di mediazione Google Mobile Ads Applovin per Unity nel tuo progetto eseguendo il seguente comando dalla directory principale del progetto:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Package Manager (Gestione pacchetti) per aprire le impostazioni di Unity Package Manager.

Nella scheda Registri con ambito, aggiungi OpenUPM come registro con ambito con i seguenti dettagli:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Ambiti: com.google

Dettagli OpenUPM

Poi vai a Window > Package Manager per aprire Unity Package Manager e seleziona My Registries (I miei registri) dal menu a discesa.

Unity Registries

Seleziona il pacchetto Google Mobile Ads Applovin Mediation e fai clic su Installa.

Installare da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione Google Mobile Ads per AppLovin dal link di download riportato nel Changelog ed estrai il GoogleMobileAdsApplovinMediation.unitypackage dal file zip.

Nell'editor del progetto Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il file GoogleMobileAdsApplovinMediation.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Importa da Unity

Quindi, seleziona Asset > External Dependency Manager > Android Resolver > Force Resolve. La libreria External Dependency Manager esegue la risoluzione delle dipendenze da zero e copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

Forza risoluzione

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

In base alle Norme relative al consenso degli utenti dell'UE di Google, devi assicurarti che vengano fornite determinate informative agli utenti nello Spazio economico europeo (SEE) e che venga ottenuto il loro consenso in merito all'utilizzo degli identificatori del dispositivo e dei 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 ciascuna rete. Al momento Google non è in grado di trasmettere automaticamente la scelta del consenso dell'utente a queste reti.

A partire dalla versione 7.0.0 del plug-in di mediazione Google Mobile Ads, AppLovin supporta la lettura della stringa di consenso dalle preferenze condivise e l'impostazione dello stato del consenso di conseguenza.

Se non utilizzi il plug-in di mediazione Google Mobile Ads per Applovin versione 7.0.0 o successive o non utilizzi una CMP che scrive la stringa di consenso nelle preferenze condivise, puoi utilizzare i metodi AppLovin.SetHasUserConsent() e AppLovin.SetIsAgeRestrictedUser(). Il seguente codice di esempio mostra come trasferire le informazioni sul consenso all'SDK AppLovin. Queste opzioni devono essere impostate prima di inizializzare l'SDK Google Mobile Ads per assicurarti che vengano inoltrate correttamente all'SDK AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Inoltre, se è noto che l'utente rientra in una categoria con limiti di età, puoi impostare il seguente flag su true.

AppLovin.SetIsAgeRestrictedUser(true);

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

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

Il plug-in di mediazione Google Mobile Ads per AppLovin versione 6.3.1 include il metodo AppLovin.SetDoNotSell(). Il seguente esempio di codice mostra come trasmettere le informazioni sul consenso all'SDK AppLovin. Queste opzioni devono essere impostate prima di inizializzare l'SDK Google Mobile Ads per assicurarti che vengano inoltrate correttamente all'SDK AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

Passaggio 5: aggiungi il codice richiesto

Android

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

iOS

Integrazione di SKAdNetwork

Segui la documentazione di AppLovin per aggiungere gli identificatori SKAdNetwork al file Info.plist del progetto.

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 singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio AppLovin (asta) e AppLovin (cascata).

Passaggi facoltativi

Ottimizzazioni

L'aggiunta di una chiamata a AppLovin.Initialize() all'attività di avvio consente ad AppLovin di monitorare gli eventi non appena l'app viene avviata.

Codici di errore

Se l'adattatore non riceve un annuncio da AppLovin, gli editori possono controllare l'errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo nelle seguenti classi:

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

Codice di errore Motivo
Da -1009 a -1204 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 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 Parametri del server non validi (ad es. la chiave SDK è null).
112 L'utente è un bambino.

iOS

Codice di errore Motivo
Da -1009 a -1204 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.
102 I parametri del server AppLovin configurati nell'interfaccia utente AdMob sono mancanti/non validi.
103 Impossibile mostrare l'annuncio AppLovin.
104 Sono stati richiesti più annunci per la stessa zona. AppLovin può caricare un solo annuncio alla volta per zona.
105 Chiave SDK di AppLovin non trovata.
107 Il token di offerta è vuoto.
108 L'adattatore AppLovin non supporta il formato dell'annuncio richiesto.
110 AppLovin ha inviato un callback di caricamento riuscito, ma ha caricato zero annunci.
111 Impossibile recuperare l'istanza dell'SDK AppLovin.
112 L'utente è un bambino.
113 L'istanza condivisa dell'SDK AppLovin non è stata inizializzata.
114 L'SDK AppLovin non restituisce il token di offerta.

Log delle modifiche del plug-in di mediazione Unity di AppLovin

Versione 8.3.2

Versione 8.3.1

Versione 8.3.0

Versione 8.2.1

Versione 8.2.0

Versione 8.1.1

Versione 8.1.0

Versione 8.0.4

Versione 8.0.3

Versione 8.0.2

Versione 7.4.1

Versione 7.4.0

Versione 7.3.1

Versione 7.3.0

Versione 7.2.2

Versione 7.2.1

Versione 7.2.0

Versione 7.1.0

Versione 7.0.1

Versione 7.0.0

Versione 6.9.1

Versione 6.9.0

Versione 6.8.0

Versione 6.7.0

Versione 6.6.0

Versione 6.5.1

Versione 6.5.0

Versione 6.4.3

Versione 6.4.2

Versione 6.4.1

Versione 6.4.0

Versione 6.3.1

Versione 6.3.0

Versione 6.2.1

Versione 6.2.0

Versione 6.1.0

Versione 6.0.0

Versione 5.1.3

Versione 5.1.2

Versione 5.1.1

Versione 5.1.0

Versione 5.0.0

Versione 4.8.1

Versione 4.8.0

Versione 4.7.0

Versione 4.6.2

Versione 4.6.1

Versione 4.6.0

Versione 4.5.8

Versione 4.5.7

Versione 4.5.6

Versione 4.5.5

Versione 4.5.4

Versione 4.5.3

Versione 4.5.2

Versione 4.5.1

Versione 4.5.0

Versione 4.4.1

Versione 4.4.0

Versione 4.3.0

Versione 4.2.0

  • Supporta la versione 9.4.2.0 dell'adattatore Android di AppLovin.
  • Supporta l'adattatore iOS di AppLovin versione 6.6.1.0.

Versione 4.1.0

  • È stato aggiornato il plug-in per supportare la nuova API Rewarded in versione beta aperta.
  • Supporta la versione 9.2.1.1 dell'adattatore Android di AppLovin.
  • Supporta l'adattatore iOS di AppLovin versione 6.3.0.0.

Versione 4.0.0

  • Supporta la versione 9.2.1.0 dell'adattatore Android di AppLovin.
  • Supporta l'adattatore iOS di AppLovin versione 6.2.0.0.

Versione 3.1.2

  • Supporta la versione 8.1.4.0 dell'adattatore Android di AppLovin.
  • Supporta la versione 5.1.2.0 dell'adattatore iOS di AppLovin.

Versione 3.1.1

  • Supporta la versione 8.1.0.0 dell'adattatore Android di AppLovin.
  • Supporta la versione 5.1.1.0 dell'adattatore iOS di AppLovin.

Versione 3.1.0

  • Supporta la versione 8.1.0.0 dell'adattatore Android di AppLovin.
  • Supporta la versione 5.1.0.0 dell'adattatore iOS di AppLovin.

Versione 3.0.3

  • Supporta la versione 8.0.2.1 dell'adattatore Android di AppLovin.
  • Supporta la versione 5.0.2.0 dell'adattatore iOS di AppLovin.

Versione 3.0.2

  • Supporta la versione 8.0.1 dell'SDK Android di AppLovin.
  • Supporta l'SDK AppLovin per iOS versione 5.0.1.

Versione 3.0.1

  • Supporta la versione 8.0.0 dell'SDK Android di AppLovin.
  • Supporta l'SDK AppLovin per iOS versione 5.0.1.
  • È stato aggiunto il metodo AppLovin.SetIsAgeRestrictedUser() per indicare se è noto che l'utente rientra in una categoria con limiti di età.

Versione 3.0.0

  • Supporta la versione 8.0.0 dell'SDK Android di AppLovin.
  • Supporta l'SDK AppLovin per iOS versione 5.0.1.
  • È stato aggiunto il metodo AppLovin.SetHasUserConsent() per inoltrare il flag del consenso dell'utente all'SDK AppLovin.

Versione 2.0.0

  • Supporta la versione 7.8.6 dell'SDK Android di AppLovin.
  • Supporta l'SDK AppLovin per iOS versione 5.0.1.

Versione 1.2.1

  • Supporta la versione 7.8.6 dell'SDK Android di AppLovin.
  • Supporta l'SDK iOS di AppLovin versione 4.8.3.

Versione 1.2.0

  • Supporta la versione 7.8.5 dell'SDK AppLovin per Android.
  • Supporta l'SDK iOS di AppLovin versione 4.8.3.

Versione 1.1.0

  • Supporta la versione 7.7.0 dell'SDK Android di AppLovin.
  • Supporta l'SDK AppLovin per iOS versione 4.7.0.

Versione 1.0.0

  • Prima release.
  • Supporta la versione 7.4.1 dell'SDK Android di AppLovin.
  • Supporta l'SDK iOS di AppLovin versione 4.4.1.