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 verwendet empfohlene E-Commerce-Events, um wichtige Einkaufsverhaltensweisen 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: Abgebrochenes Browsen

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}.sku}}
type	event_properties.${type}

Event: ecommerce.cart_updated
Typ: Empfohlenes Event
Ausgelöst: Wenn Kund:innen ihrem Warenkorb etwas hinzufügen, daraus entfernen oder ihn aktualisieren
Datenquelle: Braze SDKs
Anwendungsfall: Warenkorb-Abbruch

Für Canvases zu Warenkorb-Abbrüchen 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.sku }}

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 für E-Mails zu Warenkorb-Abbrüchen.

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 für gestartete Checkouts) ü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 Canvases zu Checkout-Abbrüchen 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 }}

Sie können außerdem mit Event-Eigenschaften aus dem auslösenden Event ecommerce.checkout_started personalisieren, etwa mit source und checkout_url. Diese Eigenschaften werden nicht im Warenkorb gespeichert und sind daher über den Tag {% shopping_cart %} nicht verfügbar. Verweisen Sie in einem Canvas zu Checkout-Abbrüchen über den Canvas-Kontext darauf:

Variable	Liquid-Templating
source	{{context.${source}}}
checkout_url	{{context.${metadata}.checkout_url}}

Zum Beispiel in einer E-Mail zu einem abgebrochenen Checkout:

1
2
3
4
5

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{% for item in shopping_cart.products %}
  {{ item.product_name }} / SKU: {{ item.metadata.sku }}
{% endfor %}
<a href="{{context.${metadata}.checkout_url}}">Return to checkout</a>

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

Wenn bereits ein anderes System Order-Placed-Events an Braze sendet, können Sie dieses Event für einen Shop im Schritt „Track Shopify data“ mit Send Order Placed events from another source deaktivieren. Braze überspringt dann ecommerce.order_placed für die Live- und nachträglich importierten Bestellungen dieses Shops, während die anderen Bestell-Events, shopify_paid_order und die Kaufattribute weiterhin aktualisiert werden. Einzelheiten finden Sie unter Standard-Dateneinrichtung.

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 für abgeschlossene Checkouts enthält keine Produkt-URLs oder Bild-URLs. Daher müssen Sie die Liquid-Personalisierung über Kataloge verwenden, wie unter Produktpersonalisierung für E-Mails zu Warenkorb-Abbrüchen 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}}}
Bestellstatus-URL	{{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}}
Versandbezeichnung	{{event_properties.${shipping}[0].title}}
Versandkosten	{{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}}}
Bestellstatus-URL	{{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}}
Versandbezeichnung	{{event_properties.${shipping}[0].title}}
Versandkosten	{{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}}}
Bestellstatus-URL	{{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}}
Versandbezeichnung	{{event_properties.${shipping}[0].title}}
Versandkosten	{{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}}}
Bestellstatus-URL	{{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}}
Versandbezeichnung	{{event_properties.${shipping}[0].title}}
Versandkosten	{{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 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 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 der:die Kund:in über die gesamte Bestellhistorie ausgegeben hat.	Shopify-Webhook customers/purchasing_summary
shopify_orders_count	Die Anzahl der Bestellungen, die mit diesem:dieser Kund:in verknüpft sind. Test- und archivierte Bestellungen werden nicht mitgezählt.	Shopify-Webhook customers/purchasing_summary
shopify_last_order_id	Die ID der letzten Bestellung des:der Kund:in.	Shopify-Webhook customers/purchasing_summary
shopify_zipcode	Die Postleitzahl des:der Kund:in aus der Standardadresse.	Shopify-Webhooks customers/create und customers/update
shopify_province	Die Provinz des:der Kund:in aus der Standardadresse.	Shopify-Webhooks customers/create und customers/update
shopify_locale	Das Gebietsschema des:der Kund:in (zum Beispiel en oder fr-CA). Es wird anhand der vom Braze-Webpixel erfassten Browsersprache festgelegt, bis eine Bestellung aufgegeben wird, und anschließend anhand des Gebietsschemas des letzten Checkouts aktualisiert.	Braze-Webpixel, Shopify-Webhooks orders/*, historisches Backfill der Kundendaten

Hinweis

Shopify stellt den Namen der letzten Bestellung eines:einer Kund:in nicht mehr bereit. Daher setzt Braze kein Attribut shopify_last_order_name. Profile, die bereits einen Wert haben, behalten diesen, 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 dann 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 vorhanden ist, löst Braze kein Update aus, und Ihnen wird kein Datenpunkt berechnet.

Leere Werte von Shopify

Wenn Shopify einen leeren Wert für ein Nutzerattribut sendet, können Sie wählen, ob Braze den bereits im Nutzerprofil vorhandenen Wert beibehält oder löscht. Wählen Sie in den Einstellungen Ihrer Shopify-Integration unter Verhalten im Nutzerprofil, wenn Shopify einen leeren Wert sendet eine der folgenden Optionen:

Die Einstellung gilt für die Standardattribute und angepassten Shopify-Attribute, die Braze aus Kundenprofilen synchronisiert. Integrationen verwenden standardmäßig Bestehenden Wert beibehalten. Wenn beispielsweise Telefonnummern auch aus Ihrem CRM stammen und Shopify eine leere Telefonnummer sendet, bleibt die CRM-Nummer im Braze-Nutzerprofil erhalten, anstatt gelöscht zu werden.

Hinweis

Wenn Shopify ein leeres Kunden-Metafeld sendet, überschreibt Braze den bereits im Profil vorhandenen Wert nicht.

Shopify-Kunden-Metafelder

In Shopify-Kunden-Metafeldern speichern Sie eigene Daten zu Kund:innen, etwa eine Treuestufe oder einen Churn-Risiko-Score. Mit der Standardintegration können Sie bis zu 20 Definitionen von Kunden-Metafeldern mit Nutzerprofilen in Braze synchronisieren und diese dann für Segmentierung und Personalisierung nutzen.

So landen Metafelder im Nutzerprofil

Braze legt pro verbundenem Shop ein verschachteltes angepasstes Attribut mit dem Namen shopify_metafields_<store> an. Dabei ist <store> der erste Teil Ihrer Domain <store>.myshopify.com. Jedes ausgewählte Metafeld wird zu einem Schlüssel in diesem Objekt mit dem Namen <namespace>_<key>. Die Definitionen custom.vip_tier und custom.loyalty_points im Shop acme.myshopify.com erscheinen in einem Profil zum Beispiel so:

1
2
3
4
5
6

{
  "shopify_metafields_acme": {
    "custom_vip_tier": "gold",
    "custom_loyalty_points": 120
  }
}

Jedes Update wird per Deep Merge in das Objekt übernommen. Ein Update mit nur einem Schlüssel löscht also nie die anderen, und Braze entfernt nie einen Schlüssel aus dem Objekt. Ist ein Metafeld in Shopify leer, behält das Profil seinen letzten Wert, unabhängig von der Einstellung für leere Werte bei anderen Attributen.

Unterstützte Metafeld-Typen

In der Auswahl erscheinen nur Definitionen mit den folgenden Typen. Andere Typen wie Referenzen, Dateien, JSON, Geldbeträge und Bewertungen werden nicht unterstützt.

Braze übernimmt einen Wert nicht ins Profil, schreibt die übrigen Schlüssel aber weiterhin, wenn:

• ein String-Wert oder ein Element in einer Liste länger als 255 Zeichen ist.
• ein Wert nicht in den Typ der Definition konvertiert werden kann, zum Beispiel Text in einem Ganzzahlfeld.
• der Attributschlüssel (<namespace>_<key>) länger als 255 Zeichen ist oder ein Zeichen enthält, das Braze nicht speichern kann, etwa $ oder ..

Wann Werte synchronisiert werden

Den Synchronisierungsstatus sehen Sie in der Tabelle Shopify-Nutzerattribute auf der Integrationsseite. Dort sind Standardattribute und Kunden-Metafelder jeweils mit einem Status (Aktiv oder Wird aktualisiert, solange eine Synchronisierung läuft) und der Anzahl der Attribute aufgeführt. Wählen Sie das Ansichtssymbol in einer Zeile aus, um die Attributnamen anzuzeigen.

Metafelder ändern oder entfernen

• Um die Auswahl zu ändern, wählen Sie auf der Integrationsseite Einstellungen bearbeiten aus und passen die Auswahl im Schritt „Shopify-Daten tracken“ an. Wenn Sie ein Metafeld hinzufügen, startet eine Synchronisierung für bestehende Kund:innen; wenn Sie eines entfernen, werden für diesen Schlüssel keine Updates mehr übernommen.
• Wenn Sie ein Metafeld aus der Auswahl entfernen oder Kunden-Metafelder als Nutzerattribute synchronisieren deaktivieren, behalten Nutzerprofile den letzten Wert aus Shopify und werden nicht mehr aktualisiert.
• Wenn Sie eine Definition in Shopify löschen, entfernt Braze sie automatisch aus Ihrer Auswahl. Werte, die bereits in Nutzerprofilen gespeichert sind, bleiben erhalten.

Segmentierung und Personalisierung

Bevor Sie nach den Metafeldern filtern können, müssen Sie ein Schema für das Attribut generieren: Gehen Sie zu Dateneinstellungen > Angepasste Attribute, suchen Sie shopify_metafields_<store> und wählen Sie Schema generieren aus. Braze erstellt das Schema aus den Werten, die bereits in Nutzerprofilen vorhanden sind. Führen Sie diesen Schritt daher nach Abschluss der ersten Synchronisierung aus, und generieren Sie das Schema erneut, nachdem Sie Metafelder hinzugefügt haben, damit die neuen Schlüssel erscheinen.

Um nach einem Metafeld zu segmentieren, fügen Sie den Filter Verschachtelte angepasste Attribute hinzu, wählen shopify_metafields_<store> aus, wählen den Schlüssel als Eigenschaft aus und legen dann einen Vergleichsoperator für dessen Typ fest. Für Datums-Metafelder stehen die Vergleichsoperatoren Zeit und Tag des Jahres zur Verfügung. Um eine Nachricht zu personalisieren, verwenden Sie das Tag custom_attribute mit Punktnotation. Für das Profil aus dem vorherigen Beispiel gibt {{custom_attribute.${shopify_metafields_acme}.custom_vip_tier}} den Wert gold zurück.

Verschachtelte angepasste Attribute können Sie nicht als Filter in einem Connected-Audience-API-Aufruf verwenden, und Vorschau als angepasste:r Nutzer:in akzeptiert Testdaten nur als Strings oder String-Arrays. Die vollständige Liste finden Sie unter Hinweise zu verschachtelten angepassten Attributen.

Shopify-Bestellungs-Metafelder

In Shopify-Bestellungs-Metafeldern speichern Sie eigene Daten zu einer Bestellung, etwa eine Geschenknachricht oder eine Präferenz für die Auftragsabwicklung. Mit der Shopify-Standardintegration können Sie ausgewählte Bestellungs-Metafelder zu Bestell-Events hinzufügen. Wie sie in Events erscheinen, welche Events sie enthalten, welche Typen unterstützt werden und wie Sie Ihre Auswahl ändern, erfahren Sie unter Shopify-Bestellungs-Metafelder.

SDK-Datenerfassung

Weitere Informationen darüber, welche Daten die Braze SDKs erfassen, finden Sie unter SDK-Datenerfassung.

Historisches Backfill

Historische Shopify-Daten werden aus der Zeit 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. So nehmen Sie frühere Kund:innen und Bestellungen in Segmente, Kampagnen und Canvases auf. 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 erscheinen die ausgewählten Zeiträume als konkrete Datumsangaben auf der Shopify-Partnerseite. 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 gewählt haben.

Hinweis

Wenn Sie bereits Braze-Kund:in sind und aktive Kampagnen oder Canvases haben, prüfen Sie vor dem Aktivieren 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 Kampagnen 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.

Wie Braze historische Daten auswählt

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 gewählten Bestellzeitraums liegt.

Shopify-Backfill für historische Daten 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ätzte Anzahl 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 fertig sein kann. Umfangreiche Backfills werden in parallele Datumsbereiche aufgeteilt, damit sie gleichzeitig ausgeführt werden können.

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

Synchronisierte Daten

Bei der initialen Datensynchronisierung importiert Braze die Bestell-Events 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 gewählt haben. Wenn Sie bei der Einrichtung Kunden-Metafelder ausgewählt haben, schreibt das Kunden-Backfill auch diese Werte. Wenn Sie bei der Einrichtung Bestell-Metafelder ausgewählt haben, enthalten die per Backfill importierten Bestellungen diese Werte in den unterstützten Bestell-Events.

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