Mise à jour utilisateur

Le composant Mise à jour utilisateur vous permet de mettre à jour les attributs, événements et achats d’un utilisateur dans un éditeur JSON, sans avoir besoin d’inclure des informations sensibles comme les clés API.

Fonctionnement de ce composant

Lorsque vous utilisez ce composant dans votre Canvas, les mises à jour ne sont pas comptabilisées dans la limite de débit de vos requêtes /users/track par minute. Ces mises à jour sont regroupées par lots afin que Braze puisse les traiter plus efficacement qu’un webhook Braze-vers-Braze. Notez que ce composant ne consomme pas de points de donnée lorsqu’il est utilisé pour mettre à jour des points de donnée non facturables (comme les groupes d’abonnement).

Une fois que les utilisateurs entrent dans l’étape Mise à jour utilisateur et que le traitement est terminé, ils passent à l’étape suivante. Cela signifie que tout message ultérieur qui dépend de ces mises à jour utilisateur est à jour lorsque l’étape suivante est exécutée.

Créer une mise à jour utilisateur

Glissez-déposez le composant depuis la barre latérale, ou sélectionnez le bouton plus en bas de la variante ou de l’étape, puis sélectionnez Mise à jour utilisateur.

Trois options vous permettent de mettre à jour les informations existantes du profil utilisateur, d’ajouter de nouvelles informations ou de supprimer des informations du profil utilisateur. Au total, les étapes Mise à jour utilisateur d’un espace de travail peuvent mettre à jour jusqu’à 200 000 profils utilisateur par minute.

Conseil

Vous pouvez également tester les modifications apportées par ce composant en recherchant un utilisateur et en lui appliquant la modification. Cela mettra à jour l’utilisateur.

Mettre à jour des attributs personnalisés

Pour mettre à jour ou supprimer un attribut personnalisé, sélectionnez un nom d’attribut dans votre liste d’attributs et saisissez la valeur.

Supprimer des attributs personnalisés

Pour supprimer un attribut personnalisé, sélectionnez un nom d’attribut à l’aide du menu déroulant. Vous pouvez passer à l’éditeur JSON avancé pour effectuer des modifications supplémentaires.

Augmenter et diminuer des valeurs

L’étape Mise à jour utilisateur peut augmenter ou diminuer la valeur d’un attribut. Sélectionnez l’attribut, choisissez Increment By ou Decrement By, puis saisissez un nombre.

Suivre la progression hebdomadaire

En incrémentant un attribut personnalisé qui suit un événement, vous pouvez suivre le nombre de cours qu’un utilisateur a suivis au cours d’une semaine. Grâce à ce composant, le compteur de cours peut être réinitialisé au début de la semaine et recommencer le suivi.

Mettre à jour un tableau d’objets

Un tableau d’objets est un attribut personnalisé riche en données, stocké dans le profil d’un utilisateur. Vous pouvez l’utiliser pour créer un historique des interactions de l’utilisateur avec votre marque et pour créer des segments basés sur un champ calculé, comme l’historique des achats ou la valeur vie client totale.

En utilisant l’option Advanced JSON Editor, vous pouvez insérer du JSON pour ajouter ou supprimer des éléments de ce tableau d’objets.

Cas d’utilisation : mettre à jour la liste de souhaits d’un utilisateur

Suivez la liste de souhaits d’un utilisateur afin de segmenter ou personnaliser en fonction de ses articles enregistrés.

1. Créez un attribut personnalisé de type tableau d’objets, par exemple wishlist. Chaque objet peut inclure des champs tels que product_id, product_name et added_at.
2. Dans l’étape Mise à jour utilisateur, sélectionnez Advanced JSON Editor. Ensuite, dans la section Rédiger, utilisez l’opération $add pour ajouter un élément ou l’opération $remove pour supprimer un élément par valeur.

Voici un exemple d’ajout d’un élément à la liste de souhaits :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "attributes": [
    {
      "wishlist": {
        "$add": [
          {
            "product_id": "SKU-123",
            "product_name": "Wireless Headphones",
            "added_at": "{{$isoTimestamp}}"
          }
        ]
      }
    }
  ]
}

Pour supprimer un élément, utilisez "wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] } avec la même structure d’objet afin que Braze puisse le trouver et le supprimer.

Cas d’utilisation : calculer le total du panier d’achat

Suivez quand un utilisateur a des articles dans son panier, quand il ajoute ou supprime des articles, et quel est le montant total du panier.

1. Créez un tableau d’objets personnalisé appelé shopping_cart. L’exemple suivant montre à quoi cet attribut peut ressembler. Chaque article possède un product_id unique avec des données supplémentaires dans son propre tableau d’objets imbriqué, y compris price.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": number,
         "shipping": number,
         "items_in_cart": number,
         "product_id": array,
         "gift": boolean,
         "discount_code": "enum",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

2. Créez un événement personnalisé nommé add_item_to_cart qui est enregistré lorsqu’un utilisateur ajoute un article au panier.
3. Créez un Canvas qui cible les utilisateurs effectuant cet événement personnalisé. Désormais, lorsqu’un utilisateur ajoute un article à son panier, ce Canvas est déclenché. Vous pouvez ensuite envoyer des messages directement à cet utilisateur, en lui proposant des codes de réduction lorsqu’il atteint un certain montant, qu’il abandonne son panier pendant un certain temps, ou tout autre scénario correspondant à votre cas d’utilisation.

L’attribut shopping_cart contient le cumul de nombreux événements personnalisés : le coût total de tous les articles, le nombre total d’articles dans le panier, si le panier contient un cadeau, etc. Cela peut ressembler à ce qui suit :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "attributes": [
    {
      "shopping_cart": [
       {
         "total_cart_value": 22.99,
         "shipping": 4.99,
         "items_in_cart": 2,
         "product_id": ["1001", "1002"],
         "gift": true,
         "discount_code": "flashsale1000",
         "timestamp": {"$time" : "{{$isoTimestamp}}"},
       }
      ]
    }
  ]
}

Définir une propriété d’entrée Canvas comme attribut

Vous pouvez utiliser l’étape Mise à jour utilisateur pour conserver une canvas_entry_property. Imaginons que vous ayez un événement qui se déclenche lorsqu’un article est ajouté au panier. Vous pouvez stocker l’ID de l’article le plus récemment ajouté au panier et l’utiliser pour une campagne de remarketing. Utilisez la fonctionnalité de personnalisation pour récupérer une propriété d’entrée Canvas et la stocker dans un attribut.

Personnalisation

Pour stocker la propriété de l’événement déclencheur d’un Canvas en tant qu’attribut, utilisez la fenêtre modale de personnalisation pour extraire et stocker la propriété d’entrée Canvas. L’étape Mise à jour utilisateur prend également en charge les fonctionnalités de personnalisation suivantes :

• Contenu connecté
• Blocs de contenu
• Propriétés d’entrée
• Logique Liquid (y compris l’abandon de messages)
• Mises à jour multiples d’attributs ou d’événements par objet

Avertissement

Nous recommandons d’utiliser avec précaution la personnalisation Liquid avec Contenu connecté dans les étapes Mise à jour utilisateur, car ce type d’étape a une limite de débit de 200 000 requêtes par minute. Cette limite de débit remplace la limite de débit du Canvas.

Éditeur JSON avancé

Ajoutez un objet JSON d’attribut, d’événement ou d’achat jusqu’à 65 536 caractères dans l’éditeur JSON. L’abonnement global d’un utilisateur et l’état de son groupe d’abonnement peuvent également être définis.

Grâce à l’éditeur JSON, vous pouvez également prévisualiser et tester que le profil utilisateur est bien mis à jour avec vos modifications dans l’onglet Preview and test. Vous pouvez sélectionner un utilisateur aléatoire ou rechercher un utilisateur spécifique. Ensuite, après avoir envoyé un test à un utilisateur, consultez le profil utilisateur à l’aide du lien généré.

Points à prendre en compte

Vous n’avez pas besoin d’inclure de données sensibles comme votre clé API lorsque vous utilisez l’éditeur JSON, car celle-ci est automatiquement fournie par la plateforme. Les champs suivants ne doivent pas être inclus dans l’éditeur JSON :

• ID utilisateur externe
• Clé API
• URL du cluster Braze
• Champs liés aux imports de jetons de notification push

Important

Les propriétés Canvas (telles que les étiquettes Liquid canvas_id, canvas_name et canvas_variant_name) ne sont pas prises en charge dans les étapes Mise à jour utilisateur.

Enregistrer des événements personnalisés

Grâce à l’éditeur JSON, vous pouvez également enregistrer des événements personnalisés. Notez que cela nécessite un horodatage au format ISO, il est donc nécessaire d’assigner une date et une heure avec Liquid au début. Prenons cet exemple qui enregistre un événement avec un horodatage.

1
2
3
4
5
6
7
8
9
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "name": "logged_user_event",
      "time": "{{timestamp}}"
    }
  ]
}

L’exemple suivant associe un événement à une application spécifique en utilisant un événement personnalisé avec des propriétés facultatives et l’app_id.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{% assign timestamp = 'now' | date: "%Y-%m-%dT%H:%M:%SZ" %}
{
  "events": [
    {
      "app_id": "insert_app_id",
      "name": "rented_movie",
      "time": "{{timestamp}}",
      "properties": {
        "release": {
          "studio": "FilmStudio",
          "year": "2022"
        },
        "cast": [
          {
            "name": "Actor1"
          },
          {
            "name": "Actor2"
          }
        ]
      }
    }
  ]
}

Modifier l’état d’abonnement

Dans l’éditeur JSON, vous pouvez également modifier l’état d’abonnement d’un utilisateur. Par exemple, l’exemple suivant montre l’état d’abonnement d’un utilisateur mis à jour à opted_in.

1
2
3
4
5
6
7
{
  "attributes": [
    {
      "email_subscribe": "opted_in"
    }
  ]
}

Mettre à jour les groupes d’abonnement

Vous pouvez également mettre à jour les groupes d’abonnement à l’aide de cette étape du canvas. L’exemple suivant montre comment mettre à jour un ou plusieurs groupes d’abonnement.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "attributes": [
    {
      "subscription_groups": [
        {
          "subscription_group_id": "subscription_group_identifier_1",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_2",
          "subscription_state": "subscribed"
        },
        {
          "subscription_group_id": "subscription_group_identifier_3",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}