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
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
Ricrea il progetto:
flutter run
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
:
- Con il progetto Xcode aperto, seleziona Prodotto > Schema > Modifica schema... dalla barra dei menu in alto.
- Apri la scheda Argomenti della finestra di dialogo visualizzata.
- Fai clic su + Aggiungi elementi in Argomenti passati al momento dell'avvio.
- Inserisci "-FIRDebugEnabled" nel campo appena creato.
- 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:
- Nella console Firebase, apri Messaging.
- Se si tratta della tua prima campagna, fai clic su Crea la tua prima campagna.
- Seleziona Messaggi in-app di Firebase e fai clic su Crea.
- In caso contrario, nella scheda Campagne, fai clic su Nuova campagna.
- Seleziona Messaggistica in-app.
- Inserisci un titolo per il primo messaggio.
- Fai clic su Esegui test sul dispositivo.
- Inserisci l'ID installazione Firebase dell'app nel campo Aggiungi un ID installazione.
- 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.