Zum Inhalt springen

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:

  1. Ein angepasstes Event (zum Beispiel order_update) an /users/track protokollieren, wenn das Auftragsverwaltungssystem eine Statusänderung wie „ausstehend“, „zurückgehalten“, „kommissioniert“, „versandt“ oder „storniert“ erfasst
  2. Für jeden dieser Status eine separate aktionsbasierte Content-Card-Kampagne triggern, mit Liquid-Personalisierung aus Event-Eigenschaften
  3. Auf jeder Karte Schlüssel-Wert-Paare (extras) wie order_number und order_hierarchy festlegen
  4. In einem angepassten Content-Card-Feed für jede order_number nur die Karte mit der höchsten order_hierarchy behalten 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/track mit dem sekundären Bezeichner email. Verwenden Sie bevorzugt external_id, wenn das Auftragsverwaltungssystem diese ID hat. Nutzer-Aliasse bleiben eine Option, wenn Sie einen angepassten Bezeichnertyp benötigen; setzen Sie alias_name auf den Wert des Bezeichners und alias_label auf den Typ (zum Beispiel email). 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 requestContentCardsRefresh erfolgt. 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).

  1. Gehen Sie zu Messaging > Campaigns, wählen Sie Create campaign und dann Content Cards aus.
  2. Legen Sie eine aktionsbasierte Zustellung für das angepasste Event order_update fest. Filtern Sie nach der passenden Event-Eigenschaft order_status, damit nur dieser Status in diese Kampagne gelangt.
  3. Verwenden Sie Liquid-Event-Eigenschaften, um den Titel oder Text der Karte zu personalisieren:
Order {{event_properties.${order_number}}} is {{event_properties.${order_status}}}.
  1. 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
  1. 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:

  1. Lesen Sie order_number und order_hierarchy aus extras aus.
  2. Ermitteln Sie die höchste order_hierarchy unter den Karten mit derselben order_number.
  3. Wenn die Hierarchie der Karte dem höchsten Wert entspricht, zeigen Sie sie an (ordnen Sie die Kartenfelder Ihrem angepassten UI-Objekt zu).
  4. 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

  1. Senden Sie eine Abfolge von order_update-Events für dieselbe Bestellung mit aufsteigenden order_status-Werten.
  2. Prüfen Sie, ob jede Statuskampagne die erwartete Karte sendet und Liquid korrekt aufgelöst wird.
  3. Prüfen Sie, ob der Feed eine Karte pro Bestellung anzeigt und Karten mit niedrigerer Hierarchie entfernt werden.
  4. Prüfen Sie, ob Impressionen, Klicks und Entfernungen für Ihre angepasste UI in den Kampagnen-Analytics erscheinen.
New Stuff!