Verbraucher:innen mit Content Cards über Bestellupdates benachrichtigen
Halten Sie einen angepassten Content-Card-Feed mit dem neuesten Auftragsstatus aktuell: Protokollieren Sie Bestellupdates aus Ihrem Auftragsverwaltungssystem (OMS), senden Sie Content Cards für Updates wie „versandt“ oder „storniert“ und entfernen Sie veraltete Karten in der App mithilfe von Schlüssel-Wert-Paaren.
Über dieses Beispiel
Flash & Thread, ein fiktiver Einzelhändler für Bekleidung und Beauty, möchte in seinen mobilen Apps einen horizontalen Content-Card-Feed, in dem jede Karte den Status eines Kaufs anzeigt – zum Beispiel, wenn eine Bestellung von picked zu dispatched (versandt) wechselt oder wenn sie cancelled ist.
Das Auftragsverwaltungssystem speichert die E-Mail-Adresse der Verbraucher:innen, die Bestellnummer, den Auftragsstatus und die Tracking-URL und kann Braze aufrufen, wenn sich diese Werte ändern. Das Marketing wünscht sich statusspezifische Kartentexte (zum Beispiel „Ihre Bestellung ist unterwegs“ für dispatched im Gegensatz zu „Wir bereiten Ihre Bestellung vor“ für picked). Entfernen Sie ältere Karten für dieselbe Bestellung (etwa eine picked-Karte, nachdem eine dispatched-Karte eingetroffen ist), damit Verbraucher:innen nur den neuesten Status sehen.
Dieses Beispiel zeigt, wie Sie:
- Ein angepasstes Event (zum Beispiel
order_update) an/users/trackprotokollieren, wenn das Auftragsverwaltungssystem eine Statusänderung wie „ausstehend“, „zurückgehalten“, „kommissioniert“, „versandt“ oder „storniert“ erfasst - Für jeden dieser Status eine separate aktionsbasierte Content-Card-Kampagne triggern, mit Liquid-Personalisierung aus Event-Eigenschaften
- Auf jeder Karte Schlüssel-Wert-Paare (
extras) wieorder_numberundorder_hierarchyfestlegen - In einem angepassten Content-Card-Feed für jede
order_numbernur die Karte mit der höchstenorder_hierarchybehalten und die übrigen entfernen
Verwenden Sie diesen Ansatz, wenn Entfernungs-Events im Dashboard allein nicht die Karte einer einzelnen Bestellung unter vielen Karten aus derselben Journey ansprechen können.
Überlegungen
- Content Cards laufen ab und werden spätestens 30 Tage nach dem Versand gelöscht. Legen Sie für Endstatus (zum Beispiel „storniert“) einen kürzeren Ablauf fest, wenn diese Karten früher aus dem Feed verschwinden sollen. Siehe Content-Card erstellen.
- Wenn das Auftragsverwaltungssystem nur die E-Mail-Adresse kennt, identifizieren Sie Nutzer:innen bei
/users/trackmit dem sekundären Bezeichneremail. Verwenden Sie bevorzugtexternal_id, wenn das Auftragsverwaltungssystem diese ID hat. Nutzer-Aliasse bleiben eine Option, wenn Sie einen angepassten Bezeichnertyp benötigen; setzen Siealias_nameauf den Wert des Bezeichners undalias_labelauf den Typ (zum Beispielemail). Siehe Auflösung von Bezeichnern und Nutzer-Alias-Objekt. - Angepasste Event-Eigenschaften stehen für die Liquid-Personalisierung und die Segmentierung nach Event-Eigenschaften zur Verfügung, wenn Sie den Event-getriggerten Weg nutzen. Sie werden nicht als Attribute im Profil gespeichert, es sei denn, Sie schreiben sie zusätzlich als Attribute.
- API-getriggerte Content-Card-Kampagnen sind eine Alternative, bei der Sie kein angepasstes Event (und dessen Datenpunkte) protokollieren müssen. Allerdings benötigt jede Kampagne einen eigenen Trigger-Versand, und Sie verlieren die Segmentierung nach Event-Eigenschaften für dieses Signal.
- Angepasste Feeds werden während einer Session nicht aktualisiert, bis die nächste Session beginnt oder ein manueller Aufruf von
requestContentCardsRefresherfolgt. Rufen Sie die Aktualisierung auf, wenn Verbraucher:innen den Bestell-Feed öffnen oder per Pull-to-Refresh aktualisieren. - Vollständig angepasste Content-Card-UIs erfordern ein manuelles Protokollieren der Analytics (Impressionen, Klicks, Entfernungen). Das Ableiten einer Unterklasse vom Standard-Feed ist weniger Aufwand, unterstützt aber kein horizontales Karussell.
- Diese Hierarchie-Logik setzt voraus, dass pro Bestellnummer jeweils nur ein Status aktiv ist. Wenn eine Bestellung mehrere gleichzeitige Status haben kann (zum Beispiel bei aufgeteilten Lagerauslieferungen), fügen Sie einen weiteren Schlüssel hinzu (etwa eine Fulfillment-ID) und berücksichtigen Sie ihn in Ihren Regeln zum Behalten oder Entfernen.
- Die Entfernungslogik in der App erfordert ein neues App-Release. Testen Sie vor der Produktion in einem Entwicklungs-Workspace.
Einrichtung
Schritt 1: Bestellupdates aus dem Auftragsverwaltungssystem protokollieren
Wenn das Auftragsverwaltungssystem eine Statusänderung erfasst, senden Sie ein angepasstes Event an /users/track. Fügen Sie die Event-Eigenschaften hinzu, mit denen die Content-Card personalisiert wird und die die App aus extras ausliest.
Die folgende Tabelle zeigt Beispiel-Eigenschaften:
| Eigenschaft | Zweck |
|---|---|
order_number |
Gruppiert Karten für dieselbe Bestellung |
order_status |
Statusbezeichnung für Texte und Kampagnenfilter |
tracking_url |
Optionaler Deeplink oder Button-URL |
Eine Beispielanfrage, die Nutzer:innen anhand der E-Mail-Adresse identifiziert:
POST https://rest.iad-01.braze.com/users/track
Content-Type: application/json
Authorization: Bearer {YOUR_REST_API_KEY}
{
"events": [
{
"email": "[email protected]",
"name": "order_update",
"time": "2026-09-28T16:02:05Z",
"properties": {
"order_number": "12345",
"order_status": "picked",
"tracking_url": "https://www.flashandthread.example/track/12345"
}
}
]
}
Verwenden Sie den REST-Endpunkt Ihres Workspaces und einen API-Schlüssel mit der Berechtigung users.track. Ersetzen Sie die Beispiel-E-Mail-Adresse und die Bestellwerte durch die Payload Ihres Auftragsverwaltungssystems.
Schritt 2: Eine Content-Card-Kampagne pro Auftragsstatus erstellen
Erstellen Sie für jeden Status, den Sie senden, eine aktionsbasierte Content-Card-Kampagne (zum Beispiel pending, held, picked, dispatched, cancelled).
- Gehen Sie zu Messaging > Campaigns, wählen Sie Create campaign und dann Content Cards aus.
- Legen Sie eine aktionsbasierte Zustellung für das angepasste Event
order_updatefest. Filtern Sie nach der passenden Event-Eigenschaftorder_status, damit nur dieser Status in diese Kampagne gelangt. - Verwenden Sie Liquid-Event-Eigenschaften, um den Titel oder Text der Karte zu personalisieren:
Order {{event_properties.${order_number}}} is {{event_properties.${order_status}}}.
- Wählen Sie im Tab Settings die Option Add new pair aus und fügen Sie die Schlüssel-Wert-Paare hinzu, die die App verwendet:
| Schlüssel | Wert |
|---|---|
order_number |
{{event_properties.${order_number}}} |
order_status |
{{event_properties.${order_status}}} (oder der feste Status für diese Kampagne) |
order_hierarchy |
Ganzzahl für diesen Status (pro Kampagne fest codiert) |
Die folgende Tabelle zeigt eine Beispielhierarchie. Die App behält für jede Bestellung die Karte mit dem höchsten Wert:
| Status | order_hierarchy |
|---|---|
| pending | 1 |
| held | 2 |
| picked | 3 |
| dispatched | 4 |
| cancelled | 5 |
- Legen Sie den Ablauf der Karte fest (bis zu 30 Tage). Wählen Sie für Endstatus bevorzugt eine kürzere Dauer.
Entfernungs-Events im Dashboard gelten auf Kampagnenebene und können nicht nur die Karte einer einzelnen Bestellung entfernen, während andere Karten aus derselben Kampagne bestehen bleiben. Deshalb entfernt die App veraltete Karten mithilfe von extras.
Schritt 3: Die neueste Karte pro Bestellung im angepassten Feed behalten
Abonnieren Sie in Ihrem angepassten Feed Updates zu Content Cards, lesen Sie extras aus und behalten Sie für jede order_number die Karte mit der höchsten order_hierarchy. Entfernen Sie die übrigen mit der Dismiss-API Ihrer Plattform, damit die Analytics korrekt bleiben.
Für jede Karte im Feed:
- Lesen Sie
order_numberundorder_hierarchyausextrasaus. - Ermitteln Sie die höchste
order_hierarchyunter den Karten mit derselbenorder_number. - Wenn die Hierarchie der Karte dem höchsten Wert entspricht, zeigen Sie sie an (ordnen Sie die Kartenfelder Ihrem angepassten UI-Objekt zu).
- Andernfalls entfernen Sie die Karte.
Implementieren Sie die Aufrufe zum Abonnieren und Entfernen mit dem aktuellen SDK für Ihre Plattform. Beginnen Sie hier:
Wenn sich Verbraucher:innen bereits in der App befinden, rufen Sie requestContentCardsRefresh auf, damit neue Bestellkarten erscheinen, ohne auf die nächste Session warten zu müssen.
Schritt 4: Die Journey durchgängig testen
- Senden Sie eine Abfolge von
order_update-Events für dieselbe Bestellung mit aufsteigendenorder_status-Werten. - Prüfen Sie, ob jede Statuskampagne die erwartete Karte sendet und Liquid korrekt aufgelöst wird.
- Prüfen Sie, ob der Feed eine Karte pro Bestellung anzeigt und Karten mit niedrigerer Hierarchie entfernt werden.
- Prüfen Sie, ob Impressionen, Klicks und Entfernungen für Ihre angepasste UI in den Kampagnen-Analytics erscheinen.