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 comportements d’achat clés. Pour des exemples de déploiement et des stratégies marketing utilisant 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.

• exemple de payload
• événements shopify

• 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 avec Shopify peuvent entraîner l’absence de ces propriétés, ce qui peut provoquer la suppression 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éclenché : Lorsqu’un client consulte une page produit
Source de données : SDK 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éclenché : Lorsqu’un client ajoute, supprime ou met à jour son panier
Source de données : SDK Braze
Cas d’usage : Abandon de panier

Pour les Canvas d’abandon de panier, 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 suivantes du panier 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 en savoir plus sur la création d’une boucle Liquid for afin d’ajouter dynamiquement tous les produits dans votre e-mail, consultez Personnalisation des produits en abandon de panier pour les e-mails.

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

Important

Si un client utilise Shop Pay comme option de paiement accéléré, Shopify peut contourner certains événements de paiement standard (tels que le webhook de début de paiement Shopify). Cela signifie que Braze peut ne pas recevoir les données nécessaires pour ajouter l’alias du jeton de paiement, ce qui peut avoir un impact sur le suivi des abandons de paiement et la réconciliation des profils utilisateurs.

Pour les Canvas d’abandon de paiement, 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 référencer les produits présents dans 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éclenché : Lorsqu’un utilisateur finalise le processus de paiement et passe une commande
Source de données : REST API Braze
Cas d’usage : Confirmation de commande, reciblage post-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 de paiement terminé de Shopify ne contient pas les URL des produits ni les URL des images. Par conséquent, vous devez utiliser la personnalisation Liquid via les catalogues comme mentionné dans Personnalisation des produits en abandon de panier pour les e-mails.

Événement : shopify_fulfilled_order
Type : Événement personnalisé
Déclenché : Lorsque la commande d’un utilisateur est expédiée et prête pour la livraison
Source de données : REST API Braze
Cas d’usage : (Transactionnel) Mise à jour de l’expédition

Variable	Modèle Liquid
Order ID	{{event_properties.${order_id}}}
Total Price	{{event_properties.${total_price}}}
Total Discounts	{{event_properties.${total_discounts}}}
Confirmed Status	{{event_properties.${confirmed}}}
Order Status URL	{{event_properties.${order_status_url}}}
Order Number	{{event_properties.${order_number}}}
Cancelled Timestamp	{{event_properties.${cancelled_at}}}
Closed Timestamp	{{event_properties.${closed_at}}}
Item ID	{{event_properties.${line_items}[0].product_id}}
Item Quantity	{{event_properties.${line_items}[0].quantity}}
Item SKU	{{event_properties.${line_items}[0].sku}}
Item Title	{{event_properties.${line_items}[0].title}}
Item Vendor	{{event_properties.${line_items}[0].vendor}}
Item Name	{{event_properties.${line_items}[0].name}}
Item Properties	{{event_properties.${line_items}[0].properties}}
Item Price	{{event_properties.${line_items}[0].price}}
Shipping Title	{{event_properties.${shipping}[0].title}}
Shipping Price	{{event_properties.${shipping}[0].price}}
Fulfillment Status	{{event_properties.${fulfillment_status}}}
Fulfillment Shipment Status	{{event_properties.${fulfillments}[0].shipment_status}}
Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment Tracking Company	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Fulfillment Tracking Number	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Fulfillment Tracking Numbers	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
Fulfillment Tracking URL	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
Fulfillment Tracking URLs	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Fulfillment Status	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Fulfillment Name	{{event_properties.${fulfillments}[0].line_items[0].name}}
Fulfillment Price	{{event_properties.${fulfillments}[0].line_items[0].price}}
Fulfillment Product ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Fulfillment Quantity	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Fulfillment Shipping	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Fulfillment SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Fulfillment Title	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fulfillment Vendor	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
Variant ID	{{event_properties.${line_items}[0].variant_id}}
Variant Title	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Modèle Liquid
Order ID	{{event_properties.${order_id}}}
Total Price	{{event_properties.${total_price}}}
Total Discounts	{{event_properties.${total_discounts}}}
Confirmed Status	{{event_properties.${confirmed}}}
Order Status URL	{{event_properties.${order_status_url}}}
Order Number	{{event_properties.${order_number}}}
Cancelled Timestamp	{{event_properties.${cancelled_at}}}
Closed Timestamp	{{event_properties.${closed_at}}}
Item ID	{{event_properties.${line_items}[0].product_id}}
Item Quantity	{{event_properties.${line_items}[0].quantity}}
Item SKU	{{event_properties.${line_items}[0].sku}}
Item Title	{{event_properties.${line_items}[0].title}}
Item Vendor	{{event_properties.${line_items}[0].vendor}}
Item Name	{{event_properties.${line_items}[0].name}}
Item Properties	{{event_properties.${line_items}[0].properties}}
Item Price	{{event_properties.${line_items}[0].price}}
Shipping Title	{{event_properties.${shipping}[0].title}}
Shipping Price	{{event_properties.${shipping}[0].price}}
Fulfillment Status	{{event_properties.${fulfillment_status}}}
Fulfillment Shipment Status	{{event_properties.${fulfillments}[0].shipment_status}}
Fulfillment Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment Tracking Company	{{event_properties.${fulfillments}[0].tracking_company}}
Fulfillment Tracking Number	{{event_properties.${fulfillments}[0].tracking_number}}
Fulfillment Tracking Numbers	{{event_properties.${fulfillments}[0].tracking_numbers}}
Fulfillment Tracking URL	{{event_properties.${fulfillments}[0].tracking_url}}
Fulfillment Tracking URLs	{{event_properties.${fulfillments}[0].tracking_urls}}
Fulfillment Status	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Fulfillment Name	{{event_properties.${fulfillments}[0].line_items[0].name}}
Fulfillment Price	{{event_properties.${fulfillments}[0].line_items[0].price}}
Fulfillment Product ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Fulfillment Quantity	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Fulfillment Shipping	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Fulfillment SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Fulfillment Title	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fulfillment Vendor	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
Variant ID	{{event_properties.${line_items}[0].variant_id}}
Variant Title	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Modèle Liquid
Order ID	{{event_properties.${order_id}}}
Confirmed Status	{{event_properties.${confirmed}}}
Order Status URL	{{event_properties.${order_status_url}}}
Order Number	{{event_properties.${order_number}}}
Cancelled Timestamp	{{event_properties.${cancelled_at}}}
Total Discounts	{{event_properties.${total_discounts}}}
Total Price	{{event_properties.${total_price}}}
Tags	{{event_properties.${tags}}}
Discount Codes	{{event_properties.${discount_codes}}}
Item ID	{{event_properties.${line_items}[0].product_id}}
Item Quantity	{{event_properties.${line_items}[0].quantity}}
Item SKU	{{event_properties.${line_items}[0].sku}}
Item Title	{{event_properties.${line_items}[0].title}}
Item Vendor	{{event_properties.${line_items}[0].vendor}}
Item Properties	{{event_properties.${line_items}[0].properties}}
Item Price	{{event_properties.${line_items}[0].price}}
Shipping Title	{{event_properties.${shipping}[0].title}}
Shipping Price	{{event_properties.${shipping}[0].price}}
Variant ID	{{event_properties.${line_items}[0].variant_id}}
Variant Title	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Modèle Liquid
Order ID	{{event_properties.${order_id}}}
Total Price	{{event_properties.${total_price}}}
Total Discounts	{{event_properties.${total_discounts}}}
Confirmed	{{event_properties.${confirmed}}}
Order Status URL	{{event_properties.${order_status_url}}}
Order Number	{{event_properties.${order_number}}}
Cancelled Timestamp	{{event_properties.${cancelled_at}}}
Tags	{{event_properties.${tags}}}
Discount Codes	{{event_properties.${discount_codes}}}
Fulfillment Status	{{event_properties.${fulfillment_status}}}
Fulfillments	{{event_properties.${fulfillments}}}
Item ID	{{event_properties.${line_items}[0].product_id}}
Item Quantity	{{event_properties.${line_items}[0].quantity}}
Item SKU	{{event_properties.${line_items}[0].sku}}
Item Title	{{event_properties.${line_items}[0].title}}
Item Vendor	{{event_properties.${line_items}[0].vendor}}
Item Name	{{event_properties.${line_items}[0].name}}
Item Properties	{{event_properties.${line_items}[0].properties}}
Fulfillment Status	{{event_properties.${line_items}[0].fulfillment_status}}
Shipping Title	{{event_properties.${shipping}[0].title}}
Shipping Price	{{event_properties.${shipping}[0].price}}
Variant ID	{{event_properties.${line_items}[0].variant_id}}
Variant Title	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Modèle Liquid
Order ID	{{event_properties.${order_id}}}
Order Note	{event_properties.${note}}}
Item ID	{{event_properties.${line_items}[0].product_id}}
Item Quantity	{{event_properties.${line_items}[0].quantity}}
Item SKU	{{event_properties.${line_items}[0].sku}}
Item Title	{{event_properties.${line_items}[0].title}}
Item Vendor	{{event_properties.${line_items}[0].vendor}}
Item Name	{{event_properties.${line_items}[0].name}}
Item Properties	{{event_properties.${line_items}[0].properties}}
Item Price	{{event_properties.${line_items}[0].price}}
Variant ID	{{event_properties.${line_items}[0].variant_id}}
Variant Title	{{event_properties.${line_items}[0].variant_title}}

Événement : shopify_account_login
Type : Événement personnalisé
Déclenché : Lorsqu’un utilisateur se connecte à son compte
Source de données : REST API 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 le remplissage de l’événement d’achat de Braze. Par conséquent, les filtres d’achat, les étiquettes Liquid, les déclencheurs par action et les analyses 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.

• example payload
• shopify custom attributes

• shopify tags

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

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

Nom de l’attribut	Description
shopify_total_spent	Le montant total dépensé par le client sur l’ensemble de son historique de commandes.
shopify_order_count	Le nombre de commandes associées à ce client. Les commandes de test et archivées ne sont pas comptabilisées.
shopify_last_order_id	L’ID de la dernière commande du client.
shopify_last_order_name	Le nom de la dernière commande du client. Cet attribut est directement lié au champ name de la ressource de commande.
shopify_zipcode	Le code postal du client issu de son adresse par défaut.
shopify_province	La province du client issue de son adresse par défaut.

Important

Un problème connu avec la version actuelle de l’API Shopify empêche l’attribut utilisateur shopify_last_order_name de se remplir correctement. L’impact sur les utilisateurs est le suivant :

• Utilisateurs existants : Pour tout utilisateur qui possède déjà une valeur pour shopify_last_order_name, cette valeur est conservée mais n’est pas mise à jour par les commandes suivantes.
• Nouveaux utilisateurs : Pour tout nouvel utilisateur, le champ ne se remplit pas et reste vide ou null.

Cette page sera mise à jour après la résolution de ce problème par Shopify.

Personnalisation Liquid

Pour ajouter une personnalisation Liquid à vos attributs personnalisés Shopify, sélectionnez + Personnalisation. Ensuite, sélectionnez 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 ne met à jour les attributs personnalisés Shopify pris en charge et les attributs standard Braze que s’il existe une différence de données par rapport au profil utilisateur existant. Par exemple, si les données entrantes de Shopify contiennent un prénom Bob et que Bob existe déjà comme prénom sur 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 par le SDK

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

Remplissage historique

Les données Shopify historiques sont importées avant que vous ne connectiez Braze : les événements de commandes des 90 derniers jours et les données clients de l’année écoulée. Les deux périodes sont calculées à partir de la date à laquelle vous finalisez votre intégration.

Via la configuration de l’intégration Shopify standard ou la configuration de l’intégration Shopify personnalisée, vous pouvez activer le remplissage historique pour inclure les clients et commandes passés dans les Segments, les Campaigns et les Canvas. Cette opération importe vos commandes Shopify (événements liés aux commandes) des 90 derniers jours et les profils utilisateurs de l’année écoulée. Les deux périodes sont calculées à partir de la date à laquelle vous finalisez votre intégration.

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

Remarque

Si vous êtes un client Braze existant avec des Campaigns ou des Canvas actifs, vérifiez comment les clients importés et les événements de commandes affectent vos Segments et vos parcours avant d’activer le remplissage historique. Le remplissage historique ne met pas à jour rétroactivement les utilisateurs qui sont 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 ces champs de date Shopify lors du chargement initial :

Si vous migrez des commandes historiques dans Shopify en conservant leurs dates de création d’origine, Braze n’importe que les commandes créées au cours des 90 derniers jours.

Configurer le remplissage historique Shopify

1. Activez le remplissage historique dans l’étape Track Shopify data.

2. Après avoir finalisé la configuration de votre intégration, Braze lancera la synchronisation initiale des données. Vous pouvez suivre la progression dans l’onglet Shopify Data de vos paramètres d’intégration.

Vitesse et chronologie de la synchronisation du remplissage

Le remplissage historique est effectué par l’intégration Shopify de Braze — et non par le SDK Braze — et démarre automatiquement lorsque vous finalisez la configuration de l’intégration.

Après avoir activé le remplissage historique, Braze importe les événements de commandes et les profils clients depuis Shopify par lots. Les événements de commandes et les profils clients se synchronisent selon des chronologies distinctes, de sorte que l’un peut se terminer avant l’autre.

Le temps de synchronisation dépend du volume de données historiques dans votre boutique. Les boutiques avec un volume de commandes élevé ou une base de clients importante peuvent prendre plus de temps pour terminer le remplissage. Vous ne pouvez pas modifier la vitesse de remplissage ni demander une synchronisation plus rapide.

Données synchronisées

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

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