Skip to content

Fonctionnalités des données de Shopify

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

Événements Shopify suivis

L’intégration Shopify utilise les événements recommandés pour l’eCommerce pour capturer les principaux comportements d’achat. Pour des exemples de mise en œuvre et des stratégies marketing utilisant ces événements, consultez les cas d’utilisation eCommerce.

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

É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’utilisation : Abandon de navigation

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

Pour les Canvas d’abandon de panier, vous devez d’abord ajouter l’étiquette Liquid du panier d’achat initial afin de disposer du contexte du panier dans votre message.

1

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

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

É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’utilisation : Abandon du paiement

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 de votre panier au moment du paiement.

É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’utilisation : Confirmation de commande, reciblage post-achat, ventes incitatives ou croisées

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

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

É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’utilisation : (Transactionnel) Confirmation de paiement

Événement : shopify_cancelled_order
Type : Événement personnalisé
Déclenché : Lorsque la commande d’un utilisateur est annulée
Source de données : REST API Braze
Cas d’utilisation : (Transactionnel) Confirmation d’annulation de commande

Événement : shopify_order_refunded
Type : Événement personnalisé
Déclenché : Lorsque la commande d’un utilisateur est remboursée
Source de données : REST API Braze
Cas d’utilisation : (Transactionnel) Confirmation de remboursement

É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’utilisation : Série de bienvenue

Attributs personnalisés Shopify pris en charge

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

Personnalisation Liquid

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

La section « Add Personalization » avec la liste déroulante « Attribute » étendue.

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

Collage d'un extrait de code Liquid dans un message.

Attributs standard Shopify pris en charge

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

Collecte de données SDK

Pour plus d’informations sur les données collectées par les SDK Braze, consultez la section Collecte de données SDK.

Backfill historique

Les données historiques Shopify sont importées avant la connexion de Braze : les événements de commande 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 standard Shopify ou la configuration de l’intégration personnalisée Shopify, vous pouvez activer le backfill historique pour cibler vos anciens clients. Cette fonctionnalité 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, le type external_id que vous avez choisi dans vos paramètres de configuration leur est attribué.

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.

Mise en place du backfill historique Shopify

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

L'étape « Track Shopify data » de l'intégration Shopify montrant le backfill historique sélectionné.

  1. Une fois la configuration de votre intégration terminée, Braze lance la synchronisation initiale des données. Vous pouvez suivre la progression dans l’onglet Shopify Data de vos paramètres d’intégration.

La page des paramètres d'intégration Shopify avec un indicateur de chargement montrant que les événements sont en cours de synchronisation.

Données synchronisées

Lors de la synchronisation initiale, Braze importe les événements de commande des 90 derniers jours et les profils utilisateurs de l’année écoulée, chaque période étant calculée à partir de la date à laquelle vous finalisez votre intégration. Lorsque Braze importe vos clients Shopify, le type external_id que vous avez choisi dans vos paramètres de configuration leur est attribué.

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