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

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

Aggiungi l'SDK Firebase In-App Messaging 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 (File > Aggiungi pacchetti).
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Scegli la libreria In-App Messaging.
  4. Aggiungi il flag -ObjC alla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di compilazione della destinazione.
  5. Per utilizzare In-App Messaging, devi attivare 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. Consulta le nostre Domande frequenti sull' organizzazione più recente dei moduli nell'Google Analytics per SDK Firebase.
  6. Al termine, Xcode inizierà automaticamente a risolvere e a 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:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Configura anche un'istanza condivisa FirebaseApp, in genere nell'inizializzatore di App's o nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app, se non l'hai ancora fatto:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compila ed esegui l'app.

Invia un messaggio di prova

Recupera l'ID di installazione dell'app

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

Il dispositivo di test è determinato da un Firebase ID di installazione fornito dal Firebase servizio di installazioni. 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 Product > Scheme > Edit scheme... (Prodotto > Schema > Modifica schema…) da la barra dei menu in alto.
  2. Apri la scheda Arguments (Argomenti) della finestra di dialogo visualizzata.
  3. Fai clic su + Add items (Aggiungi elementi) in Arguments Passed On Launch (Argomenti passati all'avvio).
  4. Inserisci "-FIRDebugEnabled" nel campo appena creato.
  5. Fai clic su Close (Chiudi), quindi esegui l'app.

Una volta avviata l'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 dispositivo di test

Dopo aver avviato l'app sul dispositivo di test e aver recuperato l'ID di installazione Firebase (FID), puoi provare la configurazione Firebase In-App Messaging inviando un messaggio di test:

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

  2. Avvia il flusso di lavoro 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 Messaggistica in-app.

  3. Inserisci un titolo per il primo messaggio.

  4. Fai clic su Test sul dispositivo.

  5. Inserisci l'ID di installazione di Firebase dell'app nel campo Firebase**Aggiungi un ID di installazione**.

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

  7. Per visualizzare il messaggio sul dispositivo di test, devi chiudere e riaprire l'app sul dispositivo di test.

Per verificare se il dispositivo è un dispositivo di test, cerca il seguente messaggio di log:

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