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 autonoma di AdMob.

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

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 attivarlo dalla scheda Integrazioni di > Impostazioni progetto.Google Analytics

Passaggio 1:configura l'app nel tuo account AdMob

  1. Registra la tua app come app AdMob.

    1. Accedi o registrati per creare un account AdMob.

    2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un ID app AdMob 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 la tua app AdMob alla tua app Firebase.

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

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

    1. Attiva le metriche utente per consentire a AdMob di elaborare e visualizzare dati di analisi selezionati nel tuo account AdMob. È anche un'impostazione obbligatoria per collegare la tua app AdMob a Firebase.

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

      Assicurati di inserire lo stesso nome del pacchetto che hai inserito per la tua app Firebase. Puoi trovare il nome del pacchetto della tua app Firebase nella scheda Le tue app di > Impostazioni progetto.

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

Aggiungi il tuo 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) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle):

    implementation("com.google.android.gms:play-services-ads:25.5.0")
    
  2. Prima di caricare gli annunci, chiama il metodo MobileAds.initialize().

    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 solo una 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)
    }

    Java

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

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

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

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

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

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

  • Ottimizza la monetizzazione degli annunci per la tua app

    Prova diversi formati o configurazioni degli 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:

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

AdMob offre diversi formati degli annunci, così 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 le istruzioni dettagliate per l'implementazione nella documentazione di AdMob.

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

Gli annunci banner rimangono sullo schermo durante l'interazione degli utenti con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità mobile, sono un ottimo punto di partenza.

Implementa gli annunci banner

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

Implementa gli annunci interstitial

Nativo

Annunci personalizzabili che si adattano all'aspetto e all'esperienza di utilizzo dell'app

Gli annunci nativi sono un formato dell'annuncio basato su componenti. Decidi come e dove posizionare gli annunci nativi in modo che il layout sia più in linea con il design della tua app. Scegliendo caratteri, colori e altri dettagli, puoi creare presentazioni di annunci naturali e non invasive che possono contribuire a un'esperienza utente completa.

Implementa gli annunci nativi avanzati

Con premio

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

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

Implementa gli annunci con premio Implementa gli annunci con premio (nuove API)