Notifications de retour en stock
Découvrez comment mettre en place des notifications de retour en stock à l’aide de votre catalogue et d’événements personnalisés, afin d’abonner automatiquement les clients à des notifications lorsqu’un article est de nouveau disponible. Gardez à l’esprit que cela ne s’applique qu’aux utilisateurs ayant déjà accepté de recevoir des notifications.
Fonctionnement
Vous pouvez configurer un événement personnalisé à utiliser comme événement d’abonnement, tel qu’un événement product_clicked. Cet événement doit contenir une propriété correspondant à l’ID de l’article (ID des articles du catalogue). Nous vous recommandons d’inclure un nom de catalogue, mais ce n’est pas obligatoire. Vous devrez également fournir le nom d’un champ de quantité en stock, qui doit être un type de donnée numérique.
Notez que le stock d’un article du catalogue doit être à zéro pour qu’un utilisateur puisse s’y abonner avec succès. Lorsqu’un article a une quantité en stock supérieure à zéro, Braze recherche tous les utilisateurs abonnés à cet article et envoie un événement personnalisé que vous pouvez utiliser pour déclencher une Campaign ou un Canvas.
Les propriétés d’événement sont envoyées avec les données de votre utilisateur, ce qui vous permet d’intégrer les détails de l’article dans la Campaign ou le Canvas qui effectue l’envoi.
Configuration des notifications de retour en stock
Suivez ces étapes pour configurer les notifications de retour en stock dans un catalogue spécifique.
- Accédez à votre catalogue et sélectionnez l’onglet Paramètres.
- Activez le basculeur Retour en stock.
- Si les paramètres globaux de retour en stock n’ont pas été configurés, vous serez invité à configurer les événements personnalisés et les propriétés qui seront utilisés pour déclencher les notifications de retour en stock :
- Catalogue de secours Il s’agit du catalogue qui sera utilisé pour l’abonnement au retour en stock, s’il n’y a pas de propriété
catalog_nameprésente sur l’événement personnalisé. - Événement personnalisé pour les abonnements est l’événement personnalisé Braze qui sera utilisé pour abonner un utilisateur aux notifications de retour en stock. Lorsque cet événement se produit, l’utilisateur qui a effectué l’événement sera abonné.
- Événement personnalisé pour le désabonnement est l’événement personnalisé Braze qui sera utilisé pour désabonner un utilisateur des notifications de retour en stock. Cet événement est facultatif. Si l’utilisateur n’effectue pas cet événement, il sera désabonné après 90 jours ou lorsque l’événement de retour en stock se déclenche, selon ce qui se produit en premier.
-
Propriété d’événement de l’ID de l’article est la propriété de l’événement personnalisé mentionné plus tôt dans cette section qui sera utilisée pour déterminer l’article pour un abonnement ou un désabonnement au retour en stock. Cette propriété de l’événement personnalisé doit contenir un ID d’article (
id) présent dans un catalogue. L’ID de l’article doit être envoyé sous forme de chaîne de caractères afin qu’il corresponde au type de donnéesidstocké dans le catalogue cible. L’événement personnalisé doit également contenir une propriétécatalog_namepour spécifier dans quel catalogue se trouve cet article. - L’exemple suivant montre un événement personnalisé envoyé via la REST API :
- Catalogue de secours Il s’agit du catalogue qui sera utilisé pour l’abonnement au retour en stock, s’il n’y a pas de propriété
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"events": [
{
"external_id": "<external_id>",
"name": "subscription",
"time": "2024-04-15T19:22:28Z",
"properties": {
"id": "shirt-xl",
"catalog_name": "on_sale_products",
"type": ["back_in_stock"]
}
}
]
}
Pour suivre le même événement d’abonnement à l’aide des SDK Braze, utilisez le code suivant :
1
2
3
4
5
6
7
import { logCustomEvent } from "@braze/web-sdk";
logCustomEvent("subscription", {
id: "shirt-xl",
catalog_name: "on_sale_products",
type: ["back_in_stock"]
});
1
2
3
4
5
6
7
8
AppDelegate.braze?.logCustomEvent(
name: "subscription",
properties: [
"id": "shirt-xl",
"catalog_name": "on_sale_products",
"type": ["back_in_stock"]
]
)
1
2
3
4
5
6
7
8
9
Braze.getInstance(context).logCustomEvent(
"subscription",
BrazeProperties(
JSONObject()
.put("id", "shirt-xl")
.put("catalog_name", "on_sale_products")
.put("type", JSONArray().put("back_in_stock")),
),
)

Les déclencheurs de retour en stock et de baisse de prix utilisent le même événement pour abonner l’utilisateur à la notification. Vous pouvez donc utiliser la propriété type pour définir à la fois les notifications de baisse de prix et de retour en stock dans le même événement. Notez que la propriété type doit être un tableau.
- Sélectionnez Enregistrer et continuez vers la page Paramètres du catalogue.
- Définissez votre règle de notification. Il existe deux options :
- Notifier tous les utilisateurs abonnés notifie tous les clients en attente lorsque l’article est de nouveau en stock.
- Définir des limites de notification notifie un nombre spécifié de clients toutes les 10 minutes. Braze notifiera le nombre spécifié de clients par incréments jusqu’à ce qu’il n’y ait plus de clients à notifier ou que l’article soit de nouveau en rupture de stock. Votre taux de notification ne peut pas dépasser 10 000 utilisateurs par minute.
- Définissez le Champ d’inventaire dans le catalogue. Ce champ du catalogue sera utilisé pour déterminer si l’article est en rupture de stock. Le champ doit être de type numérique.
- Sélectionnez Enregistrer les paramètres.


Les règles de notification dans ces paramètres ne remplacent pas les paramètres de notification de Canvas, tels que les heures calmes.
Utiliser les notifications de retour en stock dans un Canvas
Après avoir configuré la fonctionnalité de retour en stock dans un catalogue, suivez ces étapes pour l’utiliser avec Canvas.
- Configurez un Canvas basé sur une action.
- Sélectionnez Retour en stock comme déclencheur.
- Sélectionnez le nom du catalogue avec les notifications de retour en stock.
- Continuez à configurer votre Canvas comme vous le feriez habituellement.
Désormais, vos clients peuvent être notifiés lorsqu’un article est de nouveau en stock.
Utiliser Liquid
Pour intégrer des détails sur l’article du catalogue qui est de nouveau en stock, vous pouvez utiliser l’étiquette Liquid context pour accéder à l’item_id.
L’utilisation de {{context.${catalog_update}.item_id}} renverra l’ID de l’article qui est revenu en stock. {{context.${catalog_update}.previous_value}} renverra la valeur d’inventaire de l’article avant la mise à jour, et {{context.${catalog_update}.new_value}} renverra la nouvelle valeur d’inventaire après la mise à jour.
Utilisez l’étiquette Liquid {% catalog_items <name_of_your_catalog> {{context.${catalog_update}.item_id}} %} en haut de votre message, puis utilisez {{ items[0].<field_name> }} pour accéder aux données de cet article dans l’ensemble du message.

Les propriétés d’entrée Canvas font partie des variables de contexte Canvas. Cela signifie que canvas_entry_properties est référencé en tant que context. Chaque variable context comprend un nom, un type de données et une valeur pouvant inclure du Liquid. Actuellement, canvas_entry_properties reste rétrocompatible. Pour plus de détails, consultez les sections Contexte et Objet de contexte Canvas.

Pour intégrer des images pour les éléments déclencheurs du catalogue, votre catalogue doit inclure un champ nommé image_url. Vous pouvez ensuite y faire référence en utilisant {{ items[0].image_url }}.
Considérations
- Les utilisateurs ne sont abonnés que pendant 90 jours. Si l’article n’est pas de nouveau en stock dans les 90 jours, l’utilisateur est désabonné.
- Lorsque vous utilisez la règle de notification Notify all subscribed users, Braze notifie 100 000 utilisateurs en 10 minutes.
- Braze prend en charge jusqu’à 50 000 articles mis à jour quotidiennement pouvant déclencher des notifications de retour en stock. Vous pouvez avoir jusqu’à 100 millions d’abonnements actifs à un moment donné, chaque abonnement représentant un profil utilisateur abonné pour surveiller un article du catalogue.