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.13.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.

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.3")
    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 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 recuperato l'ID di installazione Firebase (FID), puoi provare la configurazione Firebase In-App Messaging inviando un messaggio di test:

1. Nella Firebase console, vai a DevOps & Engagement > Messaging (Messaggistica).

2. Avvia il flusso di lavoro per configurare una nuova campagna:

   • Se questa è la tua prima campagna:

     1. Fai clic su Create your first campaign (Crea la tua prima campagna).
     2. Seleziona Firebase In-App messages (Messaggi in-app di Firebase) e fai clic su Create (Crea).

   • Se hai già creato campagne:

     1. Nella scheda Campaigns (Campagne), fai clic su New campaign (Nuova campagna).
     2. Seleziona In-App Messaging (Messaggistica in-app).

3. Inserisci un Title (Titolo) per il primo messaggio.

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

5. Inserisci l'ID di installazione di Firebase dell'app nel campo Add an installation ID (Aggiungi un ID di installazione).Firebase

6. Fai clic su Test (Test) per inviare il messaggio. Verrà inviato immediatamente.

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