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

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

Avant que tu commences

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

Ajouter le SDK Firebase In-App Messaging à 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. A partir de votre terminal, installer les dépendances de la nacelle:
    pod install
  4. Ouvrez le projet de votre application dans Xcode:
    open YOUR-PROJECT.xcworkspace

Maintenant, initialisez le SDK dans votre application :

  1. Importer le module Firebase dans votre UIApplicationDelegate , si vous n'êtes pas encore:
    Rapide
    import Firebase
    Objectif c
    @import Firebase;
  2. Configurer également une FirebaseApp instance partagée, généralement dans votre application application:didFinishLaunchingWithOptions: méthode, si vous n'êtes pas encore:
    Rapide
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objectif c
    // Use Firebase library to configure APIs
    [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, 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 votre installation de l' application de test ID, exécutez l'application avec l'argument de commande d'exécution -FIRDebugEnabled :

  1. Avec votre projet Xcode ouvert, sélectionnez Produit> Système> Modifier schéma ... dans la barre de menu en haut.
  2. Ouvrez l'onglet Arguments de la boîte de dialogue qui apparaît.
  3. Cliquez sur + Ajouter des éléments sous Arguments répercutées sur le 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 In-App Messaging .
  2. Cliquez sur Nouvelle campagne.
  3. Entrez un titre pour votre premier message.
  4. Cliquez sur Test sur votre appareil
  5. Entrez l' installation Firebase de votre application ID dans le champ Ajouter un ID d'installation.
  6. Cliquez sur Test pour envoyer le message.

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