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 trennt bei diesen Berechnungen Produktpreise sauber vom Gesamtbestellwert.

Aktiver Warenkorb

Das Modul Active cart zeigt den neuesten Warenkorb im Kundenprofil an. Diese Ansicht ist beim Testen besonders hilfreich. 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 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 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 zum Beispiel 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, etwa nach dem verschachtelten Produkt-Array oder den Eigenschaften der Metadaten-Objekte, verwenden Sie Segmenterweiterungen mit Filterung nach verschachtelten Event-Eigenschaften. So können Sie Zielgruppen wie „Nutzer:innen, die in den letzten 90 Tagen das Produkt SKU-123 gekauft haben“ erstellen oder Kriterien über verschiedene Eigenschaften derselben Bestellung hinweg kombinieren.

Wenn Sie nach angepassten Eigenschaften filtern möchten, die nicht Teil des dokumentierten Event-Schemas sind, verschachteln Sie diese beim Protokollieren des Events unter metadata (zum Beispiel 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 – selbst 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 Ihre:n Customer-Success-Manager:in. Vergewissern Sie sich, dass Ihr Tarif den Zugang 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 bei anderen angepassten Events. Für Warenkorb-Abbruch-Flows verwenden Sie den Trigger Update Cart, um Aktualisierungen des Warenkorbs korrekt zu erfassen.

Zusätzlich bietet Braze einen speziellen 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 gleichen eine Eigenschaft auf oberster Ebene des Events ab, z. B. total_value oder currency.
• Verschachtelte Eigenschaften durchsuchen das Array products. Da jedes Produkt eigene Eigenschaften hat, trifft products[].metadata.category zu, wenn irgendein 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 nie zutrifft.

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 den Eigenschaftsfiltern konnten Sie zwar auf das Aufgeben einer Bestellung triggern, nicht aber auf deren Inhalt.

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 trifft does not equal zu, wenn kein Element im Array übereinstimmt. Ein Warenkorb, der nach products[].metadata.category ist ungleich shoes gefiltert wird, trifft erst zu, wenn alle Schuhe aus dem Warenkorb entfernt wurden – nicht bereits dann, 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 weder ein bestimmtes Produkt ansprechen noch 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 treffen genau wie bisher zu, 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 zur Produkteingrenzung durch Eigenschaftsfilter ersetzt. Verwenden Sie die folgende Tabelle, um dieselbe Eingrenzung nachzubilden:

Wichtig

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

Liquid-Personalisierung

E-Commerce-Events unterstützen Liquid-Personalisierung auf dieselbe 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 und verwenden dabei product_id oder variant_id als verbindenden Bezeichner. Mit dem Liquid-Tag {% shopping_cart %} können Sie den aktuellen Warenkorbinhalt von Nutzer:innen durchlaufen – etwa für Erinnerungen bei Warenkorb-Abbruch, Checkout-Anstöße oder Bestellbestätigungen. Sofort einsetzbare Codebeispiele 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 Creatives an Ihre Zielgruppe an.

• abgebrochenes browsen
• warenkorb-abbruch
• checkout-abbruch
• bestellbestätigung und umfrage

Spricht Nutzer:innen erneut an, die sich 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 erneut 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, aber den Checkout 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, für dieselbe cart_id vollständige und inkrementelle Warenkorb-Updates zu mischen. Der gespeicherte Warenkorb übernimmt die currency des jüngsten Warenkorb-Events. 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. Häufige Anpassungen sind:

• E-Mail anpassen: Jedes Template enthält eine vorkonfigurierte, mit dem Drag-and-Drop-Editor erstellte E-Mail, die Sie vollständig an Ihre Marke und Inhalte anpassen können.
• Kanäle hinzufügen: Kombinieren Sie E-Mail mit Push, SMS oder In-App-Nachrichten für eine kanalübergreifende Verstärkung.
• Verzögerungen und Decision-Splits hinzufügen: Verzweigen Sie Nutzer:innen nach Verhalten (zum Beispiel hochwertiger im Vergleich zu niedrigwertigem Warenkorb) oder fügen Sie Wartezeiten zwischen Nachrichten ein.
• Creatives 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 den Inhalt abgebrochener Warenkörbe oder angesehene Produkte dynamisch darzustellen, ohne angepasstes Liquid schreiben zu müssen.

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

E-Commerce-Berichte

Empfohlene E-Commerce-Events speisen dieselben Umsatzberichte, 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 zu ecommerce.order_placed migrieren, stimmen Sie sich mit Ihrem Braze-Account-Team ab, bevor Sie Änderungen an Ihrer 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 getriggert werden, und um Ihre aktiven Campaigns, Canvases und Segmente auf die Migration zum neuen Event vorzubereiten. Ihr Account-Team kann Ihnen anschließend dabei helfen, die Umstellung der Umsatzberichte von älteren Kauf-Events auf ecommerce.order_placed zu planen.

BrazeAI^TM

Voraussichtliche Events, voraussichtliche Abwanderung 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, da 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 in nachgelagerten Systemen zu exportieren. Empfohlene E-Commerce-Events werden über dieselben Kanäle 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 zum Beispiel alle Nutzer:innen finden, die in den letzten 90 Tagen das Produkt „SKU-123“ gekauft haben.