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, veillez à ajouter Firebase à votre projet Apple.

Ajouter le SDK Firebase In-App Messaging à votre projet

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

  1. Dans Xcode, ouvrez le projet de votre application, puis accédez à File > 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 ajoutez le SDK Firebase pour Google Analytics à votre application. Vous pouvez sélectionner soit la bibliothèque sans collecte IDFA, soit avec collecte IDFA.
  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 struct App ou UIApplicationDelegate, si vous ne l'avez pas déjà fait :
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Configurer également un élément FirebaseApp instance partagée, généralement dans l'initialiseur de votre App ou dans celui de votre délégué application(_:didFinishLaunchingWithOptions:), 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 que les messages du une fois par jour. Cela peut compliquer les tests. 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 de Firebase. Pour trouver l'ID d'installation de votre application de test, exécutez-la avec l'argument de commande d'exécution -FIRDebugEnabled :

  1. Une fois votre projet Xcode ouvert, sélectionnez Product > Schéma > Modifier le schéma... depuis la barre de menu supérieure.
  2. Ouvrez l'onglet Arguments dans la boîte de dialogue qui s'affiche.
  3. Cliquez sur + Ajouter des éléments sous Arguments transmis au lancement.
  4. Saisissez "-FIRDebugEnabled" dans le champ que vous venez de créer.
  5. Cliquez sur Close (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

Envoyer un message à votre appareil de test

Une fois que vous avez lancé votre application sur l'appareil de test et que vous avez ID d'installation (FID) de Firebase, vous pouvez essayer votre Firebase In-App Messaging 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 ma première campagne.
    1. Sélectionnez Messages dans l'application Firebase, puis cliquez sur Créer.
  3. Sinon, dans l'onglet Campagnes, cliquez sur Nouvelle campagne.
    1. Sélectionnez Messagerie dans l'application.
  4. Saisissez un titre pour votre premier message.
  5. Cliquez sur Test on Device (Tester sur l'appareil).
  6. Saisissez l'ID d'installation Firebase de votre application dans le Champ Ajouter un ID d'installation.
  7. Cliquez sur Tester pour envoyer le message.

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

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.