Inizia a utilizzare la messaggistica in-app Firebase

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

Prima di iniziare

Se non lo hai già 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 versione della libreria.

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.6.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 le dipendenze della libreria Firebase senza utilizzare il file 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.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}

Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin sia quelli 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 difficile il test, pertanto la consoleFirebase ti consente di specificare un dispositivo di test che mostri i messaggi su richiesta.

Il dispositivo di test viene determinato da un ID FirebaseInstallations o FID. Trova l'ID utente dell'app di test controllando 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:

Nella console Firebase, apri la pagina Messaggistica.
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.
In caso contrario, fai clic su Nuova campagna nella scheda Campagne.
1. Seleziona Messaggistica in-app.
Inserisci un titolo per il primo messaggio.
Fai clic su Esegui test sul dispositivo.
Inserisci l'ID installazione Firebase della tua app nel campo Aggiungi un ID installazione.
Fai clic su Test per inviare il messaggio.

Firebase In-App Messaging invia il messaggio di prova non appena fai clic su Test. Per visualizzare il messaggio, 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