Shopify-Daten-Features

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

Getrackte Shopify-Events

Die Shopify-Integration nutzt die empfohlenen E-Commerce-Events, um wichtiges Einkaufsverhalten zu erfassen. Beispiele für die Umsetzung und Marketing-Strategien mit diesen Events finden Sie in den E-Commerce-Anwendungsfällen.

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

• 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
Getriggert: Wenn eine Kund:in eine Produktseite aufruft
Datenquelle: Braze SDKs
Anwendungsfall: Browse Abandonment

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
Getriggert: Wenn eine Kund:in Artikel zum Warenkorb hinzufügt, daraus entfernt oder aktualisiert
Datenquelle: Braze SDKs
Anwendungsfall: Warenkorb-Abbruch

Für Canvases zum Warenkorb-Abbruch müssen Sie zunächst den Liquid-Tag für den Warenkorb 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 darüber, wie Sie eine Liquid-for-Schleife einrichten, um alle Produkte dynamisch in Ihre E-Mail einzufügen, finden Sie unter Personalisierung von Produkten bei Warenkorb-Abbruch für E-Mails.

Event: ecommerce.checkout_started
Typ: Empfohlenes Event
Getriggert: Wenn eine Nutzer:in zur Kassenseite navigiert
Datenquelle: Braze REST API
Anwendungsfall: Abbruch der Kaufabwicklung

Wichtig

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

Für Canvases zum Checkout-Abbruch 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 die Produkte in Ihrem Warenkorb zum Zeitpunkt des Checkouts zu referenzieren.

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
Getriggert: Wenn eine Nutzer:in den Bezahlvorgang erfolgreich abschließt und eine Bestellung aufgibt
Datenquelle: Braze REST API
Anwendungsfall: Auftragsbestätigung, Retargeting nach dem 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 abgeschlossen“ enthält keine Produkt-URLs oder Bild-URLs. Daher müssen Sie die Kataloge-Liquid-Personalisierung verwenden, wie unter Personalisierung von Produkten bei Warenkorb-Abbruch für E-Mails beschrieben.

Event: shopify_fulfilled_order
Typ: Angepasstes Event
Getriggert: Wenn die Bestellung einer Nutzer:in erfüllt und versandfertig ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Fulfillment-Update

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

Event: shopify_partially_fulfilled_order
Typ: Angepasstes Event
Getriggert: Wenn ein Teil der Bestellung einer Nutzer:in erfüllt und versandfertig ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Fulfillment-Update

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

Event: shopify_paid_order
Typ: Angepasstes Event
Getriggert: Wenn die Bestellung einer Nutzer:in in Shopify als bezahlt markiert wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Zahlungsbestätigung

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

Event: ecommerce.order_cancelled
Typ: Empfohlenes Event
Getriggert: Wenn die Bestellung einer Nutzer:in storniert wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Bestätigung der Auftragsstornierung

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

Event: ecommerce.order_refunded
Typ: Empfohlenes Event
Getriggert: Wenn die Bestellung einer Nutzer:in erstattet wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Erstattungsbestätigung

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

Event: shopify_account_login
Typ: Angepasstes Event
Getriggert: Wenn sich eine Nutzer:in bei ihrem Konto anmeldet
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 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
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 den gesamten Bestellverlauf ausgegeben hat.
shopify_order_count	Die Anzahl der Bestellungen, die mit dieser Kund:in verknüpft sind. Test- und archivierte Bestellungen werden nicht gezä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 in der Auftragsressource.
shopify_zipcode	Die Postleitzahl der Kund:in aus der Standardadresse.
shopify_province	Die Provinz der Kund:in aus der Standardadresse.

Wichtig

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

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

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

Liquid-Personalisierung

Um eine Liquid-Personalisierung für Ihre angepassten Shopify-Attribute hinzuzufügen, wählen Sie + Personalization. Wählen Sie dann als Personalisierungstyp Custom Attributes 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 die unterstützten angepassten 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 existiert, löst Braze kein Update aus und es wird Ihnen kein Datenpunkt berechnet.

SDK-Datenerfassung

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

Historischer Backfill

Historische Shopify-Daten werden importiert, bevor Sie Braze verbinden – Bestell-Events aus den letzten 90 Tagen und Kundendaten aus dem letzten Jahr. Beide Zeiträume werden ab dem Datum zurückgerechnet, an dem Sie Ihre Integration abschließen.

Über die Shopify-Standardintegration oder die angepasste Shopify-Integration können Sie den historischen Backfill aktivieren, um vergangene Kund:innen anzusprechen. Dabei werden Ihre Shopify-Bestellungen (bestellbezogene Events) aus den letzten 90 Tagen und Nutzerprofile aus dem letzten Jahr 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 gewählt haben.

Hinweis

Wenn Sie bereits Braze nutzen und aktive Campaigns oder Canvases haben, prüfen Sie, wie sich importierte Kund:innen und Bestell-Events auf Ihre Segmente und Journeys auswirken, bevor Sie den historischen Backfill aktivieren.

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.

Einrichten des historischen Shopify-Backfills

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

2. Nachdem Sie Ihre Integration eingerichtet haben, beginnt Braze mit der ersten Datensynchronisation. Sie können den Fortschritt auf dem Tab Shopify Data in Ihren Integrationseinstellungen überwachen.

Synchronisierte Daten

Für die anfängliche Datensynchronisation importiert Braze Bestell-Events aus den letzten 90 Tagen und Nutzerprofile aus dem letzten Jahr, jeweils zurückgerechnet ab dem Datum, 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 gewählt haben.

Die folgende Tabelle fasst die Daten zusammen, die in diesem anfänglichen Import enthalten sind.