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 principale del progetto Flutter, esegui il seguente comando per installare il plug-in Firebase In-App Messaging:

    flutter pub add firebase_in_app_messaging
    
  2. Ricrea il progetto:

    flutter run
    
  3. Importa il plug-in Firebase In-App Messaging:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
    

Invia un messaggio di prova

Ottenere l'ID installazione dell'app

Per risparmiare energia, la messaggistica in-app Firebase recupera i messaggi dal server solo una volta al giorno. Ciò può rendere difficile il test, pertanto la Console Firebase consente di specificare un dispositivo di test che mostri i messaggi su richiesta.

Il dispositivo di test è determinato da un FID. Trova l'ID utente dell'app di test controllando l'output della console quando esegui l'app.

Su Android, il messaggio ha il seguente aspetto:

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

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

  1. Con il progetto Xcode aperto, seleziona Prodotto > Schema > Modifica schema... dalla barra dei menu in alto.
  2. Apri la scheda Argomenti della finestra di dialogo visualizzata.
  3. Fai clic su + Aggiungi elementi in Argomenti passati al momento dell'avvio.
  4. Inserisci "-FIRDebugEnabled" nel campo appena creato.
  5. Fai clic su Chiudi, quindi esegui l'app.

Quando l'app inizia a funzionare, cerca la seguente riga nei log della console di Xcode:

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

Invia un messaggio al 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 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 Esegui test sul dispositivo.
  6. Inserisci l'ID installazione Firebase dell'app nel campo Aggiungi un ID installazione.
  7. Fai clic su Test per inviare il messaggio.

La messaggistica in-app Firebase invia il tuo 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 tuo dispositivo è un dispositivo di test, cerca uno dei seguenti 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.