Skip to content

Mise à jour utilisateur

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

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

Les utilisateurs ne passeront à l’étape Canvas suivante qu’une fois les mises à jour pertinentes de l’utilisateur effectuées. Si votre message suivant repose sur les mises à jour de l’utilisateur que vous effectuez, vous pouvez vous assurer que ces mises à jour ont été effectuées avant que les messages ne soient envoyés.

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

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

Il existe trois options qui vous permettent de mettre à jour les informations existantes, d’ajouter de nouvelles ou de supprimer des informations de 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 ajouter ou mettre à jour un attribut personnalisé, sélectionnez un nom d’attribut dans votre liste d’attributs et entrez la valeur clé.

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 au compositeur JSON avancé pour apporter d’autres modifications.

Valeurs croissantes et décroissantes

L’étape de mise à jour par l’utilisateur peut augmenter ou 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é stocké sur le profil d’un utilisateur et riche en données. Cela vous permet de créer un historique des interactions de l’utilisateur avec votre marque. Cela vous permet de créer des segments sur la base d’un attribut personnalisé qui est un champ calculé, comme l’historique des achats ou la valeur vie totale.

L’étape de mise à jour de l’utilisateur peut ajouter ou supprimer des attributs à ce tableau d’objets. Pour mettre à jour un tableau, sélectionnez le nom de l’attribut du tableau dans votre liste d’attributs et saisissez la valeur de la clé.

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

L’ajout ou la suppression d’un élément dans un tableau met à jour la liste de souhaits de l’utilisateur.

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. Créez un tableau d’objets personnalisé appelé shopping_cart. L’exemple suivant montre à quoi peut ressembler cet attribut. Chaque élément possède un product_id unique qui contient des données plus complexes 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 avec une audience ciblée d’utilisateurs grâce à 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": yes,
         "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 :

Compositeur JSON avancé

Ajoutez un attribut, un événement ou un objet JSON d’achat d’un maximum de 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 du compositeur avancé, vous pouvez également prévisualiser et tester que le profil utilisateur est mis à jour avec les modifications grâce à l’onglet Prévisualisation et test. 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

Vous n’avez pas besoin d’inclure de données sensibles telles que votre clé API lorsque vous utilisez le compositeur JSON, car elles sont automatiquement fournies par la plateforme. Ainsi, les champs suivants ne sont pas nécessaires et ne doivent pas être utilisés dans le compositeur 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 du composeur 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’attribuer une heure et une date avec du 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 le compositeur JSON, vous pouvez également modifier l’état de l’abonnement de votre 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 montre une mise à jour des groupes d’abonnement. Vous pouvez effectuer une ou plusieurs mises à jour de groupe 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"
        }
      ]
    }
  ]
}
CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!