Fonctionnalités des données de Shopify

Cet article donne un aperçu des fonctionnalités Braze pour Shopify, y compris les données Shopify suivies et des exemples de payloads, le backfill historique et les synchronisations de produits.

Événements Shopify suivis

L’intégration Shopify utilise les événements eCommerce recommandés pour capturer les principaux comportements d’achat. Pour des exemples de déploiement et des stratégies marketing qui utilisent ces événements, consultez les cas d’usage eCommerce.

Important

L’intégration Shopify prend en charge les webhooks de création et de mise à jour des clients Shopify, qui se trouvent dans vos paramètres de configuration des données. Lorsqu’un profil utilisateur est créé ou mis à jour dans Shopify, un profil utilisateur correspondant est créé ou mis à jour dans Braze.

Ces actions ne déclenchent pas d’événements personnalisés dans Braze et servent uniquement à synchroniser les données utilisateur Shopify avec Braze. Les données synchronisées comprennent les attributs personnalisés, les attributs standard et, si cette option est activée dans votre configuration, les états des groupes d’abonnement.

• example payload
• shopify events

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
    "name": "ecommerce.product_viewed",
    "properties": {
        "product_id": "12345",
        "product_name": "product",
        "variant_id": "123",
        "image_url": "www.image-url.com",
        "product_url": "mystorefront.myshopify.com/product",
        "price": 10,
        "currency": "USD",
        "source": "mystorefront.myshopify.com",
        "metadata": {
          "sku": "sku"
        },
        "type": [
          "price_drop",
          "back_in_stock"
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "name": "ecommerce.cart_updated",
    "properties": {
        "cart_id": "Z2NwLXVzLWVhc3QxOjAxSjk3UFg4RlFZMjVTVkRHRlc1RlI3SlRY",
        "currency": "USD",
        "total_value": 2000000,
        "products": [
            {
                "product_id": "8266836345064",
                "product_name": "PANTS!!!",
                "variant_id": "44610569208040",
                "image_url": "https://cdn.shopify.com/s/files/1/0604/4211/6328/files/1200px-Trousers-colourisolated.jpg?v=1689256168",
                "product_url": "https://test-store.myshopify.com/products/pants?variant=44610569208040",
                "quantity": 2,
                "price": 1000000,
                "metadata": {
                    "sku": "007"
                }
            }
        ],
        "source": "https://test-store.myshopify.com",
        "metadata": {}
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
    "name": "ecommerce.checkout_started",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "checkout_id": "123123123",
        "metadata": {
            "checkout_url": "https://checkout.local/548380009/checkouts/123123123/recover?key=example-secret-token"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

{
    "name": "ecommerce.order_placed",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ],
            "referring_site": "https://www.google.com",
            "payment_gateway_names": [
                "visa",
                "bogus"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

{
 "name": "shopify_fulfilled_order",
 "time": "2022-05-23T14:44:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
  "variant_id": 40094740549876,
       "variant_title": "Small Dark Denim Top",


       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": "2022-05-23T14:44:34-04:00",
   "fulfillment_status": "fulfilled",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "456",
       "tracking_numbers": [
         "456"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "Small Dark Denim Top",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "123abc123abc"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

{
 "name": "shopify_partially_fulfilled_order",
 "time": "2022-05-23T14:43:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
       "variant_id": 40094740549876,
       "variant_title": "",
       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": null,
   "fulfillment_status": "partial",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "123",
       "tracking_numbers": [
         "123"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "properties": [],
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "abc123abc123"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
 "name": "shopify_paid_order",
 "time": "2022-05-23T13:52:38-04:00",
 "properties": {
   "order_id": 4444596371647,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143033344191,
       "sku": null,
       "title": "LED High Tops",
       "variant_id": 40094740549876,
       "variant_title": null,
       "vendor": "partners-demo",
       "name": "LED High Tops",
       "properties": [],
       "price": "80.00",
       "fulfillment_status": null
     }
   ]
 }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
    "name": "ecommerce.order_cancelled",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cancel_reason": "no longer necessary",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
    "name": "ecommerce.order_refunded",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "total_value": 421.88,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
		"order_note": "item was broken"
        }
    }
}

1
2
3
4
5
6

{
	"name": "shopify_account_login",
	"properties": {
	"source": "braze-mock-storefront.myshopify.com"
  }
}

Remarque

Braze s’appuie sur Shopify pour fournir les propriétés d’événement requises (telles que cart_id ou cart_token) pour les événements eCommerce. Dans de rares cas, des problèmes temporaires chez Shopify peuvent empêcher la transmission de ces propriétés, ce qui peut entraîner l’abandon des événements concernés.

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

Événement : ecommerce.product_viewed
Type : Événement recommandé
Déclenchement : Lorsqu’un client consulte une page produit
Source de données : SDK de Braze
Cas d’usage : Abandon de navigation

Variable	Modèle Liquid
product_id	{{event_properties.${product_id}}}
product_name	{{event_properties.${product_name}}}
variant_id	{{event_properties.${variant_id}}}
image_url	{{event_properties.${image_url}}}
product_url	<your-store.myshopify.com>{{event_properties.${product_url}}} Ajoutez le domaine de votre site Shopify avant l’URL.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

Événement : ecommerce.cart_updated
Type : Événement recommandé
Déclenchement : Lorsqu’un client ajoute, supprime ou met à jour des articles dans son panier
Source de données : SDK de Braze
Cas d’usage : Abandon de panier

Pour les Canvas de panier abandonné, vous devez d’abord ajouter l’étiquette Liquid initiale du panier afin d’obtenir le contexte du panier dans votre message.

1

{% shopping_cart {{context.${cart_id}}} %}

Vous pouvez ensuite ajouter les étiquettes Liquid de panier suivantes dans votre message.

Variable	Modèle Liquid
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata[0].sku }}
source	{{ shopping_cart.source }}
metadata (value)	{{ shopping_cart.metadata[0].<add_value_here> }}

Conseil

Pour savoir comment créer une boucle Liquid for afin d’ajouter dynamiquement tous les produits dans votre e-mail, consultez la section Personnalisation des produits du panier abandonné dans les e-mails.

Événement : ecommerce.checkout_started
Type : Événement recommandé
Déclenchement : Lorsqu’un utilisateur accède à la page de paiement
Source de données : REST API de Braze
Cas d’usage : Abandon du paiement

Important

Si un client utilise Shop Pay comme option de paiement accéléré, Shopify peut ignorer certains événements de paiement standard (tels que le webhook Shopify de début de paiement). Braze risque alors de ne pas recevoir les données nécessaires pour ajouter l’alias du jeton de paiement, ce qui peut affecter le suivi de l’abandon du paiement et le rapprochement des profils utilisateurs.

Pour les Canvas de paiement abandonné, vous devez d’abord utiliser l’étiquette Liquid suivante :

1
2

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}

Vous pouvez ensuite ajouter les étiquettes Liquid suivantes dans votre message pour faire référence aux produits de votre panier au moment du paiement.

Variable	Modèle Liquid
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata.sku }}
source	{{ shopping_cart.source }}
checkout_url	{{ shopping_cart.metadata[0].checkout_url }}

Événement : ecommerce.order_placed
Type : Événement recommandé
Déclenchement : Lorsqu’un utilisateur termine le processus de paiement et passe une commande
Source de données : REST API de Braze
Cas d’usage : Confirmation de commande, reciblage après achat, ventes incitatives ou ventes croisées

Variable	Modèle Liquid
cart_id	{{event_properties.${cart_id}}}
currency	{{event_properties.${currency}}}
discounts	{{event_properties.${discounts}}}
order_id	{{event_properties.${order_id}}}
product_id	{{event_properties.${products}[0].product_id}}
product_name	{{event_properties.${products}[0].product_name}}
variant_id	{{event_properties.${products}[0].variant_id}}
quantity	{{event_properties.${products}[0].quantity}}
sku	{{event_properties.${products}[0].metadata.sku}}
total_discounts	{{event_properties.${total_discounts}}}
order_status_url	{{event_properties.${metadata}.order_status_url}}
order_number	{{event_properties.${metadata}.order_number}}
tags	{{event_properties.${metadata}.tags}}
referring_site	{{event_properties.${metadata}.referring_site}}
payment_gateway_names	{{event_properties.${metadata}.payment_gateway_names}}

Conseil

Le webhook Shopify de paiement finalisé ne contient pas les URL des produits ni celles des images. Vous devez donc utiliser la personnalisation Liquid des catalogues, comme indiqué dans la section Personnalisation des produits du panier abandonné dans les e-mails.

Événement : shopify_fulfilled_order
Type : Événement personnalisé
Déclenchement : Lorsque la commande d’un utilisateur est traitée et prête à être expédiée
Source de données : REST API de Braze
Cas d’usage : (Transactionnel) Mise à jour du traitement de la commande

Variable	Modèle Liquid
ID de commande	{{event_properties.${order_id}}}
Prix total	{{event_properties.${total_price}}}
Remises totales	{{event_properties.${total_discounts}}}
Statut de confirmation	{{event_properties.${confirmed}}}
URL du statut de la commande	{{event_properties.${order_status_url}}}
Numéro de commande	{{event_properties.${order_number}}}
Horodatage d’annulation	{{event_properties.${cancelled_at}}}
Horodatage de clôture	{{event_properties.${closed_at}}}
ID de l’élément	{{event_properties.${line_items}[0].product_id}}
Quantité de l’élément	{{event_properties.${line_items}[0].quantity}}
SKU de l’élément	{{event_properties.${line_items}[0].sku}}
Titre de l’élément	{{event_properties.${line_items}[0].title}}
Fournisseur de l’élément	{{event_properties.${line_items}[0].vendor}}
Nom de l’élément	{{event_properties.${line_items}[0].name}}
Propriétés de l’élément	{{event_properties.${line_items}[0].properties}}
Prix de l’élément	{{event_properties.${line_items}[0].price}}
Intitulé de la livraison	{{event_properties.${shipping}[0].title}}
Prix de la livraison	{{event_properties.${shipping}[0].price}}
Statut du traitement	{{event_properties.${fulfillment_status}}}
Statut d’expédition du traitement	{{event_properties.${fulfillments}[0].shipment_status}}
Statut	{{event_properties.${fulfillments}[0].status}}
Transporteur du traitement	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Numéro de suivi du traitement	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Numéros de suivi du traitement	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
URL de suivi du traitement	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
URL de suivi du traitement (liste)	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Statut du traitement	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nom du traitement	{{event_properties.${fulfillments}[0].line_items[0].name}}
Prix du traitement	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID produit du traitement	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Quantité du traitement	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Expédition du traitement	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU du traitement	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Titre du traitement	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fournisseur du traitement	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Titre de variante	{{event_properties.${line_items}[0].variant_title}}

Événement : shopify_partially_fulfilled_order
Type : Événement personnalisé
Déclenchement : Lorsqu’une partie de la commande d’un utilisateur est traitée et prête à être expédiée
Source de données : REST API de Braze
Cas d’usage : (Transactionnel) Mise à jour du traitement de la commande

Variable	Modèle Liquid
ID de commande	{{event_properties.${order_id}}}
Prix total	{{event_properties.${total_price}}}
Remises totales	{{event_properties.${total_discounts}}}
Statut de confirmation	{{event_properties.${confirmed}}}
URL du statut de la commande	{{event_properties.${order_status_url}}}
Numéro de commande	{{event_properties.${order_number}}}
Horodatage d’annulation	{{event_properties.${cancelled_at}}}
Horodatage de clôture	{{event_properties.${closed_at}}}
ID de l’élément	{{event_properties.${line_items}[0].product_id}}
Quantité de l’élément	{{event_properties.${line_items}[0].quantity}}
SKU de l’élément	{{event_properties.${line_items}[0].sku}}
Titre de l’élément	{{event_properties.${line_items}[0].title}}
Fournisseur de l’élément	{{event_properties.${line_items}[0].vendor}}
Nom de l’élément	{{event_properties.${line_items}[0].name}}
Propriétés de l’élément	{{event_properties.${line_items}[0].properties}}
Prix de l’élément	{{event_properties.${line_items}[0].price}}
Intitulé de la livraison	{{event_properties.${shipping}[0].title}}
Prix de la livraison	{{event_properties.${shipping}[0].price}}
Statut du traitement	{{event_properties.${fulfillment_status}}}
Statut d’expédition du traitement	{{event_properties.${fulfillments}[0].shipment_status}}
Statut du traitement	{{event_properties.${fulfillments}[0].status}}
Transporteur du traitement	{{event_properties.${fulfillments}[0].tracking_company}}
Numéro de suivi du traitement	{{event_properties.${fulfillments}[0].tracking_number}}
Numéros de suivi du traitement	{{event_properties.${fulfillments}[0].tracking_numbers}}
URL de suivi du traitement	{{event_properties.${fulfillments}[0].tracking_url}}
URL de suivi du traitement (liste)	{{event_properties.${fulfillments}[0].tracking_urls}}
Statut du traitement	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nom du traitement	{{event_properties.${fulfillments}[0].line_items[0].name}}
Prix du traitement	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID produit du traitement	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Quantité du traitement	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Expédition du traitement	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU du traitement	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Titre du traitement	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fournisseur du traitement	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Titre de variante	{{event_properties.${line_items}[0].variant_title}}

Événement : shopify_paid_order
Type : Événement personnalisé
Déclenchement : Lorsque la commande d’un utilisateur est marquée comme payée dans Shopify
Source de données : REST API de Braze
Cas d’usage : (Transactionnel) Confirmation de paiement

Variable	Modèle Liquid
ID de commande	{{event_properties.${order_id}}}
Statut de confirmation	{{event_properties.${confirmed}}}
URL du statut de la commande	{{event_properties.${order_status_url}}}
Numéro de commande	{{event_properties.${order_number}}}
Horodatage d’annulation	{{event_properties.${cancelled_at}}}
Remises totales	{{event_properties.${total_discounts}}}
Prix total	{{event_properties.${total_price}}}
Étiquettes	{{event_properties.${tags}}}
Codes de réduction	{{event_properties.${discount_codes}}}
ID de l’élément	{{event_properties.${line_items}[0].product_id}}
Quantité de l’élément	{{event_properties.${line_items}[0].quantity}}
SKU de l’élément	{{event_properties.${line_items}[0].sku}}
Titre de l’élément	{{event_properties.${line_items}[0].title}}
Fournisseur de l’élément	{{event_properties.${line_items}[0].vendor}}
Propriétés de l’élément	{{event_properties.${line_items}[0].properties}}
Prix de l’élément	{{event_properties.${line_items}[0].price}}
Intitulé de la livraison	{{event_properties.${shipping}[0].title}}
Prix de la livraison	{{event_properties.${shipping}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Titre de variante	{{event_properties.${line_items}[0].variant_title}}

Événement : ecommerce.order_cancelled
Type : Événement recommandé
Déclenchement : Lorsque la commande d’un utilisateur est annulée
Source de données : REST API de Braze
Cas d’usage : (Transactionnel) Confirmation d’annulation de commande

Variable	Modèle Liquid
ID de commande	{{event_properties.${order_id}}}
Prix total	{{event_properties.${total_price}}}
Remises totales	{{event_properties.${total_discounts}}}
Confirmé	{{event_properties.${confirmed}}}
URL du statut de la commande	{{event_properties.${order_status_url}}}
Numéro de commande	{{event_properties.${order_number}}}
Horodatage d’annulation	{{event_properties.${cancelled_at}}}
Étiquettes	{{event_properties.${tags}}}
Codes de réduction	{{event_properties.${discount_codes}}}
Statut du traitement	{{event_properties.${fulfillment_status}}}
Traitements	{{event_properties.${fulfillments}}}
ID de l’élément	{{event_properties.${line_items}[0].product_id}}
Quantité de l’élément	{{event_properties.${line_items}[0].quantity}}
SKU de l’élément	{{event_properties.${line_items}[0].sku}}
Titre de l’élément	{{event_properties.${line_items}[0].title}}
Fournisseur de l’élément	{{event_properties.${line_items}[0].vendor}}
Nom de l’élément	{{event_properties.${line_items}[0].name}}
Propriétés de l’élément	{{event_properties.${line_items}[0].properties}}
Statut du traitement	{{event_properties.${line_items}[0].fulfillment_status}}
Intitulé de la livraison	{{event_properties.${shipping}[0].title}}
Prix de la livraison	{{event_properties.${shipping}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Titre de variante	{{event_properties.${line_items}[0].variant_title}}

Événement : ecommerce.order_refunded
Type : Événement recommandé
Déclenchement : Lorsque la commande d’un utilisateur est remboursée
Source de données : REST API de Braze
Cas d’usage : (Transactionnel) Confirmation de remboursement

Variable	Modèle Liquid
ID de commande	{{event_properties.${order_id}}}
Note de commande	{event_properties.${note}}}
ID de l’élément	{{event_properties.${line_items}[0].product_id}}
Quantité de l’élément	{{event_properties.${line_items}[0].quantity}}
SKU de l’élément	{{event_properties.${line_items}[0].sku}}
Titre de l’élément	{{event_properties.${line_items}[0].title}}
Fournisseur de l’élément	{{event_properties.${line_items}[0].vendor}}
Nom de l’élément	{{event_properties.${line_items}[0].name}}
Propriétés de l’élément	{{event_properties.${line_items}[0].properties}}
Prix de l’élément	{{event_properties.${line_items}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Titre de variante	{{event_properties.${line_items}[0].variant_title}}

Événement : shopify_account_login
Type : Événement personnalisé
Déclenchement : Lorsqu’un utilisateur se connecte à son compte
Source de données : REST API de Braze
Cas d’usage : Série de bienvenue

Variable	Modèle Liquid
source	{{event_properties.${source}}}

Remarque

L’intégration Shopify ne prend actuellement pas en charge l’alimentation de l’événement d’achat de Braze. Par conséquent, les filtres d’achat, les étiquettes Liquid, les déclencheurs basés sur des actions et l’analyse doivent utiliser l’événement ecommerce.order_placed.

Attributs personnalisés Shopify pris en charge

Remarque

Tous les attributs proviennent de la REST API de Braze.

• exemple de payload
• attributs personnalisés shopify

• shopify tags

1
2
3
4
5
6
7
8
9
10
11
12

{
  "attributes": [
    {
      "shopify_tags": "VIP_customer",
      "shopify_total_spent": "60.00",
      "shopify_orders_count": "3",
      "shopify_last_order_id": "1234567",
      "shopify_zipcode": "10001",
      "shopify_province": "null"
    }
  ]
}

Nom de l’attribut	Description	Source des données
shopify_total_spent	Le montant total dépensé par le client sur l’ensemble de son historique de commandes.	Webhook customers/purchasing_summary de Shopify
shopify_orders_count	Le nombre de commandes associées à ce client. Les commandes de test et les commandes archivées ne sont pas comptabilisées.	Webhook customers/purchasing_summary de Shopify
shopify_last_order_id	L’ID de la dernière commande du client.	Webhook customers/purchasing_summary de Shopify
shopify_zipcode	Le code postal du client, issu de son adresse par défaut.	Webhooks customers/create et customers/update de Shopify
shopify_province	La province du client, issue de son adresse par défaut.	Webhooks customers/create et customers/update de Shopify
shopify_locale	La locale du client (par exemple, en ou fr-CA), définie à partir de la langue du navigateur collectée par le pixel web de Braze jusqu’à ce qu’il passe une commande, puis mise à jour à partir de la locale de son dernier checkout.	Pixel web de Braze, webhooks orders/* de Shopify, remplissage rétroactif des clients historiques

Remarque

Shopify ne fournit plus le nom de la dernière commande d’un client. Braze ne définit donc pas d’attribut shopify_last_order_name. Les profils qui ont déjà une valeur la conservent, mais celle-ci n’est plus mise à jour.

Personnalisation Liquid

Pour ajouter une personnalisation Liquid à vos attributs personnalisés Shopify, sélectionnez + Personnalisation. Sélectionnez ensuite Attributs personnalisés comme type de personnalisation.

Après avoir sélectionné votre attribut personnalisé, saisissez une valeur par défaut et copiez l’extrait de code Liquid dans votre message.

Attributs standard Shopify pris en charge

Remarque

Tous les attributs proviennent de la REST API de Braze.

• E-mail
• Prénom
• Nom
• Téléphone
• Ville
• Pays

Remarque

Braze met à jour les attributs personnalisés Shopify pris en charge et les attributs standard de Braze uniquement si les données diffèrent de celles du profil utilisateur existant. Par exemple, si les données Shopify entrantes contiennent le prénom Bob et que Bob figure déjà comme prénom dans le profil utilisateur Braze, Braze ne déclenchera pas de mise à jour et aucun point de donnée ne vous sera facturé.

Collecte de données du SDK

Pour en savoir plus sur les données collectées par les SDK de Braze, consultez la section Collecte de données du SDK.

Remplissage historique

Les données historiques de Shopify sont importées à partir d’une période antérieure à la connexion de Braze. Lors de la configuration, vous choisissez jusqu’où remonter dans le temps pour importer les événements de commande et les profils clients. Chaque période est calculée à rebours à partir de la date à laquelle vous finalisez votre intégration.

Lors de la configuration de l’intégration standard de Shopify ou de la configuration de l’intégration personnalisée de Shopify, vous pouvez activer le remplissage historique pour inclure vos anciens clients et vos anciennes commandes dans vos Segments, Campaigns et Canvas. Une fois cette option activée, sélectionnez :

• Une plage de dates pour les commandes : 90 derniers jours, Année écoulée ou 2 dernières années (par défaut : 90 derniers jours)
• Une plage de dates pour les profils clients : Année écoulée, 2 dernières années ou Depuis toujours (par défaut : Depuis toujours)

Avant que vous ne finalisiez la configuration, Braze affiche pour chaque option une estimation du nombre d’enregistrements et du temps de traitement. Une fois le remplissage terminé, les périodes sélectionnées apparaissent sous forme de dates précises sur la page partenaire de Shopify. Ces choix ne peuvent plus être modifiés une fois la configuration terminée.

Lorsque Braze importe vos clients Shopify, il leur attribue le type d’external_id que vous avez choisi dans vos paramètres de configuration.

Remarque

Si vous êtes déjà client de Braze et que vous avez des Campaigns ou des Canvas actifs, vérifiez l’impact des clients et des événements de commande importés sur vos Segments et vos parcours avant d’activer le remplissage historique. Le remplissage historique ne met pas à jour de manière rétroactive les utilisateurs qui se trouvent déjà dans des Campaigns ou des Canvas actifs.

Si vous prévoyez d’intégrer avec un ID externe personnalisé (que ce soit pour l’intégration standard ou l’intégration personnalisée), vous devrez ajouter votre ID externe personnalisé en tant que métachamp client Shopify à tous les profils clients Shopify existants, puis effectuer le backfill historique.

Comment Braze sélectionne les données historiques

Braze utilise les champs de date Shopify suivants lors du chargement initial :

Si vous migrez des commandes historiques vers Shopify en conservant leurs dates de création d’origine, Braze importe uniquement les commandes dont la date de création se situe dans la période de commandes que vous avez sélectionnée.

Configurer le remplissage historique de Shopify

1. Sélectionnez Activer le remplissage historique à l’étape Suivre les données Shopify.
2. Choisissez une plage de dates pour les commandes et une autre pour les profils clients. Vérifiez les estimations du nombre d’enregistrements et du temps de traitement correspondant à vos choix.
3. Une fois la configuration de votre intégration terminée, Braze lance la synchronisation initiale des données. Vous pouvez suivre sa progression dans l’onglet Données Shopify des paramètres de votre intégration.

Vitesse et durée de synchronisation du remplissage

Le remplissage historique est effectué par l’intégration Shopify de Braze (et non par le SDK de Braze) et démarre automatiquement dès que vous finalisez la configuration de l’intégration.

Une fois le remplissage historique activé, Braze importe par lots les événements de commande et les profils clients depuis Shopify. Les événements de commande et les profils clients se synchronisent selon des calendriers distincts : l’un peut donc se terminer avant l’autre. Les remplissages volumineux sont divisés en plages de dates parallèles afin de pouvoir s’exécuter simultanément.

La durée de synchronisation dépend du volume de données historiques de votre boutique et des périodes sélectionnées. Pour les boutiques qui enregistrent un grand volume de commandes ou disposent d’une large base de clients, le remplissage peut prendre plus de temps. Il n’est pas possible de modifier la vitesse du remplissage ni de demander une synchronisation plus rapide.

Données synchronisées

Lors de la synchronisation initiale des données, Braze importe les événements de commande et les profils utilisateurs décrits dans la section Comment Braze sélectionne les données historiques. Lorsque Braze importe vos clients Shopify, il leur attribue le type d’external_id que vous avez choisi dans vos paramètres de configuration.

Le tableau suivant récapitule les données incluses dans ce chargement initial.