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 tuo progetto

Nel file Gradle (a livello di app) del modulo (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 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.0.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 la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

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

Se scegli di non utilizzare la Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga della 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.0")
    implementation("com.google.firebase:firebase-analytics:23.0.0")
}

Invia un messaggio di prova

Recuperare 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 console Firebase ti consente di specificare un dispositivo di test che visualizza i messaggi su richiesta.

Il dispositivo di test è determinato da un ID FirebaseInstallations o FID. Trova l'ID della tua app di test controllando Logcat in Android Studio per il seguente log di 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 ottenuto il relativo Firebase ID installazione (FID), puoi provare la tua Firebase In-App Messaging configurazione 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 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.

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