So verwenden Sie E-Commerce-Events
Empfohlene E-Commerce-Events verwenden ein gemeinsames Schema auf Bestellebene, das es Braze ermöglicht, zuverlässige Features auf Basis Ihrer E-Commerce-Daten zu erstellen – einschließlich Nutzerprofilen, Segmentierung, Messaging, Reporting und KI-gestützten Empfehlungen. Die Abschnitte in diesem Artikel beschreiben, wie Sie jede Funktion in Braze nutzen können.
Unter Event-Schemas finden Sie Anforderungen an Eigenschaften und Datentypen, und unter Event-Validierung und Fehlerbehebung erfahren Sie, was passiert, wenn ein Event die Validierung nicht besteht.
Da E-Commerce-Events einem vorhersehbaren Schema folgen, kann Braze zuverlässige Features darauf aufbauen – von Umsatz-Tracking und vorgefertigten Canvas-Templates bis hin zu KI-gestützten Empfehlungen. Die folgenden Abschnitte geben Ihnen einen schnellen Überblick über jede Funktion mit Links zur vollständigen Dokumentation.

E-Commerce-Events von Braze und ihre segmentierbaren Event-Eigenschaften zählen nicht als Datenpunkte.
Tab „Commerce“
Der Tab Commerce in jedem Kundenprofil kombiniert zwei Module: Order activity (berechnete Umsatz- und Bestellmetriken) und Active cart (der neueste Warenkorb aus ecommerce.cart_updated-Events).
Bestellaktivität
Das Modul Order activity zeigt drei berechnete Metriken an, die sich in Echtzeit aktualisieren, sobald Events verarbeitet werden. Das Modell auf Bestellebene dieser Berechnungen trennt Produktpreise sauber vom Gesamtbestellwert.

Empfohlene E-Commerce-Events werden nicht im Abschnitt Purchase history des Tabs Commerce angezeigt. Die Kaufhistorie wird durch Legacy-Kauf-Events befüllt. Verwenden Sie die Metriken in der folgenden Tabelle für Umsatz und Bestellaktivität aus empfohlenen Events.
| Metrik | Formel |
|---|---|
| Gesamtumsatz | Summe (order_placed.total_value) − Summe (order_refunded.total_value) |
| Gesamtbestellungen | Anzahl (eindeutige order_placed) − Anzahl (eindeutige order_cancelled) |
| Gesamter Erstattungswert | Summe (order_refunded.total_value) |
Aktiver Warenkorb
Das Modul Active cart zeigt den neuesten Warenkorb im Kundenprofil an. Diese Ansicht ist besonders hilfreich beim Testen. Sie können damit Warenkorb-Inhalte bestätigen, warenkorbbasierte Journeys validieren oder überprüfen, ob ecommerce.cart_updated-Events das Profil wie erwartet aktualisieren.
Active cart umfasst Folgendes:
- Cart ID – Bezeichner für den Warenkorb, der zuletzt ein
ecommerce.cart_updated-Event erhalten hat. - Last updated – Zeitstempel der letzten Warenkorb-Aktualisierung.
- Total cart value – Gesamtwert der Positionen im aktuellen Warenkorb.
- View products – Ein Link zum Öffnen der Produktliste im Warenkorb (bis zu 50 Produkte).
E-Commerce-Orchestrierung
Segmentierung
Braze bietet drei Möglichkeiten, Nutzer:innen auf Basis von E-Commerce-Daten zu segmentieren:
- E-Commerce-Filter: Verwenden Sie die Kategorie eCommerce im Segmenter, die Filter enthält, die auf empfohlenen E-Commerce-Events basieren (wie Last Order Placed, Total Revenue und Average Order Value). Eine vollständige Liste der verfügbaren Filter finden Sie unter Segmentfilter.
- Angepasste Event-Filter: Da E-Commerce-Events wie angepasste Events funktionieren, greifen alle vorhandenen angepassten Event-Filter sofort. Sie können beispielsweise nach „Hat angepasstes Event
ecommerce.order_placedmehr als X Mal ausgeführt“ oder „Hat angepasstes Eventecommerce.order_placederstmals ausgeführt“ filtern. - Segmenterweiterungen: Für die Segmentierung auf Basis verschachtelter Event-Eigenschaften – einschließlich des verschachtelten Produkt-Arrays oder der Eigenschaften von Metadaten-Objekten – verwenden Sie Segmenterweiterungen mit verschachtelter Event-Eigenschaftsfilterung. So können Sie Zielgruppen erstellen wie „Nutzer:innen, die Produkt SKU-123 in den letzten 90 Tagen gekauft haben“ oder Kriterien über verschiedene Eigenschaften derselben Bestellung kombinieren.
Wenn Sie nach angepassten Eigenschaften filtern müssen, die nicht Teil des dokumentierten Event-Schemas sind, verschachteln Sie diese unter metadata, wenn Sie das Event protokollieren (zum Beispiel metadata.color statt color). Angepasste Eigenschaften auf oberster Ebene, die Sie über die API oder das SDK senden, sind für Erweiterungs-Eigenschaftsfilter nicht gültig – auch dann nicht, wenn diese Eigenschaften in Ihren Event-Daten vorkommen. Die Verwendung einer nicht zugelassenen Eigenschaft auf oberster Ebene verhindert das Speichern oder Dearchivieren der Erweiterung.

Segmenterweiterungen für empfohlene E-Commerce-Events sind ein kostenpflichtiges Feature und befinden sich im Early Access. Wenn Sie am Early Access teilnehmen möchten, wenden Sie sich an Ihren Customer-Success-Manager. Stellen Sie sicher, dass Ihr Tarif den Zugang beinhaltet, bevor Sie Ihrem Team die verschachtelte Eigenschaftssegmentierung empfehlen.
Triggern
Sie können „Angepasstes Event ausgeführt“-Trigger mit E-Commerce-Events in Braze genauso verwenden wie mit anderen angepassten Events. Für Warenkorb-Abbruch-Flows verwenden Sie den Trigger Update Cart, um Warenkorb-Aktualisierungen korrekt zu erfassen.
Darüber hinaus bietet Braze einen dedizierten Place Order-Trigger, mit dem Sie Journeys starten oder Aktionen auslösen können, wenn eine Nutzerin oder ein Nutzer eine Bestellung aufgibt. Weitere Informationen finden Sie unter Aktionsbasierte Zustellung.
Eigenschaftsfilter
Die Trigger Place Order und Update Cart können auch nach den Eigenschaften des Events filtern, sodass ein Trigger nur bei den Bestellungen oder Warenkörben ausgelöst wird, die für Sie relevant sind:
- Basiseigenschaften stimmen mit einer Eigenschaft auf oberster Ebene des Events überein, wie
total_valueodercurrency. - Verschachtelte Eigenschaften durchsuchen das
products-Array. Da jedes Produkt eigene Eigenschaften hat, stimmtproducts[].metadata.categoryüberein, wenn ein beliebiges Produkt in der Bestellung oder im Warenkorb die Bedingung erfüllt.
Verschachteln Sie angepasste Produktfelder unter metadata (zum Beispiel products[].metadata.brand). Eine Produkteigenschaft, die nicht Teil des Event-Schemas ist, besteht die Validierung nicht, sodass ein Filter darauf niemals übereinstimmt.
Zum Beispiel: Die Kombination aus total_value ist größer als 1000 mit products[].metadata.category gleich shoes löst nur bei hochwertigen Bestellungen aus, die Schuhe enthalten. Vor den Eigenschaftsfiltern konnten Sie bei einer aufgegebenen Bestellung triggern, jedoch nicht basierend auf dem Inhalt der Bestellung.
Eigenschaftsfilter sind auf folgenden Oberflächen verfügbar:
- Place Order: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Exit-Kriterien, Aktionspfade, Konversions-Events und Content-Card-Entfernungs-Events. Basis- und verschachtelte Eigenschaften werden unterstützt.
- Update Cart: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Exit-Kriterien und Aktionspfade. Basis- und verschachtelte Eigenschaften werden unterstützt. Bei Konversions-Events, Content-Card-Entfernungs-Events und In-App-Nachricht-Triggern wird Update Cart durch das angepasste Event
ecommerce.cart_updatedunterstützt und unterstützt nur Basiseigenschaften.

Bei einem verschachtelten Filter stimmt ist nicht gleich überein, wenn kein Element im Array übereinstimmt. Ein Warenkorb, der nach products[].metadata.category ist nicht gleich shoes gefiltert wird, stimmt erst überein, wenn jedes Paar Schuhe aus dem Warenkorb entfernt wurde – nicht bereits dann, wenn der Warenkorb auch andere Kategorien enthält.
Verschachtelte Eigenschaften werden bei In-App-Nachricht-Triggern nicht unterstützt, da diese auf dem Gerät ausgewertet werden.
Bestellungen auf ein bestimmtes Produkt eingrenzen
Um nur dann zu triggern, wenn eine Bestellung ein bestimmtes Produkt enthält, fügen Sie dem Place Order-Trigger einen verschachtelten Eigenschaftsfilter hinzu:
| Ziel | Verschachtelter Eigenschaftsfilter |
|---|---|
| Produktname | products[].product_name gleich Wert |
| Produkt-ID | products[].product_id gleich Wert |
| Produktvarianten-ID | products[].variant_id gleich Wert |
Gespeicherte Verhaltensweisen mit Produkteingrenzung
Wenn Sie ein Place Order-Verhalten konfiguriert haben, bevor Eigenschaftsfilter verfügbar waren, nutzt es möglicherweise noch Place order for specific product mit einem Product Identifier (Produktname, product_id oder variant_id). Diese gespeicherten Verhaltensweisen funktionieren weiterhin und stimmen genau wie zuvor überein, sodass bestehende Campaigns und Canvases nicht betroffen sind.
Um ein gespeichertes Verhalten auf Eigenschaftsfilter umzustellen, wählen Sie Place any order. Dadurch werden die Produkteingrenzungs-Steuerelemente durch Eigenschaftsfilter ersetzt. Verwenden Sie die folgende Tabelle, um dieselbe Eingrenzung nachzubilden:
| Bisheriger Product Identifier | Entsprechender verschachtelter Eigenschaftsfilter |
|---|---|
| Produktname | products[].product_name gleich Wert |
| Produkt-ID | products[].product_id gleich Wert |
| Produktvarianten-ID | products[].variant_id gleich Wert |

Die Umstellung eines Verhaltens auf Place any order kann nicht rückgängig gemacht werden. Falls Sie es noch benötigen, erstellen Sie die Eingrenzung als verschachtelten Eigenschaftsfilter neu.

Liquid-Personalisierung
E-Commerce-Events unterstützen Liquid-Personalisierung auf die gleiche Weise wie angepasste Events; Sie können Event-Eigenschaften direkt in Ihren Nachrichten referenzieren. Um Produktbilder, Preise oder andere Katalogdaten in Ihre Nachrichten einzubinden, verknüpfen Sie Ihren Katalog mit dem Event über product_id oder variant_id als Verknüpfungsbezeichner. Der Liquid-Tag {% shopping_cart %} ermöglicht es Ihnen, den aktuellen Warenkorbinhalt eines Nutzers oder einer Nutzerin für Warenkorb-Abbruch-Erinnerungen, Checkout-Anstöße oder Bestellbestätigungen in einer Schleife darzustellen. Fertige Code-Beispiele finden Sie unter E-Commerce-Anwendungsfälle.
Als No-Code-Alternative sind Drag-and-Drop-Produktblöcke im Early-Access-Programm verfügbar.
E-Commerce-Canvas-Templates
Braze bietet gebrauchsfertige Canvas-Templates, die mit empfohlenen E-Commerce-Events als Entry-, Exit- und Konversionskriterien vorkonfiguriert sind, sodass Sie Lifecycle-Flows ohne individuelle Einrichtung starten können. Jedes Template wird mit Drag-and-Drop-E-Mail-Designs geliefert und unterstützt Drag-and-Drop-Produktblöcke (derzeit im Early Access). Detaillierte Anwendungsfälle und Liquid-Beispiele finden Sie unter E-Commerce-Anwendungsfälle.
Diese Templates decken die gängigsten E-Commerce-Lifecycle-Flows ab. Verwenden Sie sie als Ausgangspunkt und passen Sie dann Timing, Kanäle und kreative Inhalte für Ihre Zielgruppe an.
Reaktiviert Nutzer:innen, die ein Produkt angesehen, es aber nicht in den Warenkorb gelegt haben.
Verwenden Sie dieses Template, wenn Sie Stöbernde dazu bringen möchten, Produkte erneut in Betracht zu ziehen, die sie kürzlich angesehen, aber nicht weiterverfolgt haben.
| Einstellung | Wert |
|---|---|
| Entry-Event | ecommerce.product_viewed |
| Exit-Events | ecommerce.product_viewed, ecommerce.cart_updated, ecommerce.checkout_started, Placed Order |
| Konversions-Event | Placed Order |
Gewinnt Nutzer:innen zurück, die Artikel in ihren Warenkorb gelegt, aber den Checkout nicht begonnen haben.
Verwenden Sie dieses Template, wenn Sie Nutzer:innen an Artikel in ihrem Warenkorb erinnern und sie zum Abschluss des Checkouts zurückführen möchten.
| Einstellung | Wert |
|---|---|
| Entry-Event | ecommerce.cart_updated |
| Exit-Events | ecommerce.cart_updated, ecommerce.checkout_started, Placed Order |
| Konversions-Event | Placed Order |

Das Event ecommerce.cart_updated unterstützt den vollständigen Warenkorbersatz (jedes Event kann den gesamten Warenkorb beschreiben) oder inkrementelle Aktualisierungen unter Verwendung der Werte add und remove für die optionale Eigenschaft action. Wählen Sie einen Ansatz pro Warenkorb und vermeiden Sie die Mischung von Ersatz- und inkrementellen Warenkorb-Aktualisierungen für dieselbe cart_id. Der gespeicherte Warenkorb behält die currency des letzten Warenkorb-Events; ein Warenkorb-Update in einer anderen Währung ersetzt den gespeicherten Warenkorb, anstatt Werte aus zwei Währungen zu mischen. Verwenden Sie den Liquid-Tag {% shopping_cart %} in Ihrer Nachricht, um den aktuellen Warenkorbinhalt zum Sendezeitpunkt dynamisch anzuzeigen.
Gewinnt Nutzer:innen zurück, die den Checkout begonnen, den Kauf aber nicht abgeschlossen haben.
Verwenden Sie dieses Template, wenn Sie Käufe in der Phase mit der höchsten Kaufabsicht im Funnel zurückgewinnen möchten.
| Einstellung | Wert |
|---|---|
| Entry-Event | ecommerce.checkout_started |
| Exit-Event | Placed Order |
| Konversions-Event | Placed Order |
Bestätigt einen erfolgreichen Kauf und sendet eine Feedback-Umfrage nach, um Bewertungen zu sammeln und das Post-Purchase-Engagement zu fördern.
Verwenden Sie dieses Template, wenn Sie die Kommunikation nach dem Kauf optimieren und Kundenfeedback in einem einzigen Workflow sammeln möchten.
| Einstellung | Wert |
|---|---|
| Entry-Event | ecommerce.order_placed |
| Konversions-Event | Start Session oder ecommerce.product_viewed |
Templates anpassen
Diese Templates sind als Ausgangspunkt konzipiert. Häufige Anpassungen umfassen:
- E-Mail anpassen: Jedes Template enthält eine vorkonfigurierte E-Mail, die mit dem Drag-and-Drop-Editor erstellt wurde und vollständig bearbeitbar ist, um sie an Ihre Marke und Inhalte anzupassen.
- Kanäle hinzufügen: Kombinieren Sie E-Mail mit Push, SMS oder In-App-Nachrichten für kanalübergreifende Verstärkung.
- Verzögerungen und Decision-Splits hinzufügen: Verzweigen Sie Nutzer:innen nach Verhalten (zum Beispiel hochwertiger Warenkorb im Vergleich zu niedrigwertigem Warenkorb) oder Wartezeiten zwischen Nachrichten.
- Kreative Inhalte austauschen: Ersetzen Sie das enthaltene E-Mail-Template durch den visuellen Stil Ihrer Marke.
- Produktblöcke verwenden: Verwenden Sie Drag-and-Drop-Produktblöcke (im Early-Access-Programm), um abgebrochene Warenkorbinhalte oder angesehene Produkte dynamisch darzustellen, ohne eigenes Liquid zu schreiben.
Für fortgeschrittenere Lifecycle-Strategien, einschließlich Liquid-Personalisierungsbeispielen, siehe E-Commerce-Anwendungsfälle.
E-Commerce-Berichte
Empfohlene E-Commerce-Events unterstützen dieselben Umsatzoberflächen, die Kund:innen bereits heute nutzen. Wenn Ihre Integration E-Commerce-Events sendet, enthalten die folgenden Berichte automatisch E-Commerce-Umsätze:
| Bericht | Was er zeigt |
|---|---|
| Umsatzbericht | Gesamtumsatz, durchschnittlicher Tagesumsatz, tägliche Käufe und Umsatz pro Nutzer:in im Zeitverlauf über alle Quellen für den ausgewählten Zeitraum und die ausgewählten Apps. |
| Last-Touch-Attribution-Umsatz-Dashboard | Umsatz, der der letzten Campaign oder dem letzten Canvas zugeordnet wird, mit der/dem eine Nutzer:in vor einer Bestellung interagiert hat. Touch-Events umfassen E-Mail-Klicks, Push-Öffnungen, Content-Card-Klicks, In-App-Nachrichten-Klicks und SMS- oder WhatsApp-Kurzlink-Klicks. |
| Campaign- und Canvas-Analytics | Gesamtumsatz, der einer bestimmten Campaign oder einem bestimmten Canvas innerhalb des primären Konversionsfensters zugeordnet wird. |
| Konversionsbericht | Umsatz, der an Konversions-Events von Campaigns und Canvases geknüpft ist. Hinweis: Um den Umsatz von ecommerce.order_placed zu zählen, muss die Campaign oder das Canvas den Konversions-Event-Typ Places Order verwenden. |
| Segment-Insights | Umsatzvergleiche über Segmente hinweg im Segment-Insights-Dashboard. |
| Berichts-Builder | Umsatzmetriken in angepassten Berichten, die im Berichts-Builder erstellt wurden. |
| Dashboard-Builder | Umsatzmetriken in angepassten Dashboards, die im Dashboard-Builder erstellt wurden. |
Für nicht nutzerbezogene berechnete Felder (z. B. Campaign- oder Canvas-Umsatz) wird der Umsatz in allen Berichten gleich berechnet: price multipliziert mit quantity pro Produkt in der Bestellung, summiert über alle Produkte in jedem order_placed-Event.

Umsatzberechnungen begrenzen einzelne Produktmengen auf 1.000 Einheiten pro Bestellung. Wenn ein Mengenfeld für ein Produkt fehlt, wird standardmäßig eine Einheit angenommen. Das ursprüngliche ecommerce.order_placed-Event behält die volle von Ihnen gesendete Menge bei – nur die Umsatzberechnung wendet die Obergrenze an.
Wenn Sie von Legacy-Kauf-Events zu ecommerce.order_placed migrieren, stimmen Sie sich mit Ihrem Braze-Kontoteam ab, bevor Sie Integrationsänderungen vornehmen. Senden Sie während der Übergangsphase sowohl Legacy-Kauf- als auch ecommerce.order_placed-Events, um zu bestätigen, dass sie korrekt ausgelöst werden, und um Ihre aktiven Campaigns, Canvases und Segmente für die Migration auf das neue Event vorzubereiten. Ihr Kontoteam kann Ihnen dann helfen, den Wechsel zu planen, um die Umsatzberichterstattung von Legacy-Kauf-Events auf ecommerce.order_placed umzustellen.
BrazeAITM
Predictive Events, voraussichtliche Abwanderung und Artikelempfehlungen unterstützen E-Commerce-Events als Ziel-Events und Signale und bieten eine dedizierte Option „Order Placed“. Das standardisierte Schema macht diese Modelle zuverlässiger, da die Daten in Ihrer gesamten Nutzerbasis konsistent sind.
Daten exportieren
Braze bietet mehrere Möglichkeiten, E-Commerce-Event-Daten für die Verwendung in Ihrem Data Warehouse, BI-Tools oder nachgelagerten Systemen zu exportieren. Empfohlene E-Commerce-Events werden über dieselben Kanäle wie Ihre anderen Event-Daten exportiert.
| Exportpfad | Was enthalten ist |
|---|---|
| Currents | E-Commerce-Events werden als angepasste Events gestreamt; suchen Sie im ecommerce.*-Namespace, um sie zu finden. Produkte aus jeder Bestellung sind als Käufe verfügbar. |
| Snowflake Data Sharing | E-Commerce-Events werden als angepasste Events geteilt; suchen Sie im ecommerce.*-Namespace, um sie zu finden. Produkte aus jeder Bestellung sind in der Käufetabelle verfügbar. |
| Segmentdaten als CSV exportieren | CSV-Export von Segmentmitgliedern. Um E-Commerce-Events einzubeziehen, wählen Sie sie nach Name aus dem Dropdown für angepasste Events aus. |
| Nutzerprofil nach Segment exportieren (API) | Nutzerprofildaten für Segmentmitglieder, die über die API zurückgegeben werden. E-Commerce-Events sind als angepasste Events enthalten. |
Wie segmentiere ich Nutzer:innen nach einem bestimmten Produkt?
Der Segmentierer ermöglicht es Ihnen, nach der Anzahl der Male zu filtern, die eine Nutzer:in ein E-Commerce-Event ausgeführt hat. Um nach bestimmten Produkteigenschaften (wie product_id oder product_name) zu filtern, verwenden Sie Segmenterweiterungen, die das Filtern nach verschachtelten Event-Eigenschaften unterstützen. Sie können zum Beispiel alle Nutzer:innen finden, die das Produkt „SKU-123“ in den letzten 90 Tagen gekauft haben.