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 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 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:35.0.1"))

    // 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 BoM

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

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

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:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

Invia un messaggio di prova

Recupera l'ID 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, quindi la console Firebase ti consente di specificare un dispositivo di test che visualizza i messaggi on demand.

Il dispositivo di test è determinato da un ID FirebaseInstallations o FID. Trova l'ID installazione Firebase dell'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 tuo dispositivo di test

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

  1. Nella console Firebase, vai a DevOps e coinvolgimento > Messaggistica.

  2. Avvia il workflow per configurare una nuova campagna:

    • Se questa è la tua prima campagna:

      1. Fai clic su Crea la tua prima campagna.
      2. Seleziona Messaggi in-app di Firebase e fai clic su Crea.

    • Se hai già creato campagne:

      1. Nella scheda Campagne, fai clic su Nuova campagna.
      2. Seleziona In-App Messaging.

  3. Inserisci un Titolo per il primo messaggio.

  4. Fai clic su Test on Device (Testa sul dispositivo).

  5. Inserisci l'ID di installazione Firebase Firebase della tua app nel campo Aggiungi un ID di installazione.

  6. Fai clic su Test per inviare il messaggio. Verrà inviata immediatamente.

  7. Per visualizzare il messaggio sul dispositivo di test, 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