Iniziare a utilizzare AdMob nel progetto Android

Questa guida rapida è rivolta a publisher e sviluppatori che vogliono utilizzare AdMob per monetizzare un'app creata con Firebase. Se non prevedi di includere Firebase nella tua app, consulta la guida AdMob autonoma invece.

Se non l'hai ancora fatto, scopri tutti i vantaggi dell'utilizzo congiunto di AdMob, Firebase, e Google Analytics insieme.

Prima di iniziare

• Se non hai ancora un progetto Firebase e un'app Firebase, segui la guida introduttiva di Firebase: Aggiungi Firebase al tuo progetto Android.

• Assicurati che Google Analytics sia abilitato nel progetto Firebase:

  • Se generi un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se hai un progetto Firebase esistente in cui non è abilitato Google Analytics, puoi abilitare Google Analytics dalla scheda Integrazioni di settings > Impostazioni progetto.

Passaggio 1: configura l'app nel tuo account AdMob

1. Registra l'app come app AdMob.

   1. Accedi o registrati a un AdMob account.

   2. Registra l'app con AdMob. Questo passaggio crea un'app AdMob con un ID AdMob app univoco che ti servirà più avanti in questa guida.

   Ti verrà chiesto di aggiungere l'SDK Mobile Ads alla tua app. Troverai istruzioni dettagliate per questa attività più avanti in questa guida.

2. Collega l'app AdMob all'app Firebase.

   Questo passaggio è facoltativo, ma vivamente consigliato. Scopri di più sui vantaggi dell'attivazione delle metriche utente e del collegamento dell'app AdMob a Firebase.

   Completa i due passaggi seguenti nella dashboard App del tuo AdMob account:

   1. Attiva Metriche utente per consentire a AdMob di elaborare e visualizzare i dati di analisi curati nel tuo AdMob account. È anche un'impostazione obbligatoria per collegare l'app AdMob a Firebase.

   2. Collega l'app AdMob al progetto Firebase e all'app Firebase esistenti.

      Assicurati di inserire lo stesso nome pacchetto che hai inserito per l' app Firebase. Trova il nome pacchetto dell'app Firebase nella scheda Le tue app di settings > Impostazioni progetto.

Passaggio 2: aggiungi l'ID app AdMob al file AndroidManifest.xml

Aggiungi l'ID app AdMob al file AndroidManifest.xml dell'app aggiungendo il tag <meta-data> come mostrato di seguito.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

Passaggio 3: aggiungi e inizializza l'SDK Mobile Ads

1. Aggiungi la dipendenza per l'SDK Google Mobile Ads al file Gradle del modulo (a livello di app) (in genere <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle):

   implementation("com.google.android.gms:play-services-ads:25.2.0")
   

2. Prima di caricare gli annunci, chiama il MobileAds.initialize() metodo.

   Questa chiamata inizializza l'SDK e richiama un listener di completamento al termine dell'inizializzazione (o dopo un timeout di 30 secondi). Chiama questo metodo una sola volta e il prima possibile, idealmente all'avvio dell'app.

   Ecco un esempio di come chiamare il metodo initialize() in un'attività:

   Kotlin

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       // ...
       MobileAds.initialize(this)
   }
   MainActivity.kt

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // ...
       MobileAds.initialize(this);
   }
   MainActivity.java

Passaggio 4: visualizza le metriche utente e i dati di analisi

Dopo l'inizializzazione, l'SDK Mobile Ads inizia automaticamente a registrare gli eventi di analisi e le proprietà utente della tua app. Puoi visualizzare questi dati senza aggiungere codice aggiuntivo all' app o implementare annunci. Ecco dove puoi visualizzare questi dati di analisi:

• Nella scheda Metriche utente del tuo account AdMob (dashboard Home o App ), puoi visualizzare le metriche utente curate derivate dai dati di analisi raccolti, come la durata della sessione media, l'ARPU e la fidelizzazione.

• Nella dashboard _Analytics_ della console Firebase, puoi visualizzare statistiche aggregate e riepiloghi delle metriche chiave. Se aggiungi l'SDK Firebase per Google Analytics, puoi anche contrassegnare le conversioni per le campagne pubblicitarie e creare segmenti di pubblico personalizzati nella console Firebase.

Tieni presente che, per rappresentare meglio ARPU e ARPPU metriche, potresti voler includere i dati di un evento personalizzato di analisi denominato ecommerce_purchase nel calcolo delle entrate per queste metriche (scopri come).

Passaggio 5: (Facoltativo) utilizza altre funzionalità di Google Analytics e Firebase

Sfrutta altre opportunità e funzionalità per migliorare la monetizzazione delle app e il coinvolgimento degli utenti:

• Aggiungi e utilizza l'SDK Firebase per Google Analytics

  • Implementa la registrazione di eventi personalizzati nella tua app.

  • Contrassegna le conversioni per le campagne pubblicitarie personalizzate.

  • Includi i dati sugli eventi ecommerce_purchase nel calcolo delle entrate per ARPU e ARPPU metriche.

  Per saperne di più, consulta la guida all'utilizzo di e Firebase con AdMob app.Google Analytics

• Utilizza altri prodotti Firebase nella tua app

  Dopo aver aggiunto l'SDK Firebase per Google Analytics, utilizza altri prodotti Firebase per ottimizzare gli annunci nella tua app.

  • Remote Config ti consente di modificare il comportamento e l'aspetto della tua app senza pubblicare un aggiornamento dell'app, senza costi e per un numero illimitato di utenti attivi giornalieri.

  • A/B Testing ti offre la possibilità di testare le modifiche a UI, funzionalità o campagne di coinvolgimento della tua app per vedere se hanno un impatto sulle metriche chiave (come le entrate e la fidelizzazione) prima di implementare le modifiche su larga scala.

• Ottimizza la monetizzazione degli annunci per la tua app

  Prova diversi formati o configurazioni di annunci con un piccolo sottoinsieme di utenti, quindi prendi decisioni basate sui dati sull'implementazione dell'annuncio per tutti gli utenti. Per saperne di più, consulta i seguenti tutorial:

  • Testare l'adozione di un nuovo formato dell'annuncio (panoramica | implementazione).

  • Ottimizzare la frequenza degli annunci (panoramica | implementazione).

Passaggio 6: scegli un formato dell'annuncio da implementare nella tua app

AdMob offre diversi formati di annunci, quindi puoi scegliere quello che meglio si adatta all'esperienza utente della tua app. Fai clic su un pulsante per un formato dell'annuncio per visualizzare istruzioni di implementazione dettagliate nella documentazione AdMob.

Banner

Annunci rettangolari visualizzati nella parte superiore o inferiore dello schermo del dispositivo

Gli annunci banner rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per dispositivi mobili, sono un ottimo punto di partenza.

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app finché non vengono chiusi dall'utente

Gli annunci interstitial sono più adatti per le pause naturali nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Nativo

Annunci personalizzabili che corrispondono all'aspetto della tua app

Gli annunci nativi sono un formato di annunci basato su componenti. Sei tu a decidere come e dove vengono posizionati gli annunci nativi, in modo che il layout sia più in linea con il design della tua app. Scegliendo autonomamente caratteri, colori e altri dettagli, puoi creare presentazioni di annunci naturali e non intrusive che possono arricchire l'esperienza utente.

Con premio

Annunci che premiano gli utenti per la visualizzazione di video brevi e l'interazione con annunci demo e sondaggi

Gli annunci con premio (o "basati su premio") possono aiutarti a monetizzare gli utenti free-to-play.