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.

Hinweis

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.

Hinweis

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.

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 anhand von E-Commerce-Daten zu segmentieren:

• E-Commerce-Filter: Verwenden Sie die Kategorie eCommerce im Segmentierer. Sie enthält Filter, die auf den empfohlenen E-Commerce-Events basieren (z. B. Last Order Placed, Total Revenue und Average Order Value). Eine vollständige Liste der verfügbaren Filter finden Sie unter Segmentfilter.
• 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 nach „Has performed custom event ecommerce.order_placed more than X times“ oder „First performed custom event ecommerce.order_placed“ filtern.
• Segmenterweiterungen: Um nach verschachtelten Event-Eigenschaften zu segmentieren, einschließlich des verschachtelten Arrays products oder der Eigenschaften der Metadatenobjekte, verwenden Sie Segmenterweiterungen mit Filterung nach verschachtelten Event-Eigenschaften. So können Sie Zielgruppen wie „Nutzer:innen, die das Produkt SKU-123 in den letzten 90 Tagen gekauft haben“ erstellen oder Kriterien über verschiedene Eigenschaften derselben Bestellung hinweg kombinieren.

Wenn Sie nach angepassten Eigenschaften filtern müssen, die nicht Teil des dokumentierten Event-Schemas sind, verschachteln Sie diese beim Loggen des Events unter metadata (z. B. metadata.color statt color). Angepasste Eigenschaften auf oberster Ebene, die Sie über die API oder das SDK senden, sind für Eigenschaftsfilter in Erweiterungen nicht gültig – auch wenn diese Eigenschaften in Ihren Event-Daten erscheinen. Wenn Sie eine nicht zugelassene Eigenschaft auf oberster Ebene verwenden, kann die Erweiterung nicht gespeichert oder aus dem Archiv wiederhergestellt werden.

Wichtig

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. Vergewissern Sie sich, dass Ihr Tarif den Zugriff umfasst, bevor Sie Ihrem Team die Segmentierung nach verschachtelten Eigenschaften empfehlen.

Triggern

Sie können Trigger für ausgeführte angepasste Events mit E-Commerce-Events überall in Braze verwenden, genau wie mit anderen angepassten Events. Verwenden Sie für Warenkorb-Abbruch-Flows den Trigger Update Cart, um Aktualisierungen des Warenkorbs korrekt zu erfassen.

Zusätzlich bietet Braze einen eigenen Trigger Place Order, 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

Die Trigger Place Order und Update Cart können auch nach den Eigenschaften des Events filtern, sodass ein Trigger nur für die Bestellungen oder Warenkörbe ausgelöst wird, die für Sie relevant sind:

• Einfache Eigenschaften entsprechen einer Eigenschaft auf oberster Ebene des Events, z. B. total_value oder currency.
• Verschachtelte Eigenschaften durchsuchen das Array products. Da jedes Produkt eigene Eigenschaften besitzt, ergibt products[].metadata.category einen Treffer, wenn irgendein Produkt in der Bestellung oder im Warenkorb die Bedingung erfüllt.

Verschachteln Sie angepasste Produktfelder unter metadata (z. B. products[].metadata.brand). Eine Produkteigenschaft, die nicht Teil des Event-Schemas ist, besteht die Validierung nicht, sodass ein Filter darauf nie einen Treffer ergibt.

Wenn Sie beispielsweise total_value ist größer als 1000 mit products[].metadata.category ist gleich shoes kombinieren, wird nur bei hochwertigen Bestellungen getriggert, die Schuhe enthalten. Vor der Einführung von Eigenschaftsfiltern konnten Sie zwar beim Aufgeben einer Bestellung triggern, nicht aber anhand des Bestellinhalts.

Eigenschaftsfilter sind an folgenden Stellen verfügbar:

• Place Order: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Exit-Kriterien, Aktionspfad-Schritte, Konversions-Events und Events zum Entfernen von Content-Cards. Einfache und verschachtelte Eigenschaften werden unterstützt. Bei Triggern für In-App-Nachrichten unterstützt Place Order nur einfache Eigenschaften.
• Update Cart: Campaign- und Canvas-Trigger, Ausnahme-Events, Canvas-Exit-Kriterien und Aktionspfad-Schritte. Einfache und verschachtelte Eigenschaften werden unterstützt. Bei Konversions-Events, Events zum Entfernen von Content-Cards und Triggern für In-App-Nachrichten basiert Update Cart auf dem angepassten Event ecommerce.cart_updated und unterstützt nur einfache Eigenschaften.

Hinweis

Bei einem verschachtelten Filter ergibt does not equal einen Treffer, wenn kein Element im Array übereinstimmt. Ein Warenkorb, der mit products[].metadata.category does not equal shoes gefiltert wird, ergibt erst dann einen Treffer, wenn jedes Paar Schuhe aus dem Warenkorb entfernt wurde – nicht schon, wenn der Warenkorb zusätzlich andere Kategorien enthält.

Trigger für In-App-Nachrichten werden auf dem Gerät ausgewertet, daher kann Place Order dort kein bestimmtes Produkt ansprechen und nicht nach verschachtelten Eigenschaften filtern. Die Option Place order for specific product ist im Editor 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 dann zu triggern, wenn eine Bestellung ein bestimmtes Produkt enthält, fügen Sie dem Trigger Place Order einen Filter für verschachtelte Eigenschaften hinzu. Bei Triggern für In-App-Nachrichten ist dies nicht verfügbar.

Gespeicherte Verhaltensweisen mit Produkteingrenzung

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 ergeben genau wie bisher Treffer, sodass bestehende Campaigns und Canvases nicht betroffen sind.

Um ein gespeichertes Verhalten auf Eigenschaftsfilter umzustellen, wählen Sie Place any order aus. Dadurch werden die Steuerelemente für die Produkteingrenzung durch Eigenschaftsfilter ersetzt. Verwenden Sie die folgende Tabelle, um dieselbe Eingrenzung neu zu erstellen:

Wichtig

Die Umstellung eines Verhaltens auf Place any order kann nicht rückgängig gemacht werden. Wenn Sie die Eingrenzung weiterhin benötigen, erstellen Sie sie als Filter für verschachtelte Eigenschaften neu.

Liquid-Personalisierung

E-Commerce-Events unterstützen die Liquid-Personalisierung auf dieselbe Weise wie angepasste Events: Sie können in Ihren Nachrichten direkt auf Event-Eigenschaften verweisen. 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 verbindenden Bezeichner. Mit dem Liquid-Tag {% shopping_cart %} können Sie den aktuellen Warenkorbinhalt von Nutzer:innen in einer Schleife durchlaufen – für Erinnerungen bei Warenkorb-Abbruch, Checkout-Anstöße oder Bestellbestätigungen. Sofort einsetzbare Code-Beispiele finden Sie unter E-Commerce-Anwendungsfälle.

Als No-Code-Alternative stehen im Early-Access-Programm Drag-and-Drop-Produktblöcke zur Verfügung.

E-Commerce-Canvas-Templates

Braze bietet sofort einsetzbare Canvas-Templates, die mit empfohlenen E-Commerce-Events als Entry-, Exit- und Konversionskriterien vorkonfiguriert sind. So können Sie Lifecycle-Flows ohne angepasste Einrichtung starten. Jedes Template enthält Drag-and-Drop-E-Mail-Designs und unterstützt Drag-and-Drop-Produktblöcke (derzeit im Early Access). Ausführliche Anwendungsfälle und Liquid-Beispiele finden Sie unter E-Commerce-Anwendungsfälle.

Diese Templates decken die gängigsten E-Commerce-Lifecycle-Flows ab. Nutzen Sie sie als Ausgangspunkt und passen Sie anschließend Timing, Kanäle und kreative Inhalte an Ihre Zielgruppe an.

• browse-abbruch
• warenkorb-abbruch
• checkout-abbruch
• bestellbestätigung und umfrage

Spricht Nutzer:innen erneut an, die ein Produkt angesehen, es aber nicht in den Warenkorb gelegt haben.

Verwenden Sie dieses Template, wenn Sie Besucher:innen zurückholen möchten, damit sie Produkte in Betracht ziehen, die sie kürzlich angesehen, aber nicht weiter beachtet 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, den Checkout aber nicht begonnen haben.

Verwenden Sie dieses Template, wenn Sie Nutzer:innen an die 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

Tipp

Das Event ecommerce.cart_updated unterstützt den vollständigen Austausch des Warenkorbs (jedes Event kann den gesamten Warenkorb beschreiben) oder inkrementelle Updates mithilfe der Werte add und remove für die optionale Eigenschaft action. Wählen Sie pro Warenkorb einen Ansatz und vermeiden Sie es, Austausch und inkrementelle Updates für dieselbe cart_id zu mischen. Der gespeicherte Warenkorb übernimmt die currency aus dem jüngsten Warenkorb-Event. Ein Warenkorb-Update in einer anderen Währung ersetzt den gespeicherten Warenkorb, anstatt Werte aus zwei Währungen zu mischen. Verwenden Sie das Liquid-Tag {% shopping_cart %} in Ihrer Nachricht, um den aktuellen Warenkorbinhalt zum Zeitpunkt des Versands 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 des Funnels mit der höchsten Kaufabsicht 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 schickt anschließend eine Feedback-Umfrage, um Bewertungen zu sammeln und das Engagement nach dem Kauf 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

Templates anpassen

Diese Templates sind als Ausgangspunkt gedacht. Gängige Anpassungen sind:

• E-Mail anpassen: Jedes Template enthält eine vorkonfigurierte E-Mail, die mit dem Drag-and-Drop-Editor erstellt wurde und sich vollständig an Ihre Marke und Inhalte anpassen lässt.
• Kanäle hinzufügen: Kombinieren Sie E-Mail mit Push, SMS oder In-App-Nachrichten, um Ihre Botschaft kanalübergreifend zu verstärken.
• Verzögerungen und Decision-Splits hinzufügen: Verzweigen Sie Nutzer:innen nach Verhalten (z. B. hochwertiger im Vergleich zu geringwertigem Warenkorb) oder fügen Sie Wartezeiten zwischen Nachrichten ein.
• 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 Inhalte abgebrochener Warenkörbe oder angesehene Produkte dynamisch darzustellen, ohne angepasstes Liquid zu schreiben.

Fortgeschrittenere Lifecycle-Strategien, einschließlich Beispielen zur Liquid-Personalisierung, finden Sie unter E-Commerce-Anwendungsfälle.

E-Commerce-Berichte

Die empfohlenen E-Commerce-Events speisen dieselben Umsatzansichten, die Kund:innen bereits heute nutzen. Wenn Ihre Integration E-Commerce-Events sendet, enthalten die folgenden Berichte automatisch den E-Commerce-Umsatz:

Für nicht nutzerbezogene berechnete Felder (zum Beispiel Campaign- oder Canvas-Umsatz) wird der Umsatz in allen Berichten auf dieselbe Weise berechnet: price multipliziert mit quantity pro Produkt in der Bestellung, summiert über alle Produkte in jedem order_placed-Event.

Hinweis

Bei der Umsatzberechnung wird die Menge einzelner Produkte auf 1.000 Einheiten pro Bestellung begrenzt. Fehlt bei einem Produkt das Mengenfeld, wird standardmäßig eine Einheit angenommen. Das ursprüngliche ecommerce.order_placed-Event behält die vollständige von Ihnen gesendete Menge – die Begrenzung gilt nur für die Umsatzberechnung.

Wenn Sie von älteren Kauf-Events auf ecommerce.order_placed migrieren, stimmen Sie sich mit Ihrem Braze-Account-Team ab, bevor Sie Änderungen an der Integration vornehmen. Senden Sie während der Übergangsphase sowohl ältere Kauf-Events als auch ecommerce.order_placed-Events, um zu bestätigen, dass sie korrekt triggern, und um Ihre aktiven Campaigns, Canvases und Segments auf die Migration zum neuen Event vorzubereiten. Ihr Account-Team kann Ihnen anschließend helfen, die Umstellung der Umsatzberichte von älteren Kauf-Events auf ecommerce.order_placed zu planen.

BrazeAI^TM

Predictive Events, Predictive Churn und Artikelempfehlungen unterstützen E-Commerce-Events als Ziel-Events und Signale und bieten eine eigene Option „Order Placed“. Das standardisierte Schema macht diese Modelle zuverlässiger, weil die Daten über Ihre gesamte Nutzerbasis hinweg konsistent sind.

Daten exportieren

Braze bietet mehrere Möglichkeiten, E-Commerce-Event-Daten zur Nutzung in Ihrem Data Warehouse, in BI-Tools oder nachgelagerten Systemen zu exportieren. Empfohlene E-Commerce-Events werden über dieselben Wege exportiert wie Ihre übrigen Event-Daten.

Wie segmentiere ich Nutzer:innen nach einem bestimmten Produkt?

Mit dem Segmentierer können Sie danach filtern, wie oft 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 in den letzten 90 Tagen das Produkt „SKU-123“ gekauft haben.