Premiers pas avec la messagerie Firebase dans l'application

Ce démarrage rapide vous montre comment configurer la messagerie Firebase In-App et envoyer votre premier message.

Avant que tu commences

Avant de commencer, assurez-vous d' ajouter Firebase à votre projet Apple .

Ajoutez le SDK de messagerie Firebase In-App à votre projet

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

  1. Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages .
  2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Apple Firebase :
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Choisissez la bibliothèque de messagerie intégrée à l'application.
  5. Ajoutez l'indicateur -ObjC à la section Autres indicateurs de l'éditeur de liens des paramètres de construction de votre cible.
  6. Pour utiliser la messagerie intégrée à l'application, vous devez activer Google Analytics dans votre projet Firebase et ajouter le SDK Firebase pour Google Analytics à votre application. Vous pouvez sélectionner soit la bibliothèque sans collection IDFA, soit avec la collection IDFA.
  7. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Maintenant, initialisez le SDK dans votre application :

  1. Importez le module Firebase dans votre structure App ou UIApplicationDelegate , si vous ne l'avez pas encore fait :
    Rapide
    import Firebase
    Objectif c
    @import Firebase;
  2. Configurez également une instance partagée FirebaseApp , généralement dans l'initialiseur de votre App ou dans la méthode application application(_:didFinishLaunchingWithOptions:) de votre délégué d'application, si vous ne l'avez pas encore fait :
    Rapide
    FirebaseApp.configure()
    Objectif c
    [FIRApp configure];
  3. Compilez et exécutez votre application.

Envoyer un message test

Obtenez l'ID d'installation de votre application

Pour économiser l'énergie, Firebase In-App Messaging ne récupère les messages du serveur qu'une fois par jour. Cela peut rendre les tests difficiles, c'est pourquoi la console Firebase vous permet de spécifier un appareil de test qui affiche les messages à la demande.

Cet appareil de test est déterminé par un ID d'installation Firebase fourni par le service d'installation Firebase. Pour trouver l'ID d'installation de votre application de test, exécutez l'application avec l'argument de commande d'exécution -FIRDebugEnabled :

  1. Avec votre projet Xcode ouvert, sélectionnez Produit > Schéma > Modifier le schéma... dans la barre de menu supérieure.
  2. Ouvrez l'onglet Arguments de la boîte de dialogue qui apparaît.
  3. Cliquez sur + Ajouter des éléments sous Arguments transmis au lancement .
  4. Entrez "-FIRDebugEnabled" dans le champ nouvellement créé.
  5. Cliquez sur Fermer , puis exécutez votre application.

Une fois votre application lancée, recherchez la ligne suivante dans les journaux de la console Xcode :

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Envoyez un message à votre appareil de test

Une fois que vous avez lancé votre application sur l'appareil de test et que vous disposez de son ID d'installation Firebase (FID), vous pouvez tester votre configuration de messagerie Firebase In-App en envoyant un message de test :

  1. Dans la console Firebase, ouvrez la page Messagerie .
  2. S'il s'agit de votre première campagne, cliquez sur Créer votre première campagne .
    1. Sélectionnez Messages Firebase In-App et cliquez sur Créer .
  3. Sinon, sous l'onglet Campagnes , cliquez sur Nouvelle campagne .
    1. Sélectionnez Messagerie intégrée à l'application .
  4. Saisissez un titre pour votre premier message.
  5. Cliquez sur Test sur l'appareil
  6. Saisissez l'ID d'installation Firebase de votre application dans le champ Ajouter un ID d'installation .
  7. Cliquez sur Test pour envoyer le message.

La messagerie Firebase In-App envoie votre message de test dès que vous cliquez sur Test . Pour voir le message, vous devez fermer, puis rouvrir l'application sur votre appareil de test.

Pour confirmer si votre appareil est un appareil de test, recherchez le message de journal suivant :

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