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 del target.
  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 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 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 Firebase console, vai a DevOps & Engagement > Messaging (Messaggistica).

  2. Avvia il flusso di lavoro per configurare una nuova campagna:

    • Se questa è la tua prima campagna:

      1. Fai clic su Create your first campaign (Crea la tua prima campagna).
      2. Seleziona Firebase In-App messages (Messaggi in-app di Firebase) e fai clic su Create (Crea).

    • Se hai già creato campagne:

      1. Nella scheda Campaigns (Campagne), fai clic su New campaign (Nuova campagna).
      2. Seleziona In-App Messaging (Messaggistica in-app).

  3. Inserisci un Title (Titolo) per il primo messaggio.

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

  5. Inserisci l'ID di installazione di Firebase dell'app nel campo Add an installation ID (Aggiungi un ID di installazione).Firebase

  6. Fai clic su Test (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.