Questa guida rapida mostra come configurare Firebase In-App Messaging e inviare il 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
Ricostruisci 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
Recuperare l'ID di installazione dell'app
Per risparmiare energia, Firebase In-App Messaging recupera i messaggi dal server solo una volta al giorno. Ciò può rendere difficoltosi i test, per cui la console Firebase ti consente di specificare un dispositivo di test che visualizzi i messaggi on demand.
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 è il seguente:
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 Firebase e fai clic su Crea.
- In caso contrario, fai clic su Nuova campagna nella scheda Campagne.
- Seleziona Messaggistica in-app.
- Inserisci un titolo per il primo messaggio.
- Fai clic su Esegui il test sul tuo dispositivo.
- Inserisci l'ID di installazione Firebase della tua app nel campo Aggiungi un ID di installazione.
- Fai clic su Test per inviare il messaggio.
Firebase In-App Messaging invia il 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.