Inizia a utilizzare la messaggistica in-app Firebase

Questa guida rapida mostra come configurare Firebase In-App Messaging e inviare il primo messaggio.


Prima di iniziare

Prima di iniziare, assicurati di aggiungere Firebase al tuo progetto Apple.

Aggiungi l'SDK Firebase In-App Messaging al progetto

Usa Swift Package Manager per installare e gestire le dipendenze di Firebase.

  1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Scegli la libreria In-App Messaging.
  4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di compilazione del target.
  5. Per utilizzare In-App Messaging, devi abilitare Google Analytics nel tuo progetto Firebase e aggiungere l'SDK Firebase per Google Analytics alla tua app. Puoi selezionare la libreria senza raccolta IDFA o con raccolta IDFA.
  6. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Inizializza l'SDK nella tua app:

  1. Importa il modulo Firebase nel tuo struct App oppure UIApplicationDelegate, se non l'hai ancora fatto:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Se non l'hai ancora fatto, configura anche un'istanza condivisa di FirebaseApp, in genere nell'inizializzatore di App o nel metodo application(_:didFinishLaunchingWithOptions:) del tuo app delegate:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compila ed esegui l'app.

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 difficile il test, pertanto la consoleFirebase ti consente di specificare un dispositivo di test che mostri i messaggi su richiesta.

Il dispositivo di test viene determinato da un ID installazione Firebase fornito Servizio di installazioni di Firebase. Per trovare l'ID di installazione dell'app di test, esegui l'app con argomento del comando 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.

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 Firebaseinstallazione (FID), puoi provare la configurazione Firebase In-App Messaginginviando un messaggio di prova:

  1. Nella console Firebase, apri la pagina Messaggistica.
  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, fai clic su Nuova campagna nella scheda Campagne.
    1. Seleziona Messaggistica in-app.
  4. Inserisci un titolo per il primo messaggio.
  5. Fai clic su Testa sul dispositivo.
  6. Inserisci l'ID installazione Firebase della tua app nel campo Aggiungi un ID installazione.
  7. Fai clic su Test per inviare il messaggio.

Firebase In-App Messaging invia il messaggio di prova 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 quanto segue messaggio di log:

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