La configuration à distance en temps réel vous permet de recevoir des clés et des valeurs de paramètres mises à jour dès qu'elles sont publiées sur le serveur. Cela vous permet de mettre à jour rapidement tout type d'attribut d'application contrôlé à l'aide d'une valeur de paramètre de configuration à distance. Grâce aux mises à jour de Remote Config en temps réel, vous pouvez :
- Réduisez les risques en déployant progressivement des fonctionnalités pour les utilisateurs ciblés et en effectuant une restauration d'urgence si nécessaire.
- Augmentez l'engagement des utilisateurs en personnalisant rapidement les expériences des utilisateurs lorsqu'ils utilisent l'application. Par exemple, vous pouvez mettre à jour les bannières et offrir des incitations aux utilisateurs qui correspondent à des propriétés utilisateur Google Analytics spécifiques ou ajuster dynamiquement la difficulté du jeu pour des cohortes de joueurs.
- Réduisez les dépendances de construction et augmentez la productivité des développeurs : utilisez les paramètres de configuration à distance comme indicateurs de fonctionnalité pour exposer les fonctionnalités à vos équipes de développement et de test, tout en les gardant cachées aux utilisateurs en production.
Pour en savoir plus sur les façons d'utiliser Remote Config, consultez Que pouvez-vous faire avec Remote Config ?
Dans ce guide, vous allez :
- En savoir plus sur la relation client-serveur qui prend en charge les mises à jour en temps réel.
- Comprendre comment fonctionne la fonctionnalité en temps réel du SDK.
- Découvrez comment utiliser les mises à jour en temps réel pour maintenir à jour la configuration de votre application.
La connexion client-serveur en temps réel
Lorsque vous implémentez la configuration à distance en temps réel dans votre application, vous créez un écouteur en temps réel qui ouvre une connexion HTTP au backend de la configuration à distance. La demande inclut la version de configuration actuellement mise en cache sur l'appareil. Le serveur de configuration à distance en temps réel utilise un message d'invalidation pour signaler à l'application lorsqu'une version plus récente d'une configuration côté serveur doit être récupérée.
Si le serveur dispose d'une version plus récente, il envoie immédiatement le signal d'invalidation. S'il n'a pas de version plus récente, il garde la connexion ouverte et attend qu'une version soit publiée sur le serveur. Lorsque le SDK client reçoit un signal d'invalidation, il le récupère automatiquement, puis appelle le rappel de l'écouteur enregistré lorsque vous avez ouvert la connexion de l'écouteur. Cette récupération est similaire à l'appel de récupération que vous pouvez effectuer avec le SDK, mais ignore toute mise en cache ou paramètre minimumFetchInterval . La connexion client-serveur est maintenue pendant que l'application est au premier plan.
Étant donné que la connexion client-serveur est établie via HTTP, elle ne nécessite aucune dépendance vis-à-vis d'autres bibliothèques.
Écoutez les mises à jour
Les mises à jour en temps réel complètent les appels fetch de Remote Config. Nous vous recommandons d'appeler fetch au démarrage de votre application (ou parfois pendant le cycle de vie de votre application) et d'écouter les mises à jour de Remote Config en temps réel pendant la session utilisateur pour vous assurer que vous disposez des dernières valeurs dès qu'elles sont publiées sur le serveur.
Pour écouter les mises à jour, appelezaddOnConfigUpdateListener ,implémentant un rappel qui est appelé chaque fois qu'une mise à jour de Remote Config est disponible dans l'application . Dans les coulisses, cet appel commence à écouter les mises à jour du serveur Remote Config. Pour en savoir plus sur la relation client-serveur, consultez la section précédente .
Le rappel est souvent un bon endroit pour utiliser activate pour rendre les paramètres de configuration mis à jour disponibles pour votre application. Consultez Stratégies de chargement de Firebase Remote Config pour des stratégies supplémentaires permettant d'activer les valeurs de paramètre lorsque vous utilisez la configuration à distance en temps réel.
Activer sélectivement les valeurs des paramètres
Lorsque vous appelezaddOnConfigUpdateListener ,vous pouvez attendre le changement et l'activer.
onUpdate est appelé lorsqu'une nouvelle version du modèle a été récupérée automatiquement et lorsque cette nouvelle version a modifié les valeurs de paramètre actuellement activées dans l'application. Ces rappels sont invoqués avec un paramètre configUpdate . configUpdate contientupdatedKeys ,qui est l'ensemble des clés de paramètre modifiées qui ont lancé la mise à jour en temps réel et comprend les éléments suivants :
- Touches de paramètre ajoutées ou supprimées
- Touches de paramètres dont les valeurs ont changé
- Clés de paramètre dont les métadonnées ont changé (par exemple, les informations de personnalisation de Remote Config)
- Clés de paramètre dont la source de valeur a changé (par exemple, une valeur par défaut dans l'application mise à jour vers une valeur côté serveur)
Si vous utilisez un écouteur en temps réel dans une vue particulière de votre application, vous pouvez vérifier si les paramètres pertinents pour cette vue ont changé avant de l'activer.
Parfois, une récupération (soit lancée lorsque vous appelez la méthode fetch , soit par la configuration à distance en temps réel) n'entraîne pas de mise à jour pour le client. Dans ces cas, la méthode ou la complétiononUpdatene sera pas appelée.
Ajouter et supprimer des écouteurs
addOnConfigUpdateListenerest le principal point d'entrée pour la configuration à distance en temps réel. Appeler cet écouteur pour la première fois dans le cycle de vie de votre application ouvre la connexion au backend. Les appels suivants réutilisent la même connexion, multiplexant le message d'invalidation décrit dans la connexion client-serveur en temps réel .L'appel renvoie un "enregistrement d'écouteur", qui a une méthode appeléeremove . Pour arrêter l'écoute, mémorisez la référence à l'enregistrement de l'auditeur. Appelez remove pour arrêter l'écoute à cet enregistrement. S'il s'agit du seul écouteur enregistré, l'appel remove ferme la connexion en temps réel au serveur.
Prochaines étapes
Consultez Premiers pas avec Firebase Remote Config pour configurer Remote Config et commencer à écouter les mises à jour en temps réel .