Integrare AppLovin con la mediazione

Questa guida illustra come utilizzare l'SDK Google Mobile Ads per caricare e visualizzare di AppLovin tramite la mediazione. che copre sia le integrazioni per l'asta che per la struttura a cascata. Spiega come aggiungere AppLovin alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK AppLovin e l'adattatore in un' Unity app.

Integrazioni e formati degli annunci supportati

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

Integrazione
Offerte
Cascata
Formati
Banner  1
Interstitial
Con premio

Annunci banner (escluso MREC) banner) sono supportati solo nella mediazione. Le offerte non supportano alcun tipo di annunci banner.

Requisiti

  • Versione più recente dell'SDK Google Mobile Ads
  • Unity 5.6 o versioni successive
  • [Per le offerte]: plug-in di mediazione Google Mobile Ads per AppLovin 4.2.0 o superiore (è consigliata l'ultima versione)
  • Per il deployment su Android
    • Livello API Android 21 o superiore
  • Per il deployment su iOS
    • Target del deployment di iOS 12.0 o versioni successive
  • Un progetto Unity funzionante configurato con Google l'SDK Mobile Ads. Consulta Inizia per maggiori dettagli.
  • Completare la mediazione Guida introduttiva

Passaggio 1: configura le configurazioni nella UI di AppLovin

Registrati o accedi al tuo account AppLovin.

Per configurare l' Ad Manager unità pubblicitaria, ti serviranno la chiave SDK e la chiave del report di AppLovin. Per trovarli, vai all'interfaccia utente di AppLovin > Account > Chiavi per visualizzare entrambi i valori.

Se prevedi di integrare solo l'asta, puoi procedere con la configurazione delle impostazioni di mediazione.

Seleziona app per la mediazione

Offerte

Questo passaggio non è obbligatorio per le integrazioni dell'asta.

Struttura a cascata

Nell'interfaccia utente di AppLovin, seleziona Applicazioni nella sezione Monetizzazione per accedere alle app registrate. Seleziona l'app da utilizzare con la mediazione dall'elenco di app disponibili.

Creare una zona

Offerte

Questo passaggio non è obbligatorio per le integrazioni dell'asta.

Struttura a cascata

Nell'interfaccia utente di AppLovin, seleziona Zone nella sezione Monetizzazione per ottenere 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.

Android

iOS

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

Android

iOS

Attivare la modalità di test

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

Passaggio 2: configura la domanda di AppLovin nell' Ad Manager UI

Configurare le impostazioni di mediazione per l'unità pubblicitaria

Android

Per le istruzioni, consulta il passaggio 2 della guida per Android.

iOS

Per le istruzioni, consulta il passaggio 2 nella guida per iOS.

Aggiungi AppLovin Corp. all'elenco dei partner pubblicitari relativi al GDPR e ai regolamenti statali degli Stati Uniti

Segui i passaggi descritti in Impostazioni GDPR e Impostazioni relative alle normative statali degli Stati Uniti per aggiungere AppLovin Corp. all'elenco di partner pubblicitari per le normative GDPR e statali degli Stati Uniti nell' Ad Manager UI.

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

OpenUPM-CLI

Se hai OpenUPM-CLI installato, puoi installare l'app Google Mobile Ads AppLovin il plug-in di mediazione per Unity al tuo progetto eseguendo questo comando: dalla directory radice del progetto:

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

OpenUPM

Nell'editor del progetto Unity, seleziona Modifica > Impostazioni progetto > Gestione pacchetti per aprire lo Impostazioni del gestore di pacchetti Unity.

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

Quindi, vai a Finestra > Gestione pacchetti per aprire lo Gestore di pacchetti Unity e Seleziona I miei registri dal menu a discesa.

Registri di unità

Seleziona la Mediazione AppLovin di Google Mobile Ads per Unity e fai clic su Installa.

Installa da OpenUPM

Pacchetto Unity

Scarica l'ultima versione del plug-in di mediazione degli annunci per dispositivi mobili di Google per AppLovin dal link di download nel Changelog e estrai il GoogleMobileAdsAppLovinMediation.unitypackage dal file ZIP.

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

Importa da Unity

Poi seleziona Asset > Risoluzione di Play Services > Risoluzione Android > Forza risoluzione. Il resolver di Unity Play Services eseguirà la risoluzione delle dipendenze da zero e copierà delle dipendenze dichiarate nella directory Assets/Plugins/Android del tuo App Unity.

Forza risoluzione

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

Ai sensi del Consenso degli utenti dell'UE di Google norme, devi assicurarti che vengano fornite determinate informative e permessi ottenuti dagli utenti dello Spazio economico europeo (SEE) in relazione a all'uso di identificatori dei dispositivi e dati personali. Queste norme riflettono Requisiti della direttiva e-Privacy e della direttiva generale sulla protezione dei dati dell'UE Regolamento (GDPR). Quando richiedi il consenso, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può raccogliere, ricevere o utilizzare dati personali, fornire informazioni sull'utilizzo di ciascuna rete. Al momento Google non è in grado di trasmettere automaticamente a queste reti la scelta dell'utente relativa al consenso.

Dal plug-in di mediazione degli annunci per dispositivi mobili di Google versione 7.0.0, AppLovin supporta la lettura della stringa per il consenso dalle preferenze e dalle impostazioni condivise lo stato del consenso di conseguenza.

Se non utilizzare il plug-in di mediazione di Google Mobile Ads per Applovin versione 7.0.0 o successive o Non utilizzare una CMP che scrive la stringa per il consenso nel preferenze, puoi utilizzare AppLovin.SetHasUserConsent() e AppLovin.SetIsAgeRestrictedUser() di machine learning. Il seguente codice campione mostra come per passare le informazioni sul consenso all'SDK di AppLovin. Queste opzioni devono essere impostate Prima di inizializzare l'SDK Google Mobile Ads per assicurarti che vengano inoltrati correttamente all'SDK di AppLovin.

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

AppLovin.SetHasUserConsent(true);

Inoltre, se è noto che l'utente appartiene a una categoria soggetta a limiti di età, puoi imposta anche il flag seguente su true.

AppLovin.SetIsAgeRestrictedUser(true);

Vedi le impostazioni della privacy di AppLovin per ulteriori informazioni.

Leggi statali sulla privacy degli Stati Uniti

Stati Uniti leggi statali sulla privacy richiedono dare agli utenti il diritto di disattivare la "vendita" delle loro "informazioni personali" (come definisce la legge tali termini), con la possibilità di disattivare la funzionalità tramite un messaggio "Non vendere i miei dati personali" in evidenza informazioni" sul link "venduto" sulla home page del gruppo. La Stati Uniti privacy degli stati la guida alla conformità alle leggi offre la possibilità di abilitare trattamento dati limitato per la pubblicazione di annunci Google, ma Google non può applicare questa impostazione a ciascun annuncio nella tua catena di mediazione. Di conseguenza, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che può partecipare alla vendita di e seguire le indicazioni di ciascuna di queste reti per garantire conformità.

Plug-in di mediazione Google Mobile Ads per AppLovin Versione 6.3.1 include AppLovin.SetDoNotSell() . Il seguente codice di esempio mostra come passare informazioni sul consenso all'SDK AppLovin. Queste opzioni devono essere impostate prima inizializzare gli annunci per cellulari di Google SDK per assicurarti che vengano inoltrati correttamente all'SDK di AppLovin.

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

AppLovin.SetDoNotSell(true);

Leggi le norme sulla privacy di AppLovin documentazione per ulteriori informazioni.

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

Attiva annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager e abilitare la modalità di test nell'interfaccia AppLovin UI.

Verifica annunci di prova

Per verificare di ricevere annunci di prova daAppLovin, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le AppLovin (Bidding) and AppLovin (Waterfall) origini annuncio.

Passaggi facoltativi

Ottimizzazioni

Aggiunta di una chiamata a AppLovin.Initialize() alla tua attività di lancio fornisce La possibilità di AppLovin di monitorare gli eventi non appena viene avviata l'app.

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 nel 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 relativi messaggi generati dall'adattatore AppLovin Quando un annuncio non viene caricato:

Android

Codice di errore Motivo
Da -1009 a -1, 204 L'SDK AppLovin ha restituito un errore. Consulta Documentazione di AppLovin per ulteriori informazioni.
101 Le dimensioni dell'annuncio richieste non corrispondono a quelle dei banner supportate 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 pubblicato.
108 AppLovin Adapter non supporta il formato dell'annuncio richiesto.

iOS

Codice di errore Motivo
Da -1009 a -1, 204 L'SDK AppLovin ha restituito un errore. Consulta la documentazione di AppLovin per ulteriori informazioni.
101 Le dimensioni dell'annuncio richieste non corrispondono a quelle dei banner supportate da AppLovin.
102 I parametri del server AppLovin configurati nell' Ad Manager UI non sono presenti o non sono validi.
103 Impossibile mostrare l'annuncio di AppLovin.
104 Sono stati richiesti più annunci per la stessa zona. AppLovin può caricare un solo annuncio alla volta per zona.
105 Chiave SDK AppLovin non trovata.
107 Il token dell'offerta è vuoto.
108 AppLovin Adapter non supporta il formato dell'annuncio richiesto.
110 AppLovin ha inviato un callback di caricamento riuscito, ma non ha caricato annunci.

Log delle modifiche del plug-in di mediazione AppLovin Unity

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 l'adattatore AppLovin Android versione 9.4.2.0.
  • Supporta l'adattatore AppLovin iOS versione 6.6.1.0.

Versione 4.1.0

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

Versione 4.0.0

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

Versione 3.1.2

  • Supporta l'adattatore AppLovin Android versione 8.1.4.0.
  • Supporta l'adattatore AppLovin iOS versione 5.1.2.0.

Versione 3.1.1

  • Supporta l'adattatore AppLovin Android versione 8.1.0.0.
  • Supporta l'adattatore AppLovin iOS versione 5.1.1.0.

Versione 3.1.0

  • Supporta l'adattatore AppLovin Android versione 8.1.0.0.
  • Supporta l'adattatore AppLovin iOS versione 5.1.0.0.

Versione 3.0.3

  • Supporta l'adattatore AppLovin Android versione 8.0.2.1.
  • Supporta l'adattatore AppLovin iOS versione 5.0.2.0.

Versione 3.0.2

  • Supporta AppLovin Android SDK versione 8.0.1.
  • Supporta AppLovin SDK per iOS versione 5.0.1.

Versione 3.0.1

  • Supporta AppLovin Android SDK versione 8.0.0.
  • Supporta AppLovin SDK per iOS versione 5.0.1.
  • È stato aggiunto il metodo AppLovin.SetIsAgeRestrictedUser() per indicare se l'utente appartiene a una categoria soggetta a limiti di età.

Versione 3.0.0

  • Supporta AppLovin Android SDK versione 8.0.0.
  • Supporta AppLovin SDK 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 AppLovin Android SDK versione 7.8.6.
  • Supporta AppLovin SDK per iOS versione 5.0.1.

Versione 1.2.1

  • Supporta AppLovin Android SDK versione 7.8.6.
  • Supporta l'SDK AppLovin per iOS versione 4.8.3.

Versione 1.2.0

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

Versione 1.1.0

  • Supporta AppLovin Android SDK versione 7.7.0.
  • Supporta AppLovin SDK per iOS versione 4.7.0.

Versione 1.0.0

  • Prima uscita
  • Supporta AppLovin Android SDK versione 7.4.1.
  • Supporta AppLovin SDK per iOS versione 4.4.1.