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-Ereignisse

Die Shopify-Integration verwendet empfohlene E-Commerce-Ereignisse, um wichtige Einkaufsverhalten zu erfassen. Implementierungsbeispiele und Marketing-Strategien mit diesen Ereignissen 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.

• beispiel-payload
• shopify-ereignisse

• 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-Ereignisse bereitstellt. In seltenen Fällen können vorübergehende Probleme bei Shopify dazu führen, dass diese Eigenschaften fehlen, was dazu führen kann, dass betroffene Ereignisse verworfen werden.

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

Ereignis: ecommerce.product_viewed
Typ: Empfohlenes Ereignis
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 Ihre Shopify-Site-Domain vor der URL hinzu.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

Ereignis: ecommerce.cart_updated
Typ: Empfohlenes Ereignis
Ausgelöst: Wenn Kund:innen einen Artikel zum Warenkorb hinzufügen, daraus entfernen oder den Warenkorb aktualisieren
Datenquelle: Braze SDKs
Anwendungsfall: Warenkorb-Abbruch

Für Canvases mit abgebrochenem Warenkorb müssen Sie zunächst den anfänglichen Warenkorb-Liquid-Tag hinzufügen, um den Kontext des Warenkorbs in Ihrer Nachricht 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 zum Aufbau einer Liquid-for-Schleife, um dynamisch alle Produkte in Ihre E-Mail einzufügen, finden Sie unter Personalisierung abgebrochener Warenkorb-Produkte für E-Mails.

Ereignis: ecommerce.checkout_started
Typ: Empfohlenes Ereignis
Ausgelöst: Wenn Nutzer:innen zur Checkout-Seite navigieren
Datenquelle: Braze REST API
Anwendungsfall: Checkout-Abbruch

Wichtig

Wenn Kund:innen Shop Pay als beschleunigte Checkout-Option verwenden, kann Shopify bestimmte Standard-Checkout-Ereignisse umgehen (z. B. den Shopify-Checkout-Started-Webhook). Das bedeutet, dass Braze möglicherweise nicht die erforderlichen Daten erhält, um das Checkout-Token-Alias hinzuzufügen, was sich auf das Checkout-Abbruch-Tracking und die Nutzerprofil-Zuordnung auswirken kann.

Für Canvases mit abgebrochenem Checkout 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 }}

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

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 completed“ enthält keine Produkt-URLs oder Bild-URLs. Daher müssen Sie die Liquid-Personalisierung über Kataloge verwenden, wie unter Personalisierung abgebrochener Warenkorb-Produkte für E-Mails beschrieben.

Ereignis: shopify_fulfilled_order
Typ: Angepasstes Event
Ausgelöst: Wenn die Bestellung von Nutzer:innen ausgeführt und zum Versand bereit ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Erfüllungsaktualisierung

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Gesamtrabatte	{{event_properties.${total_discounts}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
Bestellstatus-URL	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Stornierungszeitpunkt	{{event_properties.${cancelled_at}}}
Abschlusszeitpunkt	{{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}}
Erfüllungsstatus	{{event_properties.${fulfillment_status}}}
Versandstatus der Erfüllung	{{event_properties.${fulfillments}[0].shipment_status}}
Status	{{event_properties.${fulfillments}[0].status}}
Tracking-Unternehmen der Erfüllung	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Tracking-Nummer der Erfüllung	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Tracking-Nummern der Erfüllung	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
Tracking-URL der Erfüllung	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
Tracking-URLs der Erfüllung	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Erfüllungsstatus	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Erfüllungsname	{{event_properties.${fulfillments}[0].line_items[0].name}}
Erfüllungspreis	{{event_properties.${fulfillments}[0].line_items[0].price}}
Erfüllungs-Produkt-ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Erfüllungsmenge	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Erfüllung – Versand erforderlich	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Erfüllungs-SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Erfüllungstitel	{{event_properties.${fulfillments}[0].line_items[0].title}}
Erfüllungsanbieter	{{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}}

Ereignis: shopify_partially_fulfilled_order
Typ: Angepasstes Event
Ausgelöst: Wenn ein Teil der Bestellung von Nutzer:innen ausgeführt und zum Versand bereit ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Erfüllungsaktualisierung

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Gesamtrabatte	{{event_properties.${total_discounts}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
Bestellstatus-URL	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Stornierungszeitpunkt	{{event_properties.${cancelled_at}}}
Abschlusszeitpunkt	{{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}}
Erfüllungsstatus	{{event_properties.${fulfillment_status}}}
Versandstatus der Erfüllung	{{event_properties.${fulfillments}[0].shipment_status}}
Erfüllungsstatus	{{event_properties.${fulfillments}[0].status}}
Tracking-Unternehmen der Erfüllung	{{event_properties.${fulfillments}[0].tracking_company}}
Tracking-Nummer der Erfüllung	{{event_properties.${fulfillments}[0].tracking_number}}
Tracking-Nummern der Erfüllung	{{event_properties.${fulfillments}[0].tracking_numbers}}
Tracking-URL der Erfüllung	{{event_properties.${fulfillments}[0].tracking_url}}
Tracking-URLs der Erfüllung	{{event_properties.${fulfillments}[0].tracking_urls}}
Erfüllungsstatus	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Erfüllungsname	{{event_properties.${fulfillments}[0].line_items[0].name}}
Erfüllungspreis	{{event_properties.${fulfillments}[0].line_items[0].price}}
Erfüllungs-Produkt-ID	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Erfüllungsmenge	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Erfüllung – Versand erforderlich	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
Erfüllungs-SKU	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Erfüllungstitel	{{event_properties.${fulfillments}[0].line_items[0].title}}
Erfüllungsanbieter	{{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}}

Ereignis: 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}}}
Bestellstatus-URL	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Stornierungszeitpunkt	{{event_properties.${cancelled_at}}}
Gesamtrabatte	{{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}}

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

Variable	Liquid-Templating
Bestell-ID	{{event_properties.${order_id}}}
Gesamtpreis	{{event_properties.${total_price}}}
Gesamtrabatte	{{event_properties.${total_discounts}}}
Bestätigt	{{event_properties.${confirmed}}}
Bestellstatus-URL	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Stornierungszeitpunkt	{{event_properties.${cancelled_at}}}
Tags	{{event_properties.${tags}}}
Rabattcodes	{{event_properties.${discount_codes}}}
Erfüllungsstatus	{{event_properties.${fulfillment_status}}}
Erfüllungen	{{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}}
Erfüllungsstatus	{{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}}

Ereignis: ecommerce.order_refunded
Typ: Empfohlenes Ereignis
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}}

Ereignis: shopify_account_login
Typ: Angepasstes Event
Ausgelöst: Wenn sich Nutzer:innen in ihr Konto einloggen
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 Kauf-Filter, Liquid-Tags, aktionsbasierte Trigger und Analytics das Ereignis ecommerce.order_placed verwenden.

Unterstützte angepasste Shopify-Attribute

Hinweis

Alle Attribute stammen aus der Braze REST API.

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

Attributname	Beschreibung
shopify_total_spent	Der Gesamtbetrag, den die Kund:in über die gesamte Bestellhistorie hinweg ausgegeben hat.
shopify_order_count	Die Anzahl der Bestellungen, die mit dieser Kund:in verknüpft sind. Test- und archivierte Bestellungen werden nicht mitgezählt.
shopify_last_order_id	Die ID der letzten Bestellung der Kund:in.
shopify_last_order_name	Der Name der letzten Bestellung der Kund:in. Dieser steht in direktem Zusammenhang mit dem Feld name der Bestellressource.
shopify_zipcode	Die Postleitzahl der Kund:in aus der Standardadresse.
shopify_province	Die Provinz/das Bundesland der Kund:in aus der Standardadresse.

Wichtig

Ein bekanntes Problem mit der aktuellen Shopify-API-Version verhindert, dass das Nutzer:innen-Attribut shopify_last_order_name korrekt befüllt wird. Die Auswirkungen auf Nutzer:innen sind wie folgt:

• Bestehende Nutzer:innen: Für alle Nutzer:innen, die bereits einen Wert für shopify_last_order_name haben, bleibt dieser Wert bestehen, wird aber durch nachfolgende Bestellungen nicht aktualisiert.
• Neue Nutzer:innen: Für alle neuen Nutzer:innen wird das Feld nicht befüllt und bleibt leer oder null.

Diese Seite wird aktualisiert, sobald Shopify das Problem behoben hat.

Liquid-Personalisierung

Um Liquid-Personalisierung für Ihre angepassten Shopify-Attribute hinzuzufügen, wählen Sie + Personalisierung. Wählen Sie dann Custom Attributes 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 dann, 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 vorhanden ist, löst Braze kein Update aus, und es wird kein Datenpunkt berechnet.

SDK-Datenerfassung

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

Historischer Datenimport

Historische Shopify-Daten werden importiert, bevor Sie Braze verbinden – Bestellereignisse der letzten 90 Tage und Kundendaten des letzten Jahres. Beide Zeiträume werden ab dem Datum zurückgerechnet, an dem Sie Ihre Integration abschließen.

Über die Shopify-Standardintegration oder die benutzerdefinierte Shopify-Integration können Sie den historischen Datenimport aktivieren, um vergangene Kund:innen und Bestellungen in Segmente, Campaigns und Canvases einzubeziehen. Dabei werden Ihre Shopify-Bestellungen (bestellungsbezogene Events) der letzten 90 Tage und Nutzerprofile des letzten Jahres importiert. Beide Zeiträume werden ab dem Datum zurückgerechnet, an dem Sie Ihre Integration abschließen.

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 sind und aktive Campaigns oder Canvases haben, prüfen Sie vor dem Aktivieren des historischen Datenimports, wie importierte Kund:innen und Bestellereignisse sich auf Ihre Segmente und Journeys auswirken. Der historische Datenimport aktualisiert nicht rückwirkend Nutzer:innen, die sich bereits in aktiven Campaigns oder Canvases befinden.

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.

Wie Braze historische Daten auswählt

Braze verwendet beim initialen Laden die folgenden Shopify-Datumsfelder:

Wenn Sie historische Bestellungen in Shopify migrieren und deren ursprüngliches Erstellungsdatum beibehalten, importiert Braze nur Bestellungen, die in den letzten 90 Tagen erstellt wurden.

Historischen Shopify-Datenimport einrichten

1. Aktivieren Sie den historischen Datenimport im Schritt Track Shopify data.

2. Nachdem Sie Ihre Integrationseinrichtung abgeschlossen haben, beginnt Braze mit der initialen Datensynchronisierung. Sie können den Fortschritt auf dem Tab Shopify Data in Ihren Integrationseinstellungen verfolgen.

Synchronisierungsrate und Timing

Der historische Datenimport wird durch die Shopify-Integration von Braze durchgeführt – nicht durch das Braze SDK – und startet automatisch, wenn Sie die Integrationseinrichtung abschließen.

Nachdem Sie den historischen Datenimport aktiviert haben, importiert Braze Bestellereignisse und Kundenprofile von Shopify in Stapeln. Bestellereignisse und Kundenprofile werden auf separaten Zeitachsen synchronisiert, sodass eines vor dem anderen abgeschlossen sein kann.

Die Synchronisierungsdauer hängt davon ab, wie viele historische Daten sich in Ihrem Shop befinden. Shops mit hohem Bestellvolumen oder großem Kundenstamm benötigen möglicherweise länger für den Datenimport. Die Geschwindigkeit des Datenimports kann nicht geändert und eine schnellere Synchronisierung nicht angefordert werden.

Synchronisierte Daten

Für die initiale Datensynchronisierung importiert Braze die Bestellereignisse und Nutzerprofile, die unter Wie Braze historische Daten auswählt 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 im initialen Laden enthalten sind.