Inizia con la messaggistica in-app Firebase

Questa guida introduttiva mostra come configurare la messaggistica in-app di 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 Firebase Apple:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Scegli la libreria di messaggistica in-app.
  4. 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.
  5. 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 tua App struct o UIApplicationDelegate , se non l'hai ancora fatto:
    Rapido
    import Firebase
    Obiettivo-C
    @import Firebase;
  2. Configura anche un'istanza condivisa FirebaseApp , in genere nell'inizializzatore della tua App o nel metodo application application(_:didFinishLaunchingWithOptions:) del delegato della tua app, se non hai ancora:
    Rapido
    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 di Firebase 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 su richiesta.

Il dispositivo di test è determinato da un ID di installazione di Firebase fornito dal servizio di installazione di 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. Fai clic su + Aggiungi elementi in Argomenti trasmessi all'avvio .
  4. Immettere "-FIRDebugEnabled" nel campo appena creato.
  5. Fare clic su Chiudi , quindi eseguire 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 prova

Una volta che hai avviato la tua app sul dispositivo di prova e hai il suo ID di installazione (FID) di Firebase, puoi provare la configurazione della messaggistica in-app di Firebase inviando un messaggio di prova:

  1. Nella console Firebase, apri la pagina Messaggi .
  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 Messaggi 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 di Firebase invia il tuo messaggio di prova non appena fai clic su Test . Per visualizzare il messaggio, devi chiudere e quindi riaprire l'app sul dispositivo di prova.

Per confermare 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.