Skip to content

Paires clé-valeur

Cette page explique comment utiliser des paires clé-valeur pour envoyer des données supplémentaires aux appareils des utilisateurs. Cette fonctionnalité est disponible sur les canaux d’envoi de messages push, in-app, e-mail et carte de contenu.

Utilisez des paires clé-valeur pour ajouter des métadonnées structurées aux messages. Ces données supplémentaires peuvent enrichir les messages avec des informations contextuelles supplémentaires qui peuvent influencer le rendu ou le traitement d’un message.

Les paires clé-valeur étant des métadonnées, ces données ne sont pas nécessairement visibles par le destinataire, mais peuvent être utilisées par vos systèmes ou processus connectés pour personnaliser l’envoi des messages.

Chaque paire est composée de

  • Clé : L’identifiant (exemple : utm_source)
  • Valeur : Les données associées (exemple : newsletter)

Cas d’utilisation

Voici quelques exemples de cas d’utilisation pour l’ajout de métadonnées avec des paires clé-valeur :

  1. Paramètres de suivi : Attacher des paramètres UTM à des fins d’analyse/analytique (si utilisé comme adjectif)
    • Clé : utm_campaign
    • Valeur : spring_sale
  2. Tags personnalisés : Ajout de tags pour le routage ou la catégorisation interne
    • Clé : priority
    • Valeur : high
  3. Déclencheurs de comportement : Métadonnées utilisées pour déclencher ou personnaliser des comportements in-app.
    • Clé : deep_link
    • Valeur : app://promo-page

Notifications push

Les paires clé-valeur peuvent être ajoutées aux notifications push Android, iOS et web. Vous pourriez utiliser des paires clé-valeur pour mettre à jour les indicateurs internes et le contenu de l’app ou personnaliser les propriétés des notifications push, telles que la priorisation des alertes, la localisation et les sons.

Dans le compositeur de messages, sélectionnez l’onglet Paramètres, puis Ajouter une nouvelle paire et spécifiez vos paires clé-valeur.

iOS

Le service Apple Push Notification (APN) permet de définir des préférences en matière d’alertes et d’envoyer des données personnalisées à l’aide de paires clé-valeur. APN utilise la bibliothèque aps réservée à Apple, qui comprend des clés et des valeurs prédéterminées régissant les propriétés des alertes.

Bibliothèque de l’APS
Bibliothèque des propriétés d’alerte

Le compositeur de messages de Braze gère automatiquement la création des clés suivantes : alerte et ses propriétés, contenu disponible, son et catégorie.

Ces valeurs peuvent être saisies dans l’onglet Paramètres lorsque vous créez un message push. Sélectionnez Options d’alerte et choisissez une clé du dictionnaire d’alerte pour que la clé soit automatiquement remplie dans une nouvelle entrée clé-valeur.

!

Lorsque Braze envoie une notification push aux APN, la charge utile sera formatée sous forme de JSON.

Charge utile simple

1
2
3

{
    "aps" : { "alert" : "Message received from Spencer" },
}

Charge utile complexe

1
2
3
4
5
6
7
8
9
10
11
12

{
    "aps" : {
        "alert" : {
            "body" : "Hi, welcome to our app!",
            "loc-key" : "France",
            "loc-args" : ["Bonjour", "bienvenue"],
            "action-loc-key" : "Button_Type_1",
            "launch-image" : "Paris"
      },
        "content-available" : 1
    },
}
Paires clé-valeur personnalisées

Outre les valeurs de la charge utile de la bibliothèque aps, vous pouvez envoyer des paires clé-valeur personnalisées à l’appareil d’un utilisateur. Les valeurs de ces paires sont limitées aux types primitifs : dictionnaire (objet), tableau d’objets, chaîne de caractères, nombre et booléen.

!

Les cas d’utilisation des paires clé-valeur personnalisées comprennent, sans s’y limiter, la conservation des indicateurs internes et la définition du contexte de l’interface utilisateur. Braze vous permet d’envoyer des paires clé-valeur supplémentaires accompagnées d’une notification push à utiliser via votre application au sein de la clé extras. Si vous préférez utiliser une autre clé, confirmez que votre application peut gérer cette clé personnalisée.

Apple conseille à ses clients d’éviter d’inclure des informations sur les clients ou toute donnée sensible dans les données utiles personnalisées. En outre, Apple recommande que toute action associée à un message d’alerte ne supprime pas les données d’un appareil.

Campagnes déclenchées par l’API

Braze vous permet d’envoyer des paires clé-valeur de chaînes de caractères personnalisées, appelées extras. Pour accéder à vos extras dans les campagnes déclenchées par l’API et les campagnes planifiées déclenchées par l’API, dans le tableau de bord, définissez une clé comme “example_key”, et une valeur comme "$json:{"foo": 1, "bar": 1}". La console de développement affichera alors le message suivant "extras": { "test": { "foo": 1, "bar": 1 }

Android

Braze vous permet d’envoyer des données supplémentaires dans les notifications push à l’aide de paires clé-valeur.

Données

De manière similaire à iOS push, vous pouvez envoyer des paires clé-valeur personnalisées à l’appareil d’un utilisateur.

Les paires clé-valeur personnalisées sont notamment utilisées pour la conservation des indicateurs internes et la définition du contexte de l’interface utilisateur, mais elles peuvent être utilisées à n’importe quelle fin.

Campagnes déclenchées par l’API

Braze vous permet d’envoyer des paires clé-valeur de chaînes de caractères personnalisées, appelées extras. Pour accéder à vos extras dans les campagnes déclenchées par l’API et les campagnes planifiées déclenchées par l’API, dans le tableau de bord, définissez une clé comme “example_key”, et une valeur comme "$json:{"foo": 1, "bar": 1}". La console de développement affichera alors "extras": { "test": { "foo": 1, "bar": 1 }.

Options d’envoi de messages du FCM

Les notifications push Android peuvent être encore plus personnalisées grâce aux options d’envoi de messages du FCM. Il s’agit notamment de la priorité de notification, du son, du délai, de la durée de vie et de la possibilité de s’effondrer. Ces valeurs peuvent être spécifiées dans l’onglet Paramètres lors de la création d’un message push. Reportez-vous à la section Paramètres avancés de notification push pour plus d’instructions sur la manière de définir ces options dans le compositeur de messages de Braze.

!

Notifications push silencieuses

Une notification push silencieuse est une notification push ne contenant ni message d’alerte ni son, utilisée pour mettre à jour l’interface ou le contenu de votre app en arrière-plan. Ces notifications utilisent des paires clé-valeur pour déclencher les actions de l’application en arrière-plan. Les notifications push silencieuses permettent également de suivre les désinstallations.

Les marketeurs doivent tester que les notifications push silencieuses déclenchent le comportement attendu avant de les envoyer aux utilisateurs de leur appli. Après avoir composé votre notification push silencieuse iOS ou Android, assurez-vous de ne cibler qu’un utilisateur test en filtrant sur l’ID externe ou l’adresse e-mail.

Lors du lancement de la campagne, vous devez vérifier que vous n’avez pas reçu de notification push visible sur votre appareil de test.

Messages in-app

Pour ajouter une paire clé-valeur à un message in-app, sélectionnez l’onglet Paramètres dans le compositeur de messages, sélectionnez Ajouter une nouvelle paire et spécifiez vos paires clé-valeur.

!

Campagnes déclenchées par l’API

Braze vous permet d’envoyer des paires clé-valeur de chaînes de caractères personnalisées, appelées extras. Pour accéder à vos extras dans les campagnes déclenchées par l’API et les campagnes planifiées déclenchées par l’API, dans le tableau de bord, définissez une clé comme “example_key”, et une valeur comme "$json:{"foo": 1, "bar": 1}". La console de développement affichera alors "extras": { "test": { "foo": 1, "bar": 1 }.

E-mails

SparkPost et SendGrid prennent tous deux en charge les paires clé-valeur dans les e-mails. Si vous utilisez Sendgrid, les paires clé-valeur seront envoyées en tant qu’arguments uniques. SendGrid vous permet de joindre un nombre illimité de paires clé-valeur jusqu’à 10 000 octets de données. Ces paires clé-valeur sont visibles dans les messages du Webhook d’événement SendGrid.

!onglet Infos d’envoi du compositeur de messages e-mail dans Braze.](/docs/fr/assets/img_archive/keyvalue_email.png?af271ea39c591baa641a4d28096aa956)

Cartes de contenu

Pour ajouter une paire clé-valeur à une carte de contenu, accédez à l’onglet Paramètres du compositeur de messages de Braze et sélectionnez Ajouter une nouvelle paire.

!Ajouter une paire clé-valeur à la carte de contenu
Github   Modifier cette page sur GitHub
New Stuff!