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 già fatto, aggiungi Firebase al tuo progetto Android.

Aggiungi l'SDK Firebase In-App Messaging al tuo progetto

Nel file Gradle del modulo (a livello di app) (in genere <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 la Firebase Android BoM per controllare il controllo delle versioni della libreria.

Per utilizzare In-App Messaging, devi attivare 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:34.11.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")
}

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

(Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare la BoM

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

Tieni presente che, se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la 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:22.0.2")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

Invia un messaggio di prova

Recupera l'ID di installazione dell'app

Per risparmiare energia, Firebase In-App Messaging recupera i messaggi dal server solo una volta al giorno. Questo può rendere difficile il test, pertanto la Firebase console ti consente di specificare un dispositivo di test che visualizza i messaggi su richiesta.

Il dispositivo di test è determinato da un FirebaseInstallations ID o FID. Trova il FID dell'app di test controllando Logcat in Android Studio per il seguente log a livello `Info`:

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

Invia un messaggio al dispositivo di test

Dopo aver avviato l'app sul dispositivo di test e aver recuperato il relativo Firebase ID di installazione (FID), puoi provare la configurazione Firebase In-App Messaging inviando un messaggio di test:

  1. Nella console Firebase, apri la pagina Messaggistica.
  2. Se questa è la 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, nella scheda Campagne, fai clic su Nuova campagna.
    1. Seleziona Messaggistica in-app.
  4. Inserisci un titolo per il primo messaggio.
  5. Fai clic su Test on Device (Test sul dispositivo).
  6. Inserisci l'ID di installazione Firebase dell'app nel campo Add an installation ID (Aggiungi un ID di installazione).
  7. Fai clic su Test per inviare il messaggio.

Firebase In-App Messaging invia il messaggio di test non appena fai clic su Test. Per visualizzare il messaggio, devi chiudere e riaprire l'app sul dispositivo di test.

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

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