Inizia a utilizzare la messaggistica in-app Firebase

Questa guida rapida mostra come configurare Firebase In-App Messaging e inviare il tuo primo messaggio.


Prima di iniziare

Se non l'hai ancora fatto, aggiungi Firebase al tuo progetto Android.

Aggiungi l'SDK Firebase In-App Messaging al progetto

Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria In-App Messaging per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare la gestione delle versioni delle librerie.

Per utilizzare In-App Messaging, devi abilitare Google Analytics nel tuo progetto Firebase e aggiungere l'SDK Firebase per Google Analytics alla tua app. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.3.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

Utilizzando Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase per Android.

(alternativa) Aggiungi dipendenze della libreria Firebase senza utilizzare il BoM

Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella relativa riga di dipendenza.

Tieni presente che se nella tua app utilizzi più librerie Firebase, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni. 

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:21.0.0")
    implementation("com.google.firebase:firebase-analytics:22.1.0")
}
Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le domande frequenti su questa iniziativa).

Invia un messaggio di prova

Ottenere l'ID installazione dell'app

Per risparmiare energia, Firebase In-App Messaging recupera i messaggi dal server solo una volta al giorno. Ciò può rendere i test difficili, quindi La console Firebase ti consente di specificare un dispositivo di test che mostra i messaggi on demand.

Il dispositivo di test viene determinato da un ID FirebaseInstallations o FID. Trova il FID dell'app di test controllando il logcat in Android Studio per il seguente log a livello di "Informazioni":

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

Invia un messaggio al dispositivo di test

Dopo aver lanciato l'app sul dispositivo di test e aver ottenuto il relativo ID Firebaseinstallazione (FID), puoi provare la configurazione Firebase In-App Messaginginviando un messaggio di prova:

  1. Nella console Firebase, apri la pagina Messaggi.
  2. Se si tratta della tua prima campagna, fai clic su Crea la tua prima campagna.
    1. Seleziona Messaggi in-app di Firebase e fai clic su Crea.
  3. In caso contrario, fai clic su Nuova campagna nella scheda Campagne.
    1. Seleziona Messaggistica in-app.
  4. Inserisci un titolo per il primo messaggio.
  5. Fai clic su Testa sul dispositivo.
  6. Inserisci l'ID installazione Firebase della tua app nel campo Aggiungi un ID installazione.
  7. Fai clic su Test per inviare il messaggio.

Non appena fai clic su Prova, Firebase In-App Messaging invia il tuo messaggio di prova. Per vedere le devi chiudere e riaprire l'app sul dispositivo di test.

Per verificare se il tuo dispositivo è un dispositivo di test, cerca il seguente messaggio di log:

I/FIAM.Headless: Setting this device as a test device