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 déjà fait, ajoutez Firebase à votre projet Android.

Ajouter le Firebase In-App Messaging SDK à 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 la Firebase Android BoM pour contrôler la gestion 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:34.13.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 les Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

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:22.0.3")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

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 FirebaseInstallations ID, ou FID. Pour trouver le FID de votre application de test, consultez le 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 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 :

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