Comprendre les paires clé-valeur
Objectif de cet article
Découvrez ce que sont les paires clé-valeur et comment les utiliser avec des notifications push standard et silencieuses. Les paires clé-valeur sont des données personnalisées incluses avec les notifications push qui vous permettent de déclencher des comportements dans l’application, d’ajouter un tag aux messages, de personnaliser les notifications, et plus encore.
Que sont les paires clé-valeur ?
Les paires clé-valeur sont des données personnalisées qui peuvent être incluses avec les notifications push, à la fois standard (celles qui s’affichent aux utilisateurs) et silencieuses (celles qui sont invisibles pour les utilisateurs).
Avec les notifications silencieuses et standard, elles peuvent être utilisées pour mettre à jour le contenu de l’application, déclencher des tâches en arrière-plan ou ajouter un tag aux messages à des fins de reporting.
Avec les notifications push standard, ils peuvent également être utilisés pour créer et renseigner des modèles de push personnalisés.
Comment utiliser des paires clé-valeur
Pour utiliser des paires clé-valeur, votre application doit être configurée pour reconnaître les clés et répondre à leurs valeurs ; veillez donc à travailler avec votre développeur d’application afin de vous assurer que votre application est conçue pour prendre en charge vos cas d’utilisation. En outre, assurez-vous d’avoir configuré les notifications push dans votre compte Klaviyo.
Vous pouvez les trouver dans l’onglet Comportements lors de la création d’une notification push. Pour les utiliser, activez Données personnalisées, puis ajoutez des clés et des valeurs. Vous pouvez ajouter jusqu’à 10 paires clé-valeur par notification push.
Examinons un exemple pour une application e-commerce :
- Nous souhaitons mettre à jour les points de récompense d’un client affichés dans notre application après qu’il a effectué un achat en ligne. Nous le ferons en envoyant une notification push silencieuse avec une propriété de profil de points de récompense sous forme de paire clé-valeur.
- Nous avons déjà un flux de remerciement Thank you déclenché par un événement Placed Order. Nous ajoutons une notification push silencieuse à la fin de ce flux afin de mettre à jour la valeur des points de récompense affichée dans notre application.
- La notification push silencieuse inclut une paire clé-valeur où la Key est égale à rewardspoints et où la Value est définie sur {{ person.rewardspoints }}. Le nom de la propriété de profil Klaviyo dans laquelle nous stockons ces points s’appelle rewardspoints, et notre application est correctement configurée pour se mettre à jour en fonction de cette paire clé-valeur.
- Dans cet exemple, nous nous sommes assurés que la valeur rewardspoints a été mise à jour dans Klaviyo avant d’être envoyée à notre application via ce flux, afin qu’elle reflète correctement la réalité.
Cas d’utilisation
Il existe de nombreux cas d’utilisation pour les paires clé-valeur, notamment pour :
- Personnaliser le contenu de l’application
Vous pouvez envoyer une notification push silencieuse pour personnaliser le contenu de l’application en fonction des attributs du destinataire (comme dans l’exemple de points de fidélité ci-dessus). - Créer des tags pour le reporting
Vous pouvez inclure des paires clé-valeur dans les notification push (standard ou silencieuses) pour « taguer » des messages, puis extraire des données pour tous les messages comportant des tags spécifiques afin d’agréger les résultats. Par exemple, ces tags pourraient être des paramètres UTM. - Créer des modèles de push personnalisés
Vous pouvez définir la taille et la couleur de police du corps de votre notification push ou configurer un son personnalisé qui sera diffusé lorsque la notification push sera livrée. Les comptes peuvent également afficher des données en temps réel, comme l’emplacement d’une livraison ou un compte à rebours jusqu’à l’expiration d’une offre, dans leur notification.
Nous vous recommandons de travailler avec votre développeur d’applications afin de créer une prise en charge adaptée à vos cas d’utilisation spécifiques.