Content-Card-Zustellung mit Benachrichtigungen und Currents überwachen
Nutzen Sie Debugging-Tools, Schwellenwert-Benachrichtigungen, Currents-Events und API-Monitoring, um Einbrüche bei der Content-Card-Zustellung zu erkennen, bevor Nutzer:innen sie melden.
Über dieses Beispiel
Pyrite Financial, eine fiktive Mobile-Banking-Marke, zeigt eine Content-Card in einem eigenen Slot auf dem Startbildschirm ihrer App an. Dieser Slot soll für die meisten Nutzer:innen eine Card enthalten, daher ist ein leerer Slot ein Signal, dem Sie nachgehen sollten.
Dieses Beispiel zeigt, wie Sie:
- Die Content-Card-Integration beim Testen mit dem SDK Debugger, internen Gruppen und dem Event-Nutzerprotokoll validieren
- Schwellenwert-Benachrichtigungen für Campaigns oder Canvases auf Basis des erwarteten Nachrichtenvolumens einrichten
- Canvas-Entries, Content-Card-Sendungen, Impressionen und Abbrüche in Currents verfolgen
- Die REST-API-Endpunkte, die Messaging triggern, auf Volumeneinbrüche und Antworten ungleich 200 überwachen
- Ergänzende Prüfungen des Sendevolumens in Datadog oder mit Canvas-Export-Endpunkten hinzufügen
- Fallback-Verhalten in der App protokollieren, das Braze nicht beobachten kann
Nutzen Sie dieses Vorgehen, wenn eine Content-Card-Platzierung geschäftskritisch ist und Sie ein operatives Signal für einen Einbruch bei der Zustellung benötigen. Jeder Schritt ist optional – beginnen Sie also mit denen, die Ihr Workspace bereits unterstützt.
Überlegungen
- Entscheiden Sie zuerst, ob alle angesprochenen Nutzer:innen in der Platzierung immer eine Card sehen sollen oder ob ein leerer Slot für einige Nutzer:innen akzeptabel ist. Volumen-Schwellenwerte und Fallback-Logik hängen von dieser Antwort ab.
- Braze überwacht die SDK-Konnektivität und meldet Vorfälle auf der Braze-Statusseite. Dieses Beispiel behandelt, was Sie selbst überwachen: die Konfiguration von Campaigns und Canvases, das Nachrichtenvolumen, den API-Traffic und das Fallback-Verhalten in der App.
- Nicht jeder Trigger erzeugt eine Nachricht. Nachdem ein Trigger Braze erreicht hat, können Journey-Logik, Targeting, Frequency-Capping und Rate-Limiting die Anzahl der Sendungen reduzieren. Vergleichen Sie Trigger-Volumen und Sendevolumen als Trend, nicht als 1:1-Entsprechung.
- Monitoring auf Event-Ebene erfordert Currents. Ohne Currents nutzen Sie stattdessen Campaign- und Canvas-Analytics, Schwellenwert-Benachrichtigungen und die REST-Export-Endpunkte.
- Datadog-Metriken melden nur Sendezahlen und können leicht vom Braze-Dashboard und von Currents abweichen.
- Zu häufige Aktualisierungen können einem Rate-Limit unterliegen. Das SDK erzwingt Rate-Limits pro Gerät für Anfragen zur Aktualisierung von Content Cards. Rufen Sie die Aktualisierungsmethode an sinnvollen Punkten im Lebenszyklus der Nutzer:innen auf, statt sie wiederholt kurz hintereinander aufzurufen. Siehe Rate-Limit für Content Cards und Latenz für Content Cards als Banner verbessern.
- Liquid kann eine Card absichtlich unterdrücken. Wenn Liquid eine Nachricht abbricht, protokolliert Braze ein Content-Card-Abbruch-Event statt einer Sendung. Betrachten Sie Abbrüche bei bedingten Inhalten als erwartetes Verhalten und nur dann als Signal, wenn sich das Volumen ändert.
- Wenn Ihre App Standardinhalte anzeigt, sobald keine Card verfügbar ist, erfassen Sie dies in Ihren eigenen App-Analytics. Braze weiß nur, was gesendet wurde, nicht, ob Ihre App eine Card oder einen Platzhalter angezeigt hat.
Einrichtung
Schritt 1: Integration vor dem Start validieren
Bestätigen Sie das erwartete Verhalten, damit Benachrichtigungen in der Produktion echte Probleme widerspiegeln und keine Integrationslücken.
- Erstellen Sie eine Debugging-Sitzung im SDK Debugger, um die SDK-Aktivität in Echtzeit zu verfolgen und zu bestätigen, dass Card-Anfragen und Impressionen protokolliert werden.
- Fügen Sie Testkonten zu einer internen Gruppe hinzu, damit Sie die Campaign oder das Canvas vor dem Start mit Testnutzer:innen testen können.
- Prüfen Sie das Event-Nutzerprotokoll für einzelne Nutzer:innen, um zu bestätigen, welche Campaign jede Card an das SDK zugestellt hat.
Notieren Sie die Volumen von Sendungen, Impressionen und Abbrüchen, die Sie beim Testen beobachten. Sie bilden die Grundlage für die Schwellenwerte, die Sie festlegen.
Schritt 2: Schwellenwert-Benachrichtigungen für die Campaign oder das Canvas einrichten
Schwellenwert-Benachrichtigungen informieren Sie per E-Mail oder Webhook, wenn das Nachrichtenvolumen außerhalb des erwarteten Bereichs liegt. Webhook-Benachrichtigungen können an einen Slack-Kanal oder ein Bereitschaftssystem weitergeleitet werden.
- Campaigns: Legen Sie auf der Analytics-Seite der Campaign obere und untere Schwellenwerte fest. Die Einrichtungsschritte finden Sie unter Campaign-Benachrichtigungen.
- Canvases: Konfigurieren Sie auf der Seite Benachrichtigungen verwalten Benachrichtigungen für Nutzer-Entries, gesendete Nachrichten oder beides. Die Einrichtungsschritte finden Sie unter Canvas-Schwellenwert-Benachrichtigungen.
Wählen Sie einen unteren Schwellenwert, der unter dem normalen Volumen und über null liegt, damit bereits ein teilweiser Einbruch eine Benachrichtigung auslöst und Sie nicht erst auf einen vollständigen Ausfall warten.
Schritt 3: Entries, Sendungen und Impressionen in Currents verfolgen
Currents streamt Message-Engagement- und Kundenverhalten-Events nahezu in Echtzeit an Ihre Datenplattform. So können Sie Volumen und Latenz außerhalb des Braze-Dashboards überwachen.
Für eine Content-Card, die aus einem Canvas gesendet wird, decken diese Events den Weg vom Entry bis zur Impression ab.
| Event | Name des Currents-Events | Was es Ihnen sagt |
|---|---|---|
| Canvas-Entry | users.canvas.Entry |
Nutzer:in ist in das Canvas eingetreten, das die Card sendet |
| Content-Card-Sendung | users.messages.contentcard.Send |
Braze hat die Card für die Nutzer:in erstellt und gesendet |
| Content-Card-Impression | users.messages.contentcard.Impression |
Die Card hat eine Impression für die Nutzer:in erfasst |
| Content-Card-Abbruch | users.messages.contentcard.Abort |
Liquid-Logik hat das Senden der Card verhindert |
Überwachen Sie bei einer Content-Card-Kampagne die Events für Sendung, Impression und Abbruch, und filtern Sie nach campaign_id.
- Volumen-Monitoring: Verfolgen Sie Sendungen und Impressionen pro Canvas oder Campaign über ein festes Zeitfenster und lösen Sie eine Benachrichtigung aus, wenn das Volumen unter einen auf historischen Daten basierenden Schwellenwert fällt.
- Latenz-Monitoring: Vergleichen Sie Entry-Events mit Sende-Events für die Erstellungslatenz und Sende-Events mit Impression-Events für die Anzeigelatenz. Wenn Cards erst bei der ersten Impression erstellt werden, vermischt die Messung von Entry bis Impression Erstellungs- und Anzeigezeit. Nutzen Sie daher für die Anzeigelatenz die Zeit von der Sendung bis zur Impression.
Der Vergleich der Volumen über die einzelnen Phasen hinweg hilft, häufige Fehlerursachen zu erkennen:
- Weniger Entries deuten auf ein vorgelagertes Problem mit dem Trigger oder der Zielgruppe hin.
- Gleichbleibende Entries bei weniger Sendungen können auf Journey-Logik, Targeting oder Liquid-Abbrüche hindeuten. Wenn Cards erst bei der ersten Impression erstellt werden, kann es auch bedeuten, dass Nutzer:innen die App noch nicht geöffnet haben.
- Gleichbleibende Sendungen bei weniger Impressionen deuten auf ein Problem zwischen Card-Erstellung und Anzeige hin, etwa bei der SDK-Aktualisierung, dem Rendern der Platzierung oder Rate-Limits auf dem Gerät.
Payloads und Felder der Events finden Sie unter Message-Engagement-Events.
Schritt 4: API-Traffic und Fehlerantworten überwachen
Wenn Ihre Trigger aus Ihren eigenen Systemen stammen, überwachen Sie die API-Ebene, die sie speist.
- Richten Sie API-Nutzungsbenachrichtigungen für die Endpunkte ein, die Ihr Messaging triggern. Konfigurieren Sie Bedingungen für Volumeneinbrüche und eine Zunahme von Antworten ungleich 200.
- Prüfen Sie Antworten ungleich
200für diese Endpunkte. Ein Anstieg der Fehlerantworten kann darauf hindeuten, dass ein aktuelles Release eine fehlerhafte Anfrage eingeführt hat oder dass Aufrufe an ein Rate-Limit stoßen.
Schritt 5: Ergänzende Volumenprüfungen hinzufügen
Nutzen Sie diese Optionen, wenn Sie Daten zum Sendevolumen in einem bestehenden Observability-Tool oder einem geplanten Job benötigen.
- Datadog: Die Datadog-Integration stellt die Metrik
braze.messaging.sentbereit, getaggt mit Bezeichnern für Campaign, Canvas und Canvas-Schritt. Nutzen Sie sie für Sendezahlen eines bestimmten Nachrichtenschritts in einem bestimmten Zeitraum. Diese Zahlen entsprechen ungefähr dem Volumen der Content-Card-Sendungen auf aggregierter Ebene und enthalten keine Nutzer- oder Sende-Bezeichner. - Export-Endpunkte: Fragen Sie
/canvas/data_seriesund/canvas/data_summaryregelmäßig nach Canvas-Entries und gesendeten Nachrichten ab und vergleichen Sie die Ergebnisse verschiedener Durchläufe, um Trends und Anomalien zu erkennen.
Schritt 6: Fallback-Verhalten in Ihrer App protokollieren
Braze meldet, was gesendet wurde, nicht, was Ihre App gerendert hat. Ergänzen Sie App-seitiges Logging oder Analytics für die Fälle, die Braze nicht beobachten kann:
- Die Feed-Aktualisierung wurde abgeschlossen, aber für die Platzierung waren keine Cards verfügbar.
- Die App hat Fallback-Inhalte statt einer Card angezeigt.
- Die Aktualisierungsanfrage ist fehlgeschlagen oder unterlag einem Rate-Limit.
Senden Sie diese als angepasste Events, wenn Sie sie zusammen mit Braze-Daten auswerten möchten, oder behalten Sie sie in Ihrer eigenen Analytics-Plattform und vergleichen Sie sie mit dem Impression-Volumen aus Currents.
Schritt 7: Ursachen eingrenzen, wenn eine Benachrichtigung ausgelöst wird
Gehen Sie diese Prüfungen der Reihe nach durch:
- Vergewissern Sie sich, dass auf der Braze-Statusseite kein aktiver Vorfall gemeldet ist.
- Vergleichen Sie in Currents (oder in den Canvas- und Campaign-Analytics) die Volumen von Entries, Sendungen, Impressionen und Abbrüchen für dasselbe Zeitfenster. Wenn Cards erst bei der ersten Impression erstellt werden, kann das Entry-Volumen das Sendevolumen übersteigen, bis Nutzer:innen die App öffnen – berücksichtigen Sie das beim Vergleich der Volumen.
- Prüfen Sie API-Nutzungsbenachrichtigungen und Antworten ungleich
200für die Endpunkte, die die Nachricht triggern. - Vergleichen Sie App-seitige Fallback-Events oder Events für leere Platzierungen mit dem Impression-Volumen aus Currents.
- Reproduzieren Sie das Problem mit Beispiel-Nutzer:innen im SDK Debugger und im Event-Nutzerprotokoll.