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 verwendet empfohlene E-Commerce-Events, um wichtige Einkaufsverhaltensweisen zu erfassen. Implementierungsbeispiele und Marketing-Strategien, die diese Events nutzen, 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 Kundenprofil in Shopify erstellt oder aktualisiert wird, wird ein entsprechendes Kundenprofil 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"
  }
}

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 betroffene 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 eine Kund:in eine Produktseite aufruft
Datenquelle: Braze SDKs
Anwendungsfall: Browse-Abbruch

Variable	Liquid-Vorlage
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-Shop-Domain vor der URL ein.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

Event: ecommerce.cart_updated
Typ: Empfohlenes Event
Ausgelöst: Wenn eine Kund:in einen Artikel zum Warenkorb hinzufügt, entfernt oder aktualisiert
Datenquelle: Braze SDKs
Anwendungsfall: Warenkorb-Abbruch

Für Canvases bei abgebrochenem Einkauf müssen Sie zunächst den initialen 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-Vorlage
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 Erstellen einer Liquid-for-Schleife, um alle Produkte dynamisch in Ihre E-Mail einzufügen, finden Sie unter Produktpersonalisierung für abgebrochene Warenkörbe in E-Mails.

Event: ecommerce.checkout_started
Typ: Empfohlenes Event
Ausgelöst: Wenn eine Nutzer:in zur Checkout-Seite navigiert
Datenquelle: Braze REST API
Anwendungsfall: Checkout-Abbruch

Wichtig

Wenn eine Kund:in Shop Pay als beschleunigten Checkout nutzt, kann Shopify bestimmte Standard-Checkout-Events (wie den Shopify-Checkout-Started-Webhook) umgehen. Das bedeutet, dass Braze möglicherweise nicht die erforderlichen Daten erhält, um den Checkout-Token-Alias hinzuzufügen, was sich auf das Tracking von Checkout-Abbrüchen und die Nutzerprofilzuordnung auswirken kann.

Für Canvases bei 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-Vorlage
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata.sku }}
source	{{ shopping_cart.source }}
checkout_url	{{ shopping_cart.metadata[0].checkout_url }}

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

Variable	Liquid-Vorlage
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 Checkout-Completed-Webhook von Shopify enthält keine Produkt-URLs oder Bild-URLs. Daher müssen Sie die Liquid-Personalisierung mit Katalogen verwenden, wie unter Produktpersonalisierung für abgebrochene Warenkörbe in E-Mails beschrieben.

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

Variable	Liquid-Vorlage
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}}}
Stornierungszeitstempel	{{event_properties.${cancelled_at}}}
Abschlusszeitstempel	{{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}}
Artikelverkäufer	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Fulfillment-Status	{{event_properties.${fulfillment_status}}}
Fulfillment-Versandstatus	{{event_properties.${fulfillments}[0].shipment_status}}
Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment-Tracking-Unternehmen	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Fulfillment-Tracking-Nummer	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Fulfillment-Tracking-Nummern	{{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-Verkäufer	{{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 einer Nutzer:in erfüllt und versandbereit ist
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Fulfillment-Update

Variable	Liquid-Vorlage
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}}}
Stornierungszeitstempel	{{event_properties.${cancelled_at}}}
Abschlusszeitstempel	{{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}}
Artikelverkäufer	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Fulfillment-Status	{{event_properties.${fulfillment_status}}}
Fulfillment-Versandstatus	{{event_properties.${fulfillments}[0].shipment_status}}
Fulfillment-Status	{{event_properties.${fulfillments}[0].status}}
Fulfillment-Tracking-Unternehmen	{{event_properties.${fulfillments}[0].tracking_company}}
Fulfillment-Tracking-Nummer	{{event_properties.${fulfillments}[0].tracking_number}}
Fulfillment-Tracking-Nummern	{{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-Verkäufer	{{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 einer Nutzer:in in Shopify als bezahlt markiert wird
Datenquelle: Braze REST API
Anwendungsfall: (Transaktional) Zahlungsbestätigung

Variable	Liquid-Vorlage
Bestell-ID	{{event_properties.${order_id}}}
Bestätigungsstatus	{{event_properties.${confirmed}}}
Bestellstatus-URL	{{event_properties.${order_status_url}}}
Bestellnummer	{{event_properties.${order_number}}}
Stornierungszeitstempel	{{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}}
Artikelverkäufer	{{event_properties.${line_items}[0].vendor}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Artikelpreis	{{event_properties.${line_items}[0].price}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Liquid-Vorlage
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}}}
Stornierungszeitstempel	{{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}}
Artikelverkäufer	{{event_properties.${line_items}[0].vendor}}
Artikelname	{{event_properties.${line_items}[0].name}}
Artikeleigenschaften	{{event_properties.${line_items}[0].properties}}
Fulfillment-Status	{{event_properties.${line_items}[0].fulfillment_status}}
Versandtitel	{{event_properties.${shipping}[0].title}}
Versandpreis	{{event_properties.${shipping}[0].price}}
Varianten-ID	{{event_properties.${line_items}[0].variant_id}}
Variantentitel	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Liquid-Vorlage
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}}
Artikelverkäufer	{{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 eine Nutzer:in bei ihrem Konto anmeldet
Datenquelle: Braze REST API
Anwendungsfall: Willkommensserie

Variable	Liquid-Vorlage
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
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 bezieht sich direkt auf das Feld name der Bestellressource.
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 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 dieses Problem behoben hat.

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 dann, wenn die Daten vom bestehenden Kundenprofil abweichen. Wenn die eingehenden Shopify-Daten beispielsweise den Vornamen Bob enthalten und Bob bereits als Vorname im Braze-Kundenprofil existiert, 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 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 abgeschlossen haben.

Über die Shopify-Standardintegration oder die benutzerdefinierte Shopify-Integration können Sie den historischen Backfill aktivieren, um frühere 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 abgeschlossen haben.

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

Hinweis

Wenn Sie bereits Braze-Kund:in mit aktiven Campaigns oder Canvases sind, prüfen Sie, wie importierte Kund:innen und Bestell-Events Ihre Segmente und Journeys beeinflussen, 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.

Shopify historischen Backfill einrichten

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

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

Synchronisierte Daten

Für die erste Datensynchronisierung importiert Braze Bestell-Events aus den letzten 90 Tagen und Nutzerprofile aus dem letzten Jahr, jeweils ab dem Datum zurückgerechnet, an dem Sie Ihre Integration abgeschlossen haben. 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 bei diesem ersten Import enthalten sind.