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 ancora fatto, installa e inizializza gli SDK Firebase per Flutter.

Aggiungi l'SDK Firebase In-App Messaging al tuo progetto

  1. Dalla directory principale del progetto Flutter, esegui questo comando per installare il plug-in Firebase In-App Messaging:

    flutter pub add firebase_in_app_messaging

  2. Ricostruisci 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

Recupera l'ID installazione dell'app

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

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

Su Android, il messaggio è simile al 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:

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

Una volta avviata l'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 avviato l'app sul dispositivo di test e aver ottenuto il relativo ID installazione di Firebase (FID), puoi provare la configurazione di Firebase In-App Messaging inviando un messaggio di prova:

  1. Nella console Firebase, vai a DevOps e coinvolgimento > Messaggistica.

  2. Avvia il workflow per configurare una nuova campagna:

    • Se questa è la tua prima campagna:

      1. Fai clic su Crea la tua prima campagna.
      2. Seleziona Messaggi in-app di Firebase e fai clic su Crea.

    • Se hai già creato campagne:

      1. Nella scheda Campagne, fai clic su Nuova campagna.
      2. Seleziona In-App Messaging.

  3. Inserisci un Titolo per il primo messaggio.

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

  5. Inserisci l'ID di installazione Firebase della tua app nel campo Aggiungi un ID di installazione.

  6. Fai clic su Test per inviare il messaggio. Verrà inviata immediatamente.

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