Inizia con la messaggistica in-app Firebase

Questa guida rapida mostra come configurare la messaggistica in-app Firebase e inviare il tuo primo messaggio.

Prima di iniziare

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

Aggiungi l'SDK di messaggistica in-app Firebase al tuo progetto

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

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

Ora inizializza l'SDK nella tua app:

  1. Importa il modulo Firebase nella struttura App o UIApplicationDelegate , se non l'hai ancora fatto:
    Veloce
    import Firebase
    Obiettivo-C
    @import Firebase;
  2. Configura anche un'istanza condivisa FirebaseApp , in genere nell'inizializzatore App o nel metodo application application(_:didFinishLaunchingWithOptions:) del delegato dell'app, se non lo hai ancora fatto:
    Veloce
    FirebaseApp.configure()
    Obiettivo-C
    [FIRApp configure];
  3. Compila ed esegui la tua app.

Invia un messaggio di prova

Ottieni l'ID di installazione della tua app

Per risparmiare energia, la messaggistica in-app Firebase recupera i messaggi dal server solo una volta al giorno. Ciò può rendere difficili i test, quindi la console Firebase ti consente di specificare un dispositivo di test che visualizzi messaggi su richiesta.

Il dispositivo di test è determinato da un ID di installazione Firebase fornito dal servizio di installazione Firebase. Per trovare l'ID di installazione dell'app di test, 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 che si apre.
  3. Fare 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'esecuzione dell'app, cerca la seguente riga 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 prova e aver ottenuto l'ID di installazione Firebase (FID), puoi provare la configurazione della messaggistica in-app Firebase inviando un messaggio di prova:

  1. Nella console Firebase, apri la pagina Messaggistica .
  2. Se questa è la tua prima campagna, fai clic su Crea la tua prima campagna .
    1. Seleziona Messaggi in-app Firebase e fai clic su Crea .
  3. Altrimenti, nella scheda Campagne , fai clic su Nuova campagna .
    1. Seleziona Messaggistica in-app .
  4. Inserisci un titolo per il tuo primo messaggio.
  5. Fare clic su Prova sul dispositivo
  6. Inserisci l'ID di installazione Firebase della tua app nel campo Aggiungi un ID di installazione .
  7. Fare clic su Prova per inviare il messaggio.

La messaggistica in-app Firebase invia il messaggio di prova non appena fai clic su Test . Per visualizzare il messaggio, devi chiudere e quindi riaprire l'app sul dispositivo di test.

Per verificare se il tuo dispositivo è un dispositivo di prova, cerca il seguente messaggio di registro:

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