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

Installa e inizializza gli SDK Firebase per Flutter se non l'hai ancora fatto.

Aggiungi l'SDK di messaggistica in-app Firebase al progetto

  1. Dalla directory root del tuo progetto Flutter, esegui questo per installare il plug-in di messaggistica in-app Firebase:

    flutter pub add firebase_in_app_messaging

  2. Ricostruisci il progetto:

    flutter run

  3. Importa il plug-in della messaggistica in-app Firebase:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

Invia un messaggio di prova

Recuperare l'ID di installazione dell'app

Per risparmiare energia, Firebase In-App Messaging recupera i messaggi dal server una volta al giorno. Ciò può rendere i test difficili, quindi La console Firebase ti consente di specificare un dispositivo di test che visualizza i messaggi on demand.

Il dispositivo di test viene determinato da un FID. Trova il valore FID dell'app di test controllando la console quando esegui l'app.

Su Android, il messaggio è il seguente:

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

Su iOS, esegui l'app con l'argomento del comando runtime -FIRDebugEnabled:

  1. Con il progetto Xcode aperto, seleziona Product > (Prodotto >) Schema > Modifica schema... da nella barra dei menu in alto.
  2. Apri la scheda Argomenti della finestra di dialogo visualizzata.
  3. Fai clic su + Add items (+ Aggiungi elementi) in Arguments Passed On Launch (Argomenti passati all'avvio).
  4. Inserisci "-FIRDebugEnabled" nel campo appena creato.
  5. Fai clic su Chiudi, quindi esegui l'app.

Una volta avviata l'esecuzione dell'app, cerca la riga seguente nei log della console Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Invia un messaggio al tuo dispositivo di test

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

  1. Nella console Firebase, apri Messaging.
  2. Se si tratta della tua prima campagna, fai clic su Crea la tua prima campagna.
    1. Seleziona Messaggi in-app Firebase e fai clic su Crea.
  3. In caso contrario, nella scheda Campagne, fai clic su Nuova campagna.
    1. Seleziona In-App Messaging (Messaggi in-app).
  4. Inserisci un Titolo per il tuo primo messaggio.
  5. Fai clic su Esegui test sul dispositivo.
  6. Inserisci l'ID installazione Firebase della tua app nel Aggiungi un ID 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 vedere le devi chiudere e riaprire l'app sul dispositivo di test.

Per verificare se il tuo dispositivo è un dispositivo di test, cerca una delle seguenti opzioni i messaggi di log.

Android

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

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.