Zum Inhalt springen

Push-Benachrichtigungen in einem Content-Card-Nachrichten-Posteingang dauerhaft speichern

Halten Sie wichtige Push-Inhalte verfügbar, auch nachdem eine Benachrichtigung geschlossen wurde. Senden Sie eine passende Content-Card in einen angepassten In-App-Nachrichten-Posteingang und filtern Sie diesen Posteingang mit Schlüssel-Wert-Paaren.

Über dieses Beispiel

Pyrite Financial, eine fiktive Mobile-Banking-Marke, beginnt damit, Push-Benachrichtigungen mit Braze zu versenden. Nachdem Verbraucher:innen eine Push-Benachrichtigung geschlossen haben, verschwindet die Nachricht aus der UI des Geräts.

Das Marketing- und das Produktteam möchten, dass Verbraucher:innen über ein Glockensymbol in der App einen persistenten Nachrichten-Posteingang öffnen können. Dort können Verbraucher:innen Hinweise zu bereitgestellten Dokumenten, Transaktionsbenachrichtigungen und Nachrichten zu geplanten Ausfällen erneut öffnen.

Content Cards werden bereits in einem anderen Bereich der App verwendet (zum Beispiel für Artikel). Dieses Muster ergänzt eine zweite Content-Card-Platzierung: einen Nachrichten-Posteingang, der Folgendes empfangen kann:

  • Nur eine Push-Benachrichtigung
  • Nur eine Content-Card
  • Eine Push-Benachrichtigung zusammen mit einer passenden Content-Card

Ein Tippen auf die Push-Benachrichtigung und ein Tippen auf die Content-Card können per Deeplink zum selben Ziel führen (zum Beispiel zu den Dokumenten). Bei manchen Push-Nachrichten öffnet das Tippen den Posteingang selbst.

Dieses Beispiel zeigt, wie Sie die Zustellung von Push-Benachrichtigungen und Content Cards orchestrieren. Wie Sie die angepasste Posteingangs-UI im SDK erstellen, erfahren Sie unter Tutorial: Content-Card-Posteingänge. Details zum Kartenlayout finden Sie unter Angepasste Content Cards erstellen.

Überlegungen

  • Content Cards bleiben bis zu 30 Tage nach dem Versand verfügbar. Sie zählen zum Feed-Limit von 250 nicht abgelaufenen Karten pro Nutzer:in, einschließlich geschlossener Karten. Jede Karten-Payload ist nach dem Rendern von Liquid auf 2 KB begrenzt. Weitere Informationen finden Sie unter Content-Card erstellen.
  • Wenn Sie Content Cards bereits an anderer Stelle in Ihrer App verwenden, nutzen Sie Schlüssel-Wert-Paare (zum Beispiel feed_type: inbox im Gegensatz zu feed_type: article), um separate Platzierungen zu erstellen. Jeder Bildschirm zeigt dann nur seine eigenen Karten an. Alle Karten teilen sich einen SDK-Feed, bis Ihre App sie filtert. Weitere Informationen finden Sie unter Content-Card-Feeds anpassen.
  • Content Cards werden beim Start einer Sitzung automatisch aktualisiert. Für zusätzliche Aktualisierungen verwenden Sie requestContentCardsRefresh. Aktualisieren Sie, wenn der Posteingang geöffnet wird oder bei Pull-to-Refresh. Vermeiden Sie kontinuierliche Aktualisierungen oder Aktualisierungen bei jedem Tab-Wechsel, damit Sie die Rate-Limits für Aktualisierungen nicht erreichen.
  • Angepasste Posteingangs-UIs müssen Impressionen, Klicks und Schließvorgänge manuell protokollieren. Badges für ungelesene Nachrichten (zum Beispiel ein Punkt auf dem Glockensymbol) werden von Ihrer App verwaltet.
  • Jede Push-Benachrichtigung, die im Posteingang erhalten bleiben soll, benötigt eine passende Content-Card. Fügen Sie die richtigen Schlüssel-Wert-Paare und Deeplinks hinzu. Verwenden Sie ein Multichannel-Campaign-Template oder ein Canvas-Template, damit der Content-Card-Kanal immer enthalten ist.
  • Verwenden Sie eine Multichannel-Campaign für einen gleichzeitigen Versand von Push-Benachrichtigung und Content-Card ohne Folgelogik. Verwenden Sie Canvas, wenn Sie Verzögerungen, Verzweigungen, erneute Interaktion oder spätere Schritte auf Basis des Engagements benötigen.

Einrichtung

Legen Sie die extras (Schlüssel-Wert-Paare) fest, die die App zum Filtern und Verarbeiten von Posteingangskarten verwendet. Die folgende Tabelle zeigt ein Beispiel.

Schlüssel Beispielwert Zweck
feed_type inbox Karte in den Nachrichten-Posteingang aufnehmen (aus anderen Feeds ausschließen)
message_type document, outage, transaction Optionale Gruppierung oder Gestaltung in der Posteingangs-UI
doc_id 12345 Optionale ID, damit die App die Karte schließen kann, wenn Verbraucher:innen das betreffende Dokument öffnen

Legen Sie die Deeplink-Ziele für jeden Anwendungsfall fest. Die folgende Tabelle listet Beispielziele auf.

Anwendungsfall Deeplink der Push-Benachrichtigung Deeplink der Content-Card
Neues Dokument oder neue Transaktion Bildschirm für Dokumente oder Transaktionen Gleiches Ziel
Geplanter Ausfall Nachrichten-Posteingang Kartendetails im Posteingang oder Statusseite

Bitten Sie Ihr Entwicklerteam, Filterung, einen optionalen Ungelesen-Status und Analytics auf Basis dieser Schlüssel zu implementieren. Verwenden Sie dieselben Schlüssel in jeder Content-Card für den Posteingang.

Schritt 2: Multichannel-Campaign oder Canvas auswählen

Wählen Sie je nach Journey eine Multichannel-Campaign oder ein Canvas aus. Die folgende Tabelle vergleicht die beiden Wege.

Situation Empfohlener Weg
Einmalige oder geplante Ankündigung ohne Folgeaktion (zum Beispiel geplanter Ausfall) Multichannel-Campaign mit Push-Benachrichtigungen und Content Cards
Event-getriggerte Journey mit möglicher Folgeaktion (zum Beispiel Dokument verfügbar, danach Erinnerung, falls ungelesen) Canvas mit einem Nachrichtenschritt, der Push-Benachrichtigungen und Content Cards enthält

Ein Beispiel für dieses Muster finden Sie unter Content Cards in Canvas – Push-Benachrichtigungs-Posteingang.

Schritt 3: Nachrichtenzustellung konfigurieren

Multichannel-Campaign

  1. Gehen Sie zu Messaging > Campaigns, wählen Sie Campaign erstellen und dann Multichannel aus.
  2. Wählen Sie im Schritt Verfassen die Option Kanal hinzufügen aus und fügen Sie Push und Content Cards hinzu.
  3. Verfassen Sie die Push-Benachrichtigung. Legen Sie unter On-Click-Verhalten den Deeplink zum Posteingang oder zu einem anderen Ziel in der App fest.
  4. Verfassen Sie die Content-Card mit passendem oder ergänzendem Text. Wählen Sie im Tab Einstellungen die Option Neues Paar hinzufügen aus und fügen Sie die Schlüssel-Wert-Paare für den Posteingang aus Schritt 1 hinzu. Legen Sie den Deeplink der Content-Card fest.
  5. Planen Sie eine aktionsbasierte Zustellung für Events wie ein neues Dokument. Verwenden Sie für geplante Ausfälle eine geplante Zustellung. Definieren Sie die Zielgruppe.
  6. Speichern Sie ein Template oder eine Checkliste, damit zukünftige Push-Campaigns mit Posteingang den Content-Card-Kanal und dieselben extras enthalten.

Canvas

  1. Gehen Sie zu Messaging > Canvas und wählen Sie dann Canvas erstellen aus. Legen Sie den Entry-Zeitplan und die Zielgruppe für die Journey fest (zum Beispiel ein angepasstes Event, wenn ein Dokument bereitsteht).
  2. Fügen Sie einen Nachrichtenschritt hinzu, der sowohl Push als auch Content Cards enthält. Verwenden Sie aufeinanderfolgende Nachrichtenschritte, wenn der Ablauf dies erfordert.
  3. Verfassen Sie die Push-Benachrichtigung und die Content-Card auf die gleiche Weise wie bei der Campaign, einschließlich Deeplinks und Schlüssel-Wert-Paaren für den Posteingang.
  4. Fügen Sie optional spätere Schritte hinzu, die das Content-Card-Engagement nutzen. Senden Sie zum Beispiel eine Folgenachricht, wenn innerhalb von 48 Stunden kein Klick erfolgt. Bevor Sie sich auf diese Filter verlassen, prüfen Sie, welche Analytics Ihr angepasster Posteingang protokolliert.

Schritt 4: Verhalten des App-Posteingangs prüfen

Prüfen Sie vor dem Start mit Ihrem Entwicklerteam, ob die App:

  1. Content-Card-Updates einmalig und früh im App-Lebenszyklus abonniert. Verwenden Sie ein bestehendes Abo, wenn Content Cards bereits an anderer Stelle live sind.
  2. Den Posteingang aus zwischengespeicherten Karten rendert und ihn dann beim Öffnen oder per Pull-to-Refresh aktualisiert.
  3. Nach Karten filtert, deren extras zum Posteingang passen (zum Beispiel feed_type gleich inbox).
  4. Impressionen, Klicks und Schließvorgänge für die angepasste UI protokolliert. Verwenden Sie bei React Native diese SDK-Methoden:
    • getCachedContentCards
    • requestContentCardsRefresh
    • logContentCardImpression
    • logContentCardClicked
    • logContentCardDismissed
    • processContentCardClickAction
    • Verwenden Sie bevorzugt getCachedContentCards statt der veralteten Methode getContentCards.
  5. Optional eine Karte schließt, wenn Verbraucher:innen die zugehörige Aktion abschließen (zum Beispiel doc_id in den Dokumenten öffnen). Dies erfolgt zusätzlich zum Schließen per Tippen im Posteingang.

Schritt 5: Die drei Zustellungsmodi testen

  • Nur Push-Benachrichtigung: Die Benachrichtigung kommt an, und es erscheint keine Karte im Posteingang.
  • Nur Content-Card: Die Karte erscheint im Posteingang, und es wird keine Push-Benachrichtigung gesendet.
  • Push-Benachrichtigung und Content-Card: Beide werden zusammen gesendet, und die Deeplinks funktionieren wie vorgesehen. Die Karte bleibt erhalten, nachdem die Push-Benachrichtigung geschlossen wurde. Das Badge für ungelesene Nachrichten, das Schließen und die Analytics funktionieren wie erwartet.

Testen Sie die Aktualisierung bei realistischer Navigation, damit Rate-Limits die Updates des Posteingangs während des Tests nicht blockieren.

New Stuff!