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ées 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.

1. Accédez à votre catalogue et sélectionnez l’onglet Settings.
2. Activez le basculeur Back in stock.
3. 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 :
   
   • Fallback Catalog Il s’agit du catalogue utilisé pour l’abonnement au retour en stock s’il n’y a pas de propriété catalog_name présente dans l’événement personnalisé.
   • Custom event for subscriptions est l’événement personnalisé Braze 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 est abonné.
   • Custom event for unsubscribing est l’événement personnalisé Braze 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.

   • Item ID event property est la propriété de l’événement personnalisé mentionné plus tôt dans cette section, utilisée pour déterminer l’article concerné par 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 de correspondre au type de données id stocké dans le catalogue cible. L’événement personnalisé doit également contenir une propriété catalog_name pour spécifier dans quel catalogue se trouve cet article.

   • Voici un exemple d’événement personnalisé :

• rest api
• web sdk
• android sdk
• ios sdk

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

1
2
3
4
5

braze.logCustomEvent("subscription", {
  id: "shirt-xl",
  catalog_name: "on_sale_products",
  type: ["back_in_stock"]
});

1
2
3
4
5
6
7
8
9
10

// Kotlin
Braze.getInstance(context).logCustomEvent(
  "subscription",
  BrazeProperties(
    JSONObject()
      .put("id", "shirt-xl")
      .put("catalog_name", "on_sale_products")
      .put("type", JSONArray().put("back_in_stock"))
  )
)

1
2
3
4
5
6
7
8
9

// Java
Braze.getInstance(context).logCustomEvent(
  "subscription",
  new BrazeProperties(new JSONObject()
    .put("id", "shirt-xl")
    .put("catalog_name", "on_sale_products")
    .put("type", new JSONArray().put("back_in_stock"))
  )
);

1
2
3
4
5
6
7
8
9

// Swift
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

// Objective-C
[AppDelegate.braze logCustomEvent:@"subscription"
                       properties:@{
  @"id": @"shirt-xl",
  @"catalog_name": @"on_sale_products",
  @"type": @[@"back_in_stock"]
}];

Remarque

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.

4. Sélectionnez Save et continuez vers la page Settings du catalogue.
5. Définissez votre règle de notification. Deux options sont disponibles :
   • Notify all subscribed users notifie tous les clients en attente lorsque l’article est de nouveau en stock.
   • Set notification limits 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.
6. Définissez le champ Inventory field in catalog. 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.
7. Sélectionnez Save settings.

Important

Les règles de notification de 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.

1. Configurez un Canvas basé sur une action.
2. Sélectionnez Retour en stock comme déclencheur.
3. Sélectionnez le nom du catalogue contenant les notifications de retour en stock.
4. 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 retour 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 relatives à cet article dans l’ensemble du message.

Important

La terminologie et l’espace de noms Liquid affichés dépendent des fonctionnalités disponibles dans votre espace de travail :

• Si le tableau de bord affiche Context Variables, référencez les propriétés d’entrée avec context, par exemple {{context.${property_name}}}. Vous pouvez également créer ou mettre à jour des variables avec une étape Context.
• Si le tableau de bord affiche Canvas Entry Properties, référencez-les avec canvas_entry_properties, par exemple {{canvas_entry_properties.${property_name}}}. L’étape Context et le filtre Context Variable ne sont pas disponibles.
  
  Pour en savoir plus, consultez les sections Contexte et Propriétés de contexte et d’événement. Si vous avez besoin d’accéder au contexte Canvas, contactez votre gestionnaire de la satisfaction client.

Conseil

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 retour 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é à la surveillance d’un article du catalogue.
• Lorsque vous exportez les utilisateurs abonnés depuis les paramètres de votre catalogue, le fichier CSV inclut jusqu’à 10 000 abonnements, même si le catalogue contient davantage d’abonnements actifs.