Shopify-Daten-Features

Dieser Artikel bietet eine Übersicht über die Braze-Shopify-Features – einschließlich der Shopify-Daten, die getrackt werden, sowie Beispiel-Payloads, historische Backfills und Produktsynchronisationen.

Erfasste Shopify-Events

Die Shopify-Integration nutzt empfohlene E-Commerce-Events, um wichtige Einkaufsverhalten zu erfassen. Implementierungsbeispiele und Marketingstrategien mit diesen Events finden Sie unter E-Commerce-Anwendungsfälle.

Wichtig

Die Shopify-Integration unterstützt Shopify-Webhooks für die Erstellung und Aktualisierung von Kund:innen, die sich in Ihren Datenkonfigurationseinstellungen befinden. Wenn ein Nutzerprofil in Shopify erstellt oder aktualisiert wird, wird ein entsprechendes Nutzerprofil in Braze erstellt oder aktualisiert.

Diese Aktionen triggern keine angepassten Events in Braze und dienen ausschließlich dazu, Shopify-Nutzerdaten mit Braze zu synchronisieren. Die synchronisierten Daten umfassen angepasste Attribute, Standardattribute und, sofern in Ihrer Konfiguration aktiviert, den Status von Abo-Gruppen.

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

Hinweis

Braze ist darauf angewiesen, dass Shopify die erforderlichen Event-Eigenschaften (wie cart_id oder cart_token) für E-Commerce-Events bereitstellt. In seltenen Fällen können vorübergehende Probleme bei Shopify dazu führen, dass diese Eigenschaften fehlen, wodurch die betroffenen Events verworfen werden können.

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

Event: ecommerce.product_viewed
Typ: Empfohlenes Event
Ausgelöst: Wenn Kund:innen eine Produktseite aufrufen
Datenquelle: Braze SDKs
Anwendungsfall: Browse-Abbruch

Variable	Liquid-Templating
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}}} Fügen Sie die Domain Ihrer Shopify-Website vor der URL ein.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

Event: ecommerce.cart_updated
Typ: Empfohlenes Event
Ausgelöst: Wenn Kund:innen ihren Warenkorb ergänzen, Artikel entfernen oder ihn aktualisieren
Datenquelle: Braze SDKs
Anwendungsfall: Warenkorb-Abbruch

Für Warenkorb-Abbruch-Canvases müssen Sie zunächst den initialen Warenkorb-Liquid-Tag hinzufügen, um in Ihrer Nachricht Kontext zum Warenkorb zu erhalten.

1

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

Anschließend können Sie die folgenden Warenkorb-Liquid-Tags in Ihre Nachricht einfügen.

Variable	Liquid-Templating
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> }}

Tipp

Weitere Informationen dazu, wie Sie eine Liquid-for-Schleife erstellen, um alle Produkte dynamisch in Ihre E-Mail einzufügen, finden Sie unter Produktpersonalisierung bei Warenkorb-Abbruch für E-Mails.

Event: ecommerce.checkout_started
Typ: Empfohlenes Event
Ausgelöst: Wenn Nutzer:innen die Checkout-Seite aufrufen
Datenquelle: Braze REST API
Anwendungsfall: Checkout-Abbruch

Wichtig

Wenn Kund:innen Shop Pay als beschleunigte Checkout-Option nutzen, kann Shopify bestimmte Standard-Checkout-Events (wie den Shopify-Webhook „Checkout gestartet“) überspringen. Das bedeutet, dass Braze möglicherweise nicht die Daten erhält, die zum Hinzufügen des Checkout-Token-Alias erforderlich sind. Dies kann sich auf das Tracking von Checkout-Abbrüchen und den Abgleich von Nutzerprofilen auswirken.

Für Checkout-Abbruch-Canvases müssen Sie zunächst den folgenden Liquid-Tag verwenden:

1
2

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

Anschließend können Sie die folgenden Liquid-Tags in Ihre Nachricht einfügen, um auf die Produkte in Ihrem Warenkorb zum Zeitpunkt des Checkouts zu verweisen.

Variable	Liquid-Templating
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 }}

Event: ecommerce.order_placed
Typ: Empfohlenes Event
Ausgelöst: Wenn Nutzer:innen den Checkout-Prozess erfolgreich abschließen und eine Bestellung aufgeben
Datenquelle: Braze REST API
Anwendungsfall: Bestellbestätigung, Retargeting nach dem Kauf, Upselling oder Cross-Selling

Variable	Liquid-Templating
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}}

Tipp

Der Shopify-Webhook „Checkout abgeschlossen“ enthält keine Produkt-URLs oder Bild-URLs. Daher müssen Sie die Liquid-Personalisierung mit Katalogen verwenden, wie unter Produktpersonalisierung bei Warenkorb-Abbruch für E-Mails beschrieben.

Event: shopify_fulfilled_order
Typ: Angepasstes Event
Ausgelöst: Wenn die Bestellung von Nutzer:innen ausgeführt wurde und versandbereit ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Fulfillment-Update

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Rabatte gesamt	{{event_properties.${total_discounts}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
URL des Bestellstatus	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Zeitstempel der Stornierung	{{event_properties.${cancelled_at}}}
Zeitstempel des Abschlusses	{{event_properties.${closed_at}}}
Artikel-ID	{{event_properties.${line_items}[0].product_id}}
Artikelmenge	{{event_properties.${line_items}[0].quantity}}
Artikel-SKU	{{event_properties.${line_items}[0].sku}}
Artikeltitel	{{event_properties.${line_items}[0].title}}
Artikelanbieter	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Fulfillment-Status	{{event_properties.${fulfillment_status}}}
Fulfillment-Versandstatus	{{event_properties.${fulfillments}[0].shipment_status}}
Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment-Versanddienstleister	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Fulfillment-Sendungsnummer	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Fulfillment-Sendungsnummern	{{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-Preis	{{event_properties.${fulfillments}[0].line_items[0].price}}
Fulfillment-Produkt-ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Fulfillment-Menge	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Fulfillment-Versand	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Fulfillment-SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Fulfillment-Titel	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fulfillment-Anbieter	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

Event: shopify_partially_fulfilled_order
Typ: Angepasstes Event
Ausgelöst: Wenn ein Teil der Bestellung von Nutzer:innen ausgeführt wurde und versandbereit ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Fulfillment-Update

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Rabatte gesamt	{{event_properties.${total_discounts}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
URL des Bestellstatus	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Zeitstempel der Stornierung	{{event_properties.${cancelled_at}}}
Zeitstempel des Abschlusses	{{event_properties.${closed_at}}}
Artikel-ID	{{event_properties.${line_items}[0].product_id}}
Artikelmenge	{{event_properties.${line_items}[0].quantity}}
Artikel-SKU	{{event_properties.${line_items}[0].sku}}
Artikeltitel	{{event_properties.${line_items}[0].title}}
Artikelanbieter	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Fulfillment-Status	{{event_properties.${fulfillment_status}}}
Fulfillment-Versandstatus	{{event_properties.${fulfillments}[0].shipment_status}}
Fulfillment-Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment-Versanddienstleister	{{event_properties.${fulfillments}[0].tracking_company}}
Fulfillment-Sendungsnummer	{{event_properties.${fulfillments}[0].tracking_number}}
Fulfillment-Sendungsnummern	{{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-Preis	{{event_properties.${fulfillments}[0].line_items[0].price}}
Fulfillment-Produkt-ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Fulfillment-Menge	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Fulfillment-Versand	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Fulfillment-SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Fulfillment-Titel	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fulfillment-Anbieter	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

Event: shopify_paid_order
Typ: Angepasstes Event
Ausgelöst: Wenn die Bestellung von Nutzer:innen in Shopify als bezahlt markiert wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Zahlungsbestätigung

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
URL des Bestellstatus	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Zeitstempel der Stornierung	{{event_properties.${cancelled_at}}}
Rabatte gesamt	{{event_properties.${total_discounts}}}
Gesamtpreis	{{event_properties.${total_price}}}
Tags	{{event_properties.${tags}}}
Rabattcodes	{{event_properties.${discount_codes}}}
Artikel-ID	{{event_properties.${line_items}[0].product_id}}
Artikelmenge	{{event_properties.${line_items}[0].quantity}}
Artikel-SKU	{{event_properties.${line_items}[0].sku}}
Artikeltitel	{{event_properties.${line_items}[0].title}}
Artikelanbieter	{{event_properties.${line_items}[0].vendor}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

Event: ecommerce.order_cancelled
Typ: Empfohlenes Event
Ausgelöst: Wenn die Bestellung von Nutzer:innen storniert wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Stornierungsbestätigung

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Rabatte gesamt	{{event_properties.${total_discounts}}}
Bestätigt	{{event_properties.${confirmed}}}
URL des Bestellstatus	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Zeitstempel der Stornierung	{{event_properties.${cancelled_at}}}
Tags	{{event_properties.${tags}}}
Rabattcodes	{{event_properties.${discount_codes}}}
Fulfillment-Status	{{event_properties.${fulfillment_status}}}
Fulfillments	{{event_properties.${fulfillments}}}
Artikel-ID	{{event_properties.${line_items}[0].product_id}}
Artikelmenge	{{event_properties.${line_items}[0].quantity}}
Artikel-SKU	{{event_properties.${line_items}[0].sku}}
Artikeltitel	{{event_properties.${line_items}[0].title}}
Artikelanbieter	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Fulfillment-Status	{{event_properties.${line_items}[0].fulfillment_status}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

Event: ecommerce.order_refunded
Typ: Empfohlenes Event
Ausgelöst: Wenn die Bestellung von Nutzer:innen erstattet wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Erstattungsbestätigung

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Bestellnotiz	{event_properties.${note}}}
Artikel-ID	{{event_properties.${line_items}[0].product_id}}
Artikelmenge	{{event_properties.${line_items}[0].quantity}}
Artikel-SKU	{{event_properties.${line_items}[0].sku}}
Artikeltitel	{{event_properties.${line_items}[0].title}}
Artikelanbieter	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

Event: shopify_account_login
Typ: Angepasstes Event
Ausgelöst: Wenn sich Nutzer:innen bei ihrem Konto anmelden
Datenquelle: Braze REST API
Anwendungsfall: Willkommensserie

Variable	Liquid-Templating
source	{{event_properties.${source}}}

Hinweis

Die Shopify-Integration unterstützt derzeit nicht das Befüllen des Braze-Kauf-Events. Daher sollten Kauffilter, Liquid-Tags, aktionsbasierte Trigger und Analytics das Event ecommerce.order_placed verwenden.

Unterstützte angepasste Shopify-Attribute

Hinweis

Alle Attribute stammen aus der Braze REST API.

• beispiel-payload
• angepasste shopify-attribute

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

Attributname	Beschreibung	Datenquelle
shopify_total_spent	Der Gesamtbetrag, den die Kund:in über den gesamten Bestellverlauf ausgegeben hat.	Shopify-Webhook customers/purchasing_summary
shopify_orders_count	Die Anzahl der Bestellungen, die dieser Kund:in zugeordnet sind. Test- und archivierte Bestellungen werden nicht gezählt.	Shopify-Webhook customers/purchasing_summary
shopify_last_order_id	Die ID der letzten Bestellung der Kund:in.	Shopify-Webhook customers/purchasing_summary
shopify_zipcode	Die Postleitzahl aus der Standardadresse der Kund:in.	Shopify-Webhooks customers/create und customers/update
shopify_province	Die Provinz aus der Standardadresse der Kund:in.	Shopify-Webhooks customers/create und customers/update
shopify_locale	Das Gebietsschema der Kund:in (zum Beispiel en oder fr-CA). Es wird anhand der vom Braze-Web-Pixel erfassten Browsersprache gesetzt, bis die Kund:in eine Bestellung aufgibt, und anschließend mit dem Gebietsschema des letzten Checkouts aktualisiert.	Braze-Web-Pixel, Shopify-Webhooks orders/*, historisches Kunden-Backfill

Hinweis

Shopify stellt den Namen der letzten Bestellung einer Kund:in nicht mehr bereit, daher setzt Braze kein Attribut shopify_last_order_name. Profile, die bereits einen Wert haben, behalten ihn, er wird jedoch nicht mehr aktualisiert.

Liquid-Personalisierung

Um Liquid-Personalisierung für Ihre angepassten Shopify-Attribute hinzuzufügen, wählen Sie + Personalisierung aus. Wählen Sie anschließend Angepasste Attribute als Personalisierungstyp aus.

Nachdem Sie Ihr angepasstes Attribut ausgewählt haben, geben Sie einen Standardwert ein und kopieren Sie das Liquid-Snippet in Ihre Nachricht.

Unterstützte Shopify-Standardattribute

Hinweis

Alle Attribute stammen aus der Braze REST API.

• E-Mail
• Vorname
• Nachname
• Telefon
• Ort
• Land

Hinweis

Braze aktualisiert unterstützte angepasste Shopify-Attribute und Braze-Standardattribute nur, wenn sich die Daten vom bestehenden Nutzerprofil unterscheiden. Wenn die eingehenden Shopify-Daten beispielsweise den Vornamen Bob enthalten und Bob bereits als Vorname im Braze-Nutzerprofil hinterlegt ist, löst Braze kein Update aus und Ihnen wird kein Datenpunkt berechnet.

SDK-Datenerfassung

Weitere Informationen darüber, welche Daten von den Braze SDKs erfasst werden, finden Sie unter SDK-Datenerfassung.

Historisches Backfill

Historische Shopify-Daten werden aus dem Zeitraum vor der Verbindung mit Braze importiert. Bei der Einrichtung legen Sie fest, wie weit zurück Bestell-Events und Kundenprofile importiert werden sollen. Jeder Zeitraum wird ab dem Datum zurückgerechnet, an dem Sie Ihre Integration abschließen.

Über die Einrichtung der Shopify-Standardintegration oder die Einrichtung der angepassten Shopify-Integration können Sie das historische Backfill aktivieren, um frühere Kund:innen und Bestellungen in Segments, Campaigns und Canvases einzubeziehen. Wenn Sie es aktivieren, wählen Sie Folgendes aus:

• Einen Datumsbereich für Bestellungen: Letzte 90 Tage, Letztes Jahr oder Letzte 2 Jahre (Standard ist Letzte 90 Tage)
• Einen Datumsbereich für Kundenprofile: Letztes Jahr, Letzte 2 Jahre oder Gesamter Zeitraum (Standard ist Gesamter Zeitraum)

Braze zeigt für jede Option eine geschätzte Anzahl an Datensätzen und die voraussichtliche Verarbeitungszeit an, bevor Sie die Einrichtung abschließen. Nach Abschluss des Backfills werden Ihre ausgewählten Zeiträume als konkrete Daten auf der Shopify-Partnerseite angezeigt. Diese Auswahl kann nach Abschluss der Einrichtung nicht mehr geändert werden.

Wenn Braze Ihre Shopify-Kund:innen importiert, wird der external_id-Typ zugewiesen, den Sie in Ihren Konfigurationseinstellungen ausgewählt haben.

Hinweis

Wenn Sie bereits Braze-Kund:in mit aktiven Campaigns oder Canvases sind, prüfen Sie vor der Aktivierung des historischen Backfills, wie sich importierte Kund:innen und Bestell-Events auf Ihre Segmente und Journeys auswirken. Das historische Backfill aktualisiert Nutzer:innen, die sich bereits in aktiven Campaigns oder Canvases befinden, nicht rückwirkend.

Wenn Sie eine Integration mit einer angepassten externen ID planen (entweder für die Standard-Integration oder die angepasste Integration), müssen Sie Ihre angepasste externe ID als Shopify-Kund:innen-Metafeld zu allen bestehenden Shopify-Kundenprofilen hinzufügen und anschließend den historischen Backfill durchführen.

So wählt Braze historische Daten aus

Braze verwendet beim initialen Laden die folgenden Shopify-Datumsfelder:

Wenn Sie historische Bestellungen zu Shopify migrieren und deren ursprüngliches Erstellungsdatum beibehalten, importiert Braze nur Bestellungen, deren Erstellungsdatum innerhalb des von Ihnen ausgewählten Bestellzeitraums liegt.

Historisches Shopify-Backfill einrichten

1. Wählen Sie im Schritt Shopify-Daten tracken die Option Historisches Backfill aktivieren aus.
2. Wählen Sie einen Datumsbereich für Bestellungen und einen Datumsbereich für Kundenprofile. Prüfen Sie die geschätzten Anzahlen und die Verarbeitungszeit für Ihre Auswahl.
3. Nachdem Sie die Einrichtung Ihrer Integration abgeschlossen haben, startet Braze die initiale Datensynchronisierung. Den Fortschritt können Sie im Tab Shopify-Daten Ihrer Integrationseinstellungen verfolgen.

Synchronisierungsrate und Dauer des Backfills

Das historische Backfill wird von der Shopify-Integration von Braze durchgeführt – nicht vom Braze SDK – und startet automatisch, sobald Sie die Einrichtung der Integration abschließen.

Nachdem Sie das historische Backfill aktiviert haben, importiert Braze Bestell-Events und Kundenprofile in Batches aus Shopify. Bestell-Events und Kundenprofile werden unabhängig voneinander synchronisiert, sodass das eine vor dem anderen abgeschlossen sein kann. Umfangreiche Backfills werden in parallele Datumsbereiche aufgeteilt, damit sie gleichzeitig laufen können.

Die Synchronisierungsdauer hängt davon ab, wie viele historische Daten Ihr Shop enthält und welche Zeiträume Sie ausgewählt haben. Bei Shops mit hohem Bestellvolumen oder großem Kundenstamm kann das Backfill länger dauern. Sie können die Backfill-Geschwindigkeit nicht ändern und keine schnellere Synchronisierung anfordern.

Synchronisierte Daten

Bei der initialen Datensynchronisierung importiert Braze die Bestell-Events und Nutzerprofile, die unter So wählt Braze historische Daten aus beschrieben sind. Wenn Braze Ihre Shopify-Kund:innen importiert, wird der external_id-Typ zugewiesen, den Sie in Ihren Konfigurationseinstellungen ausgewählt haben.

Die folgende Tabelle fasst die Daten zusammen, die beim initialen Laden enthalten sind.