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.

Suivi des événements Shopify

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
{
    "name": "ecommerce.checkout_started",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "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",
        "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
{
    "name": "ecommerce.order_placed",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "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
{
    "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,
        "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
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 son panier d’achat
Cas d’utilisation: Abandon de panier

Pour les toiles de panier abandonné, vous devez d’abord ajouter l’étiquette Liquid du panier d’achat initial pour obtenir le contexte du panier d’achat dans votre message.

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

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

Événement: ecommerce.checkout_started
Type : Événement recommandé
Déclenché: Lorsqu’un client ajoute, supprime ou met à jour son panier d’achat
Cas d’utilisation: Abandon du paiement

Pour les toiles Abandoned Checkout, 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 termine avec succès la procédure de paiement et passe une commande
Cas d’utilisation: Confirmation de commande, reciblage après 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
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 remplie et prête à être expédiée
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

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
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
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
Cas d’utilisation: Série d’e-mails 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 pour vos attributs personnalisés Shopify, sélectionnez + Personnalisation. Sélectionnez ensuite Attributs personnalisés comme type de personnalisation.

La section "Ajouter une personnalisation" avec la liste déroulante "Attribut" é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.

Coller 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 de Braze, consultez la rubrique Collecte de données des SDK.

Remblai historique

Lors de l’onboarding de votre boutique Shopify, vous pouvez lancer une synchronisation initiale des données par le biais d’un backfill historique afin d’engager immédiatement le dialogue avec vos clients. Dans le cadre de ce backfill, Braze effectuera une synchronisation initiale des données de tous les clients et de toutes les commandes passées au cours des 90 derniers jours précédant votre connexion à l’intégration Shopify. Lorsque Braze importe vos clients Shopify, nous leur attribuons le type external_id que vous avez choisi dans vos paramètres de configuration.

Mise en place de l’historique de Shopify

  1. Activez le remplissage historique dans l’étape Suivi des données Shopify.

L'étape "Suivre les données de Shopify" de l'intégration de Shopify montrant l'historique des remblais sélectionnés..

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

La page des paramètres d'intégration de Shopify avec un curseur indiquant que les événements sont activement synchronisés.

Données synchronisées

Pour la synchronisation initiale des données, Braze importera les clients et les commandes passées au cours des 90 derniers jours précédant votre connexion à l’intégration Shopify. Lorsque Braze importe vos clients Shopify, il leur attribue le type external_id que vous avez choisi dans vos paramètres de configuration.

CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!