Événements recommandés pour le commerce électronique

Cette page couvre les événements et propriétés recommandés pour le commerce électronique. Ces événements sont créés pour capturer les comportements d’achat clés dont les marketeurs ont besoin pour déclencher des messages efficaces, comme le ciblage des paniers abandonnés.

important:

Les événements recommandés pour le commerce électronique sont actuellement en accès anticipé. Contactez votre gestionnaire satisfaction client Braze si vous souhaitez participer à cet accès anticipé.

Si vous utilisez le nouveau connecteur Shopify, ces événements recommandés seront automatiquement disponibles grâce à l’intégration.

Braze reconnaît que la planification des données prend du temps. Nous encourageons nos personnalisés à familiariser leurs équipes de développement et à commencer à envoyer ces événements dès maintenant. Bien que certaines fonctionnalités ne soient pas disponibles immédiatement avec les événements recommandés pour le commerce électronique, vous pouvez vous attendre à l’introduction de nouveaux produits tout au long de l’année 2025 qui amélioreront vos capacités de commerce électronique.

Types d’événements recommandés pour le commerce électronique

important:

The plans to phase out the purchase event will be announced in late 2025. In the long run, the purchase event will be replaced by new eCommerce recommended events, which will come with enhanced features for segmentation, reporting, analytics, and more. However, the new eCommerce events will not support existing features related to the purchase event, such as Lifetime Value (LTV) or revenue reporting in Canvases or campaigns. For a complete list of features related to purchase events, refer to Logging purchase events.

Toute devise autre que le dollar américain s’affichera dans Braze en dollars américains, sur la base du taux de change en vigueur à la date de la déclaration. Pour éviter la conversion des devises, coder en dur la devise en USD.

Vous pouvez utiliser l’événement “produit consulté” pour déclencher une action lorsqu’un client consulte la page détaillée d’un produit.

Propriétés

Nom du bien Exigée Type de données Description

product_id Oui Chaîne de caractères Identifiant unique du produit consulté.
Pour les clients non-Shopify, il s’agira de la valeur que vous définissez pour les ID d’articles du catalogue, comme les UGS.

product_name Oui Chaîne de caractères Le nom du produit qui a été consulté.

variant_id Oui Chaîne de caractères Un identifiant unique pour la variante du produit. En voici un exemple shirt_medium_blue

image_url Non Chaîne de caractères URL de l’image du produit.

product_url Non Chaîne de caractères URL vers la page du produit pour plus de détails.

price Oui Float Le prix unitaire variante du produit au moment de la consultation.

currency Oui Chaîne de caractères La devise dans laquelle le prix du produit est indiqué (par exemple “USD” ou “EUR”) au format ISO 4217.

source Oui Chaîne de caractères Source d’où provient l’événement. (Pour Shopify, il s’agit de storefront).

metadata Non Objet

type Non Objet Fonctionne avec les notifications de retour en stock et les notifications de baisse de prix.

sku Non Chaîne de caractères (Shopify uniquement) Unité de gestion des stocks Shopify. Ce champ peut être configuré comme le champ ID du catalogue.

Exemples d’objets

braze.logCustomEvent("ecommerce.product_viewed", {
    "product_id": "4111176",
    "product_name": "Torchie runners",
    "variant_id": "4111176700",
    "image_url": "https://braze-apparel.com/images/products/large/torchie-runners.jpg",
    "product_url": "https://braze-apparel.com/footwear-categories/sneakers/braze-orange-torchie-runners/",
    "price": 85,
    "currency": "GBP",
    "source": "https://braze-apparel.com/",
    "metadata": {
        "sku": "",
        "color": "ORANGE",
        "size": "6",
        "brand": "Braze"
    }
});

BrazeProperties properties = new BrazeProperties()
    .addProperty("product_id", "4111176")
    .addProperty("product_name", "Torchie runners")
    .addProperty("variant_id", "4111176700")
    .addProperty("image_url", "https://braze-apparel.com/images/products/large/torchie-runners.jpg")
    .addProperty("product_url", "https://braze-apparel.com/footwear-categories/sneakers/braze-orange-torchie-runners/")
    .addProperty("price", 85)
    .addProperty("currency", "GBP")
    .addProperty("source", "https://braze-apparel.com/")
    .addProperty("metadata", new JSONObject()
        .put("sku", "")
        .put("color", "ORANGE")
        .put("size", "6")
        .put("brand", "Braze"));

Braze.getInstance(context).logCustomEvent("ecommerce.product_viewed", properties);

let properties: [String: Any] = [
    "product_id": "4111176",
    "product_name": "Torchie runners",
    "variant_id": "4111176700",
    "image_url": "https://braze-apparel.com/images/products/large/torchie-runners.jpg",
    "product_url": "https://braze-apparel.com/footwear-categories/sneakers/braze-orange-torchie-runners/",
    "price": 85,
    "currency": "GBP",
    "source": "https://braze-apparel.com/",
    "metadata": [
        "sku": "",
        "color": "ORANGE",
        "size": "6",
        "brand": "Braze"
    ]
]

AppDelegate.braze?.logCustomEvent(name: "ecommerce.product_viewed", properties: properties)

{
  "events": [
    {
      "external_id": "user_id",
      "app_id": "your_app_identifier",
      "name": "ecommerce.product_viewed",
      "time": "2024-01-15T09:03:45Z",
      "properties": {
        "product_id": "4111176",
        "product_name": "Torchie runners",
        "variant_id": "4111176700",
        "image_url": "https://braze-apparel.com/images/products/large/torchie-runners.jpg",
        "product_url": "https://braze-apparel.com/footwear-categories/sneakers/braze-orange-torchie-runners/",
        "price": 85,
        "currency": "GBP",
        "source": "https://braze-apparel.com/",
        "metadata": {
          "sku": "",
          "color": "ORANGE",
          "size": "6",
          "brand": "Braze"
        }
        "type": [
          "price_drop",
          "back_in_stock"
        ]
      }
    }
  ]
}

Vous pouvez utiliser l’événement de mise à jour du panier pour suivre l’ajout, la suppression ou la mise à jour de produits dans le panier. L’événement ecommerce.cart_updated vérifie les informations suivantes avant de se déclencher :

L’heure de l’événement est supérieure à l’heure du site updated_at pour le panier spécifique de l’utilisateur.
Le panier n’est pas passé à la caisse.
Le tableau products n’est pas vide.

Objet de mappage des chariots

L’événement ecommerce.cart_updated possède un objet de mappage des paniers. Cet objet est créé pour le profil utilisateur qui contient un mappage des paniers, lesquels contiennent tous les produits du panier de l’acheteur. Vous pouvez accéder aux produits de leur panier par l’intermédiaire de l’étiquette Liquid :

{% shopping_cart {{context_properties.${cart_id}}} %}
{% for item in shopping_cart.products %}
{% catalog_items <add_your_catalog> {{item.variant_id}} %}

Si un panier n’a pas été mis à jour et n’est pas passé à l’étape de la commande dans les 10 jours, nous supprimerons le panier et les produits associés.

note:

Les produits par panier ne sont pas limités sur Braze. Cependant, la limite de Shopify est de 500.

Comportement du chariot lors de la fusion de profils utilisateurs

S’il y a deux paniers, ajoutez les deux à l’utilisateur fusionné. Remettez le Canvas en file d’attente s’il s’agit du même panier ou d’un panier différent afin d’envoyer un message contenant les informations les plus récentes sur le panier. L’événement ecommerce.cart_updated contiendra l’ID du dernier panier et les derniers produits du panier.

Propriétés

Nom du bien Exigée Type de données Description

cart_id Oui Chaîne de caractères Identifiant unique du panier. Si aucune valeur n’est transmise, nous déterminerons une valeur par défaut (partagée entre les événements panier, caisse et commande) pour le mappage du panier de l’utilisateur.

total_value Oui Float Valeur monétaire totale du panier.

currency Oui Chaîne de caractères La devise dans laquelle le prix du produit est indiqué (par exemple “USD” ou “EUR”) au format ISO 4217.

products Oui Réseau

product_id Oui Chaîne de caractères Identifiant unique du produit consulté.
Cette valeur peut être l’ID du produit ou l’unité de gestion des stocks.

product_name Oui Chaîne de caractères Le nom du produit qui a été consulté.

variant_id Oui Chaîne de caractères Un identifiant unique pour la variante du produit. En voici un exemple shirt_medium_blue

image_url Non Chaîne de caractères URL de l’image du produit.

product_url Non Chaîne de caractères URL vers la page du produit pour plus de détails.

quantity Oui Entier Nombre d’unités du produit dans le panier.

price Oui Float Le prix unitaire variante du produit au moment de la consultation.

metadata Non Objet Champ de métadonnées supplémentaires sur le produit que le client souhaite ajouter pour ses cas d’utilisation. Pour Shopify, nous ajouterons l’unité de gestion des stocks.
Cette limite est basée sur la limite générale de 50 kb fixée pour les propriétés d’un événement.

sku Non Chaîne de caractères (Shopify uniquement) Unité de gestion des stocks Shopify. Ce champ peut être configuré comme le champ ID du catalogue.

source Oui Chaîne de caractères Source d’où provient l’événement. (Pour Shopify, il s’agit de storefront).

Exemples d’objets

braze.logCustomEvent("ecommerce.cart_updated", {
    "cart_id": "cart_12345",
    "currency": "USD",
    "total_value": 199.98,
    "products": [
        {
            "product_id": "8266836345064",
            "product_name": "Classic T-Shirt",
            "variant_id": "44610569208040",
            "image_url": "https://braze-apparel.com/images/tshirt-blue-medium.jpg",
            "product_url": "https://braze-apparel.com/products/classic-tshirt?variant=44610569208040",
            "quantity": 2,
            "price": 99.99,
            "metadata": {
                "sku": "TSH-BLU-M",
                "color": "BLUE",
                "size": "Medium",
                "brand": "Braze"
            }
        }
    ],
    "source": "https://braze-apparel.com",
    "metadata": {}
});

JSONArray products = new JSONArray();
JSONObject product = new JSONObject()
    .put("product_id", "8266836345064")
    .put("product_name", "Classic T-Shirt")
    .put("variant_id", "44610569208040")
    .put("image_url", "https://braze-apparel.com/images/tshirt-blue-medium.jpg")
    .put("product_url", "https://braze-apparel.com/products/classic-tshirt?variant=44610569208040")
    .put("quantity", 2)
    .put("price", 99.99)
    .put("metadata", new JSONObject()
        .put("sku", "TSH-BLU-M")
        .put("color", "BLUE")
        .put("size", "Medium")
        .put("brand", "Braze"));
products.put(product);

BrazeProperties properties = new BrazeProperties()
    .addProperty("cart_id", "cart_12345")
    .addProperty("currency", "USD")
    .addProperty("total_value", 199.98)
    .addProperty("products", products)
    .addProperty("source", "https://braze-apparel.com")
    .addProperty("metadata", new JSONObject());

Braze.getInstance(context).logCustomEvent("ecommerce.cart_updated", properties);

let products: [[String: Any]] = [
    [
        "product_id": "8266836345064",
        "product_name": "Classic T-Shirt",
        "variant_id": "44610569208040",
        "image_url": "https://braze-apparel.com/images/tshirt-blue-medium.jpg",
        "product_url": "https://braze-apparel.com/products/classic-tshirt?variant=44610569208040",
        "quantity": 2,
        "price": 99.99,
        "metadata": [
            "sku": "TSH-BLU-M",
            "color": "BLUE",
            "size": "Medium",
            "brand": "Braze"
        ]
    ]
]

let properties: [String: Any] = [
    "cart_id": "cart_12345",
    "currency": "USD",
    "total_value": 199.98,
    "products": products,
    "source": "https://braze-apparel.com",
    "metadata": [:]
]

AppDelegate.braze?.logCustomEvent(name: "ecommerce.cart_updated", properties: properties)

{
  "events": [
    {
      "external_id": "user_id",
      "app_id": "your_app_identifier",
      "name": "ecommerce.cart_updated",
      "time": "2024-01-15T09:15:30Z",
      "properties": {
        "cart_id": "cart_12345",
        "currency": "USD",
        "total_value": 199.98,
        "products": [
          {
            "product_id": "8266836345064",
            "product_name": "Classic T-Shirt",
            "variant_id": "44610569208040",
            "image_url": "https://braze-apparel.com/images/tshirt-blue-medium.jpg",
            "product_url": "https://braze-apparel.com/products/classic-tshirt?variant=44610569208040",
            "quantity": 2,
            "price": 99.99,
            "metadata": {
              "sku": "TSH-BLU-M",
              "color": "BLUE",
              "size": "Medium",
              "brand": "Braze"
            }
          }
        ],
        "source": "https://braze-apparel.com",
        "metadata": {}
      }
    }
  ]
}

Vous pouvez utiliser l’événement checkout started pour recibler les clients qui ont commencé le processus de paiement mais n’ont pas passé de commande.

Semblable à l’événement ecommerce.cart_updated, cet événement vous permet d’exploiter l’étiquette Liquid du panier d’achat pour accéder à tous les produits contenus dans le panier afin d’envoyer des messages d’abandon de panier :

{% shopping_cart {{context_properties.${cart_id}}} :abort_if_not_abandoned false %}
{% for item in shopping_cart.products %}
{% catalog_items <add_your_catalog> {{item.variant_id}} %}

Propriétés

Nom du bien Exigée Type de données Description

checkout_id Oui Chaîne de caractères Identifiant unique de la caisse.

cart_id Non Chaîne de caractères Identifiant unique du panier. Si aucune valeur n’est transmise, nous déterminerons une valeur par défaut (partagée entre les événements panier, caisse et commande) pour le mappage du panier de l’utilisateur…

total_value Oui Float Valeur monétaire totale du panier.

currency Oui Chaîne de caractères Devise dans laquelle le panier est évalué.

products Oui Tableau d’objets

product_id Oui Chaîne de caractères Identifiant unique du produit consulté. Par exemple, cette valeur peut être l’ID du produit ou l’unité de gestion des stocks.