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

Si ce n'est pas encore fait, ajoutez Firebase à votre projet Android.

Ajouter le SDK Firebase In-App Messaging à votre projet

Dans le fichier Gradle de votre module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), ajoutez la dépendance pour la bibliothèque In-App Messaging pour Android. Nous vous recommandons d'utiliser Firebase Android BoM pour contrôler le contrôle des versions de la bibliothèque.

Pour utiliser In-App Messaging, vous devez activer Google Analytics dans votre projet Firebase et ajouter le SDK Firebase pour Google Analytics à votre application. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.7.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

En utilisant Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

(Alternative) Ajoutez des dépendances de bibliothèque Firebase sans utiliser BoM.

Si vous choisissez de ne pas utiliser Firebase BoM, vous devez spécifier chaque version de la bibliothèque Firebase dans sa ligne de dépendance.

Notez que si vous utilisez plusieurs bibliothèques Firebase dans votre application, nous vous recommandons vivement d'utiliser BoM pour gérer les versions de la bibliothèque, ce qui garantit que toutes les versions sont compatibles. 

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:21.0.1")
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
 Vous recherchez un module de bibliothèque spécifique à Kotlin ? À partir d'octobre 2023 (Firebase BoM 32.5.0), les développeurs Kotlin et Java peuvent dépendre du module de bibliothèque principal (pour en savoir plus, consultez les questions fréquentes sur cette initiative).

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 console Firebase 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 ID FirebaseInstallations ou FID. Recherchez le FID de votre application de test en consultant le journal Logcat dans Android Studio pour le journal de niveau "Info" suivant:

I/FIAM.Headless: Starting InAppMessaging runtime with 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 ID d'installation (FID) Firebase, vous pouvez tester votre configuration Firebase In-App Messaging en envoyant un message de test:

  1. Dans la console Firebase, ouvrez la page Messaging (Messagerie).
  2. S'il s'agit de votre première campagne, cliquez sur Créer votre 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 Messages dans l'application.
  4. Saisissez un titre pour votre premier message.
  5. Cliquez sur 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 Test. 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:

I/FIAM.Headless: Setting this device as a test device