Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Premiers pas avec la messagerie intégrée à l'application Firebase

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

Avant que tu commences

Avant de commencer, vous devez configurer quelques éléments dans votre environnement :

  • Une application avec Firebase activé : si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet iOS .
  • Xcode 12.2 ou version ultérieure : la messagerie intégrée à l'application Firebase a besoin d'une version relativement récente de Xcode pour s'exécuter. Vous pouvez trouver la dernière version de Xcode sur le site Xcode d'Apple .
  • CocoaPods 1.4.0 ou supérieur : Firebase In-App Messaging utilise CocoaPods pour gérer les dépendances sur iOS. Vous pouvez l'installer depuis le site CocoaPods .

Ajouter le SDK de messagerie intégrée Firebase à votre projet

Pour commencer, ajoutez les fichiers de framework du SDK de messagerie intégrée Firebase à votre projet en ajoutant les CocoaPods de messagerie intégrée Firebase :

  1. Ouvrez une nouvelle fenêtre de terminal et accédez au répertoire de votre projet Xcode.
  2. Ouvrez votre Podfile et ajoutez les lignes en surbrillance :
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. Depuis votre terminal, installez les dépendances du pod :
    pod install
  4. Ouvrez le projet de votre application dans Xcode :
    open YOUR-PROJECT.xcworkspace
  5. Importez le module Firebase dans votre UIApplicationDelegate , si vous ne l'avez pas encore :
    Rapide
    import Firebase
    Objectif c
    @import Firebase;
  6. Configurez également une instance partagée FirebaseApp , généralement dans la méthode application:didFinishLaunchingWithOptions: votre application, si vous ne l'avez pas encore :
    Rapide
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objectif c
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. 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, la console Firebase vous permet donc de spécifier un périphérique de test qui affiche des messages à la demande.

Ce périphérique de test est déterminé par un ID d'installation Firebase fourni par le service d'installations 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 s'affiche.
  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 que votre application démarre, 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 son ID d'installation Firebase (FID), vous pouvez essayer votre configuration de messagerie Firebase In-App en envoyant un message de test :

  1. Dans la console Firebase, ouvrez la messagerie intégrée à l'application .
  2. Cliquez sur Nouvelle campagne .
  3. Saisissez un titre pour votre premier message.
  4. Cliquez sur Tester sur votre appareil
  5. Saisissez l'ID d'installation Firebase de votre application dans le champ Ajouter un ID d'installation .
  6. Cliquez sur Tester pour envoyer le message.

Firebase In-App Messaging 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.