Premiers pas avec la messagerie dans l'application Firebase

Ce guide de démarrage rapide vous explique comment configurer Firebase In-App Messaging et envoyer votre premier message.


Avant de commencer

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

Ajouter le Firebase In-App Messaging SDK à votre projet

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

  1. Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
  2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Choisissez la bibliothèque In-App Messaging.
  4. Ajoutez l'indicateur -ObjC à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible.
  5. Pour utiliser In-App Messaging, vous devez activer Google Analytics dans votre projet Firebase et ajouter le SDK Firebase pour Google Analytics à votre application. Vous pouvez sélectionner la bibliothèque sans collecte d'IDFA ou avec collecte d'IDFA. Consultez notre FAQ sur la dernière organisation des modules dans le Google Analytics pour SDK Firebase.
  6. Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.

Initialisez maintenant le SDK dans votre application :

  1. Importez le module Firebase dans votre App structure ou UIApplicationDelegate, si ce n'est pas déjà fait :
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Configurez également une instance partagée FirebaseApp, généralement dans l'initialiseur de votre App's ou dans la méthode application(_:didFinishLaunchingWithOptions:) du délégué de votre application, si ce n'est pas déjà fait :
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compilez et exécutez votre application.

Envoyer un message de test

Obtenir l'ID d'installation de votre application

Pour économiser de 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. La Firebase console vous permet donc de spécifier un appareil de test qui affiche les messages à la demande.

Cet appareil de test est déterminé par un Firebase ID d'installation fourni par le Firebase service d'installations. 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. Dans votre projet Xcode ouvert, sélectionnez Product > Scheme > Edit scheme… (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 s'affiche.
  3. Cliquez sur + Add items (Ajouter des éléments) sous Arguments Passed On Launch (Arguments transmis au lancement).
  4. Saisissez "-FIRDebugEnabled" dans le champ nouvellement créé.
  5. Cliquez sur Close (Fermer), puis exécutez votre application.

Une fois votre application en cours d'exécution, 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

Envoyer 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 Firebase ID d'installation (FID), vous pouvez essayer votre Firebase In-App Messaging configuration en envoyant un message de test :

  1. Dans la console Firebase, accédez à DevOps & Engagement > Messaging (DevOps et engagement > Messagerie).

  2. Lancez le workflow pour configurer une nouvelle campagne :

    • S'il s'agit de votre première campagne :

      1. Cliquez sur Create your first campaign (Créer votre première campagne).
      2. Sélectionnez Firebase In-App messages (Messages dans l'application Firebase), puis cliquez sur Create (Créer).

    • Si vous avez déjà créé des campagnes :

      1. Dans l'onglet Campaigns (Campagnes), cliquez sur New campaign (Nouvelle campagne).
      2. Sélectionnez In-App Messaging (Messagerie dans l'application).

  3. Saisissez un Title (Titre) pour votre premier message.

  4. Cliquez sur Test on Device (Tester sur l'appareil).

  5. Saisissez l'ID d'installation Firebase de votre application dans le champ **Add an installation ID** (Ajouter un ID d'installation).Firebase

  6. Cliquez sur Test (Tester) pour envoyer le message. Il sera envoyé immédiatement.

  7. Pour afficher le message sur votre appareil de test, vous devez fermer, puis rouvrir l'application sur cet appareil.

Pour vérifier 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.