Mise à jour utilisateur

Le composant Mise à jour utilisateur vous permet de mettre à jour les attributs, les événements et les achats d’un utilisateur dans un éditeur JSON. Il n’est donc pas nécessaire d’inclure des informations sensibles telles que les clés API.

Fonctionnement de ce composant

Lorsque vous utilisez ce composant dans votre Canvas, les mises à jour ne sont pas prises en compte dans votre limite de débit de /users/track requêtes par minute. Au lieu de cela, les mises à jour sont regroupées pour que Braze puisse les traiter plus efficacement qu’un webhook Braze-à-Braze. Veuillez noter que ce composant n’enregistre pas les points de données lorsqu’il est utilisé pour mettre à jour des points de données non facturables (tels que les groupes d’abonnement).

Une fois que les utilisateurs ont accédé à l’étape de mise à jour utilisateur et que le traitement est terminé, ils effectuent l’avancement vers l’étape suivante. Cela signifie que tous les envois de messages ultérieurs qui s’appuient sur ces mises à jour utilisateur sont à jour lorsque l’étape suivante est exécutée.

Création d’une mise à jour de l’utilisateur

Veuillez glisser-déposer le composant depuis la barre latérale ou sélectionner le bouton « + » situé en bas de la variante ou de l’étape, puis sélectionner « 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. Toutes combinées, les étapes de mise à jour des utilisateurs dans un espace de travail peuvent mettre à jour jusqu’à 200 000 profils utilisateurs par minute.

Mise à jour des attributs personnalisés

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

Suppression des attributs personnalisés

Pour supprimer un attribut personnalisé, sélectionnez un nom d’attribut à l’aide de la liste déroulante. Vous pouvez passer à l’éditeur JSON avancé pour modifier.

Valeurs croissantes et décroissantes

L’étape Mise à jour utilisateur permet d’augmenter ou de diminuer la valeur d’un attribut. Sélectionnez l’attribut, sélectionnez Incrémenter par ou Décrémenter par et entrez un nombre.

Suivi des progrès hebdomadaires

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

Mise à jour d’un tableau d’objets

Un tableau d’objets est un attribut personnalisé riche en données stocké dans le profil 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é, tel que l’historique des achats ou la valeur vie client.

Grâce à l’option Éditeur JSON avancé, vous pouvez insérer du JSON pour ajouter ou supprimer des éléments de ce tableau d’objets.

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

Suivez la liste de souhaits d’un utilisateur afin de pouvoir réaliser une segmentation ou une personnalisation en fonction des articles qu’il a enregistrés.

1. Veuillez créer un attribut personnalisé qui est un tableau d’objets, par exemplewishlist. Chaque objet peut inclure des champs tels que product_id,product_name , et added_at.
2. Dans l’étape Mise à jour utilisateur, veuillez sélectionner Éditeur JSON avancé. Ensuite, dans la section Compose, veuillez utiliser $addl’opération pour ajouter un élément ou $removel’opération pour supprimer un élément par valeur.

Voici un exemple d’ajout d’un article à 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, veuillez"wishlist": { "$remove": [ { "product_id": "SKU-123", ... } ] }utiliser 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

Déterminez quand un utilisateur a des articles dans son panier, quand il en ajoute de nouveaux ou en supprime, et quelle est la valeur totale du panier.

1. Veuillez créer un tableau personnalisé d’objets appelé shopping_cart. L’exemple suivant montre à quoi peut ressembler cet attribut. Chaque élément possède un identifiant uniqueproduct_idqui contient des données supplémentaires dans son propre tableau imbriqué d’objets, 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 qui effectuent cet événement personnalisé. Désormais, lorsqu’un utilisateur ajoute un article à son panier, ce canvas est déclenché. Vous pouvez ensuite cibler votre communication directement sur cet utilisateur, en lui proposant des codes de réduction lorsqu’il a atteint un certain montant de dépenses, lorsqu’il a abandonné son panier pendant un certain temps, ou tout autre facteur en adéquation avec votre cas d’utilisation.

L’attribut shopping_cart contient le total 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. Ceci 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éfinition de la propriété d’entrée du canvas en tant qu’attribut

Vous pouvez utiliser l’étape de mise à jour de l’utilisateur pour faire persister un canvas_entry_property. Imaginons que vous ayez un événement qui se déclenche lorsqu’un article est ajouté à un 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 comme un attribut, utilisez le modal de personnalisation pour extraire et stocker la propriété d’entrée de Canvas. La mise à jour de l’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’annulation de messages)
• Plusieurs mises à jour d’attribut ou d’événement par objet

Éditeur JSON avancé

Veuillez ajouter un attribut, un événement ou un objet JSON d’achat contenant jusqu’à 65 536 caractères à l’éditeur JSON. L’état de l’abonnement global et du groupe d’abonnement d’un utilisateur peut également être défini.

À l’aide de l’éditeur JSON, vous pouvez également prévisualiser et vérifier que le profil utilisateur est mis à jour avec vos modifications dans l’onglet Prévisualiser et tester. Vous pouvez sélectionner un utilisateur aléatoire ou rechercher un utilisateur spécifique. Ensuite, après avoir envoyé un test à un utilisateur, affichez le profil utilisateur en utilisant le lien généré.

Considérations

Il n’est pas nécessaire d’inclure des données sensibles telles que votre clé API lorsque vous utilisez l’éditeur JSON, car celles-ci sont automatiquement fournies 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 importations de jetons de notification push

Consigner un événement personnalisé

À l’aide de l’éditeur JSON, vous pouvez également enregistrer des événements personnalisés. Veuillez noter que cela nécessite un horodatage au format ISO, il est donc nécessaire d’attribuer une heure et une date avec Liquid au début. Prenons cet exemple qui enregistre un événement avec une heure.

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}}"
    }
  ]
}

Cet exemple suivant relie un événement à une application spécifique à l’aide d’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 de l’abonnement

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

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

Mettre à jour les groupes d’abonnement SMS

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

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"
        }
      ]
    }
  ]
}