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 Segmentierer, 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 Segment-Filter.
- Filter für angepasste Events: Da sich E-Commerce-Events wie angepasste Events verhalten, funktionieren alle vorhandenen Filter für angepasste Events sofort. Sie können beispielsweise filtern nach „Hat angepasstes Event
ecommerce.order_placedmehr als X Mal ausgeführt“ oder „Hat angepasstes Eventecommerce.order_placedzum ersten Mal ausgeführt“. - Segmenterweiterungen: Zum Segmentieren nach verschachtelten 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 wie „Nutzer:innen, die Produkt SKU-123 in den letzten 90 Tagen gekauft haben“ erstellen 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 Top-Level-Eigenschaften, die Sie über die API oder das SDK senden, sind für Erweiterungs-Eigenschaftsfilter nicht gültig – selbst wenn diese Eigenschaften in Ihren Event-Daten erscheinen. Die Verwendung einer nicht auf der Zulassungsliste stehenden Top-Level-Eigenschaft 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. Bestätigen Sie, dass Ihr Plan Zugriff umfasst, bevor Sie verschachtelte Eigenschaftssegmentierung Ihrem Team empfehlen.
Triggering
Sie können Trigger für ausgeführte angepasste Events mit E-Commerce-Events in Braze verwenden, genau wie bei anderen angepassten Events. Verwenden Sie für Warenkorb-Abbruch-Flows 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 ausführen können, wenn Nutzer:innen eine Bestellung aufgeben. Weitere Informationen finden Sie unter Aktionsbasierte Zustellung.
Eigenschaftsfilter
Place Order- und Update Cart-Trigger können auch nach den Eigenschaften filtern, die das Event mitbringt, sodass ein Trigger nur für die Bestellungen oder Warenkörbe ausgelöst wird, die für Sie relevant sind:
- Einfache Eigenschaften passen auf eine Top-Level-Eigenschaft des Events, wie
total_valueodercurrency. - Verschachtelte Eigenschaften schauen in das
products-Array. Da jedes Produkt eigene Eigenschaften hat, passtproducts[].metadata.category, 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 passt.
Beispiel: Die Kombination von total_value ist größer als 1000 mit products[].metadata.category gleich shoes löst den Trigger nur für hochwertige Bestellungen aus, die Schuhe enthalten. Vor Eigenschaftsfiltern konnten Sie auf eine aufgegebene Bestellung triggern, aber nicht auf den Inhalt der Bestellung.
Eigenschaftsfilter sind auf den folgenden Oberflächen verfügbar:
- Place Order: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Ausstiegskriterien, Aktionspfade-Schritte, Konversions-Events und Content-Card-Entfernungs-Events. Einfache und verschachtelte Eigenschaften werden unterstützt. Bei In-App-Nachrichten-Triggern unterstützt Place Order nur einfache Eigenschaften.
- Update Cart: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Ausstiegskriterien und Aktionspfade-Schritte. Einfache und verschachtelte Eigenschaften werden unterstützt. Bei Konversions-Events, Content-Card-Entfernungs-Events und In-App-Nachrichten-Triggern wird Update Cart durch das angepasste Event
ecommerce.cart_updatedabgebildet und unterstützt nur einfache Eigenschaften.

Bei einem verschachtelten Filter passt ist nicht gleich, wenn kein Element im Array übereinstimmt. Ein Warenkorb, der nach products[].metadata.category ist nicht gleich shoes gefiltert wird, passt erst, wenn jedes Paar Schuhe aus dem Warenkorb entfernt wurde – nicht wenn der Warenkorb zusätzlich andere Kategorien enthält.
In-App-Nachrichten-Trigger werden auf dem Gerät ausgewertet, sodass Place Order dort kein bestimmtes Produkt ansprechen oder nach verschachtelten Eigenschaften filtern kann. Die Option Place order for specific product ist im Composer deaktiviert. Um auf ein bestimmtes Produkt zu reagieren, verwenden Sie stattdessen eine Campaign in einem anderen Kanal oder ein Canvas.
Eine Bestellung auf ein bestimmtes Produkt eingrenzen
Um nur auszulösen, wenn eine Bestellung ein bestimmtes Produkt enthält, fügen Sie einen verschachtelten Eigenschaftsfilter zum Place Order-Trigger hinzu. Dies ist bei In-App-Nachrichten-Triggern nicht verfügbar.
| 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 Produktbereich
Wenn Sie ein Place Order-Verhalten konfiguriert haben, bevor Eigenschaftsfilter verfügbar waren, verwendet 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 passen genau wie zuvor, sodass bestehende Campaigns und Canvases nicht betroffen sind.
Um ein gespeichertes Verhalten auf Eigenschaftsfilter umzustellen, wählen Sie Place any order. Damit werden die Produktbereich-Steuerungen durch Eigenschaftsfilter ersetzt. Verwenden Sie die folgende Tabelle, um denselben Bereich 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 |

Das Umstellen eines Verhaltens auf Place any order kann nicht rückgängig gemacht werden. Wenn Sie es noch benötigen, erstellen Sie den Bereich als verschachtelten Eigenschaftsfilter neu.

Liquid-Personalisierung
E-Commerce-Events unterstützen Liquid-Personalisierung genauso 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 Verbindungsbezeichner. Der {% shopping_cart %}-Liquid-Tag ermöglicht es Ihnen, den aktuellen Warenkorbinhalt einer Nutzer:in in einer Schleife zu durchlaufen – für Warenkorb-Abbruch-Erinnerungen, Checkout-Hinweise oder Bestellbestätigungen. Einsatzbereite Codebeispiele 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 einsatzbereite Canvas-Templates, die mit empfohlenen E-Commerce-Events als Entry-, Exit- und Konversions-Kriterien vorkonfiguriert sind, sodass Sie Lifecycle-Flows ohne individuelle Einrichtung starten können. Jedes Template enthält Drag-and-Drop-E-Mail-Designs 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 Kreativmaterial an Ihre Zielgruppe an.
Reaktiviert Nutzer:innen, die ein Produkt angesehen, aber nicht in den Warenkorb gelegt haben.
Verwenden Sie dieses Template, wenn Sie Besucher:innen dazu bringen möchten, Produkte erneut in Betracht zu ziehen, die sie kürzlich angesehen, aber nicht weiter verfolgt 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 den Warenkorb gelegt, aber den Checkout nicht begonnen haben.
Verwenden Sie dieses Template, wenn Sie Nutzer:innen an Artikel in ihrem Warenkorb erinnern und sie dazu bringen möchten, den Checkout abzuschließen.
| Einstellung | Wert |
|---|---|
| Entry-Event | ecommerce.cart_updated |
| Exit-Events | ecommerce.cart_updated, ecommerce.checkout_started, Placed Order |
| Konversions-Event | Placed Order |

Das ecommerce.cart_updated-Event unterstützt vollständigen Warenkorb-Ersatz (jedes Event kann den gesamten Warenkorb beschreiben) oder inkrementelle Updates mit den Werten add und remove für die optionale Eigenschaft action. Wählen Sie einen Ansatz pro Warenkorb und vermeiden Sie es, Ersatz- und inkrementelle Warenkorb-Updates für dieselbe cart_id zu mischen. Der gespeicherte Warenkorb behält die currency des letzten Warenkorb-Events bei; ein Warenkorb-Update in einer anderen Währung ersetzt den gespeicherten Warenkorb, anstatt Werte aus zwei Währungen zu mischen. Verwenden Sie den {% shopping_cart %}-Liquid-Tag in Ihrer Nachricht, um den aktuellen Warenkorbinhalt zum Sendezeitpunkt dynamisch anzuzeigen.
Gewinnt Nutzer:innen zurück, die den Checkout begonnen, aber den Kauf 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 im Anschluss eine Feedback-Umfrage, um Bewertungen zu sammeln und das Post-Purchase-Engagement zu fördern.
Verwenden Sie dieses Template, wenn Sie die Post-Purchase-Kommunikation 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. Gängige 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.
- Kreativmaterial 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 Warenkorb-Inhalte oder angesehene Produkte dynamisch zu rendern, ohne eigenes Liquid zu schreiben.
Für fortgeschrittenere Lifecycle-Strategien, einschließlich Liquid-Personalisierungsbeispiele, lesen Sie E-Commerce-Anwendungsfälle.
E-Commerce-Berichte
Empfohlene E-Commerce-Events speisen dieselben Umsatz-Oberflä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 Ihren ausgewählten Zeitraum und Ihre Apps. |
| Dashboard Umsatz – Last-Touch-Attribution | Umsatz, der der letzten Campaign oder dem letzten Canvas zugeordnet wird, mit der bzw. dem Nutzer:innen vor einer Bestellung interagiert haben. Touch-Events umfassen E-Mail-Klicks, Push-Öffnungen, Content-Card-Klicks, In-App-Nachrichten-Klicks sowie 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 bei Campaigns und Canvases gebunden 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 benutzerdefinierten Berichten, die im Berichts-Builder erstellt werden. |
| Dashboard-Builder | Umsatzmetriken in benutzerdefinierten Dashboards, die im Dashboard-Builder erstellt werden. |
Für nicht nutzerbezogene berechnete Felder (zum Beispiel 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.

Bei der Umsatzberechnung werden einzelne Produktmengen auf 1.000 Einheiten pro Bestellung begrenzt. Wenn ein Mengenfeld für ein Produkt fehlt, wird standardmäßig eine Einheit angenommen. Das ursprüngliche ecommerce.order_placed-Event behält die vollständige 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 Änderungen an der Integration vornehmen. Senden Sie während der Übergangsphase sowohl Legacy-Kauf- als auch ecommerce.order_placed-Events, um sicherzustellen, dass sie korrekt getriggert werden, und bereiten Sie Ihre aktiven Campaigns, Canvases und Segmente auf die Migration zum neuen Event vor. Ihr Kontoteam kann Ihnen dann bei der Planung der Umstellung helfen, um die Umsatzberichte 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 spezielle Option „Order Placed“. Das standardisierte Schema macht diese Modelle zuverlässiger, da die Daten über Ihre gesamte Nutzerbasis hinweg konsistent sind.
Daten exportieren
Braze bietet verschiedene Möglichkeiten, E-Commerce-Event-Daten für die Nutzung in Ihrem Data Warehouse, Ihren 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 Kauftabelle verfügbar. |
| Segmentdaten als CSV exportieren | CSV-Export von Segmentmitgliedern. Um E-Commerce-Events einzuschließen, wählen Sie sie anhand ihres Namens 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 Segmenter ermöglicht es Ihnen, nach der Häufigkeit zu filtern, mit der Nutzer:innen ein E-Commerce-Event ausgeführt haben. Um nach bestimmten Produkteigenschaften (wie product_id oder product_name) zu filtern, verwenden Sie Segmenterweiterungen, die das Filtern nach verschachtelten Event-Eigenschaften unterstützen. So können Sie beispielsweise alle Nutzer:innen finden, die das Produkt „SKU-123“ in den letzten 90 Tagen gekauft haben.