Ausführliche Protokolle lesen

Auf dieser Seite wird erläutert, wie die ausführliche Protokollausgabe des Braze SDK interpretiert werden kann. Für jeden Messaging-Kanal finden Sie die wichtigsten Protokolleinträge, deren Bedeutung und häufige Probleme, auf die Sie achten sollten.

Bevor Sie beginnen, stellen Sie sicher, dass Sie die ausführliche Protokollierung aktiviert haben und wissen, wie Sie Protokolle auf Ihrer Plattform erfassen können.

Sessions

Sessions bilden die Grundlage der Braze-Analytics und der Nachrichtenzustellung. Viele Messaging-Features – darunter In-App Messages und Content Cards – sind darauf angewiesen, dass eine gültige Session gestartet wird, bevor sie funktionieren können. Wenn Sessions nicht korrekt protokolliert werden, sollten Sie dies zuerst untersuchen. Weitere Informationen zur Aktivierung des Session-Trackings finden Sie unter Schritt 5: Nutzer:innen-Session-Tracking aktivieren.

Hinweis

Beginnen Sie die SDK-Fehlerbehebung mit Sessions. Wenn Sessions nicht protokolliert werden, verhalten sich In-App Messages, Content Cards und viele Analytics-Events nicht wie erwartet. Nachdem Sie die Session-Start-/End-Einträge bestätigt haben, überprüfen Sie die Zeilen für angepasste Events in derselben Log-Erfassung. Siehe Verbose Logging, um das Logging zu aktivieren und einen teilbaren Export zu erstellen.

Wichtige Log-Einträge

• swift
• android

1

Started user session (id: <SESSION_ID>)

1
2
3
4
5

Ended user session (id: <SESSION_ID>, duration: <DURATION>s)
Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: sessionEnd(duration: <DURATION>)

1
2
3
4

New session created with ID: <SESSION_ID>
Session start event for new session received
Completed the openSession call
Opened session with activity: <ACTIVITY_NAME>

1
2
3

Closed session with activity: <ACTIVITY_NAME>
Closed session with session ID: <SESSION_ID>
Requesting data flush on internal session close flush timer.

Was Sie überprüfen sollten

• Stellen Sie sicher, dass ein Session-Start-Log erscheint, wenn die App gestartet wird.
• Wenn Sie keinen Session-Start sehen, überprüfen Sie, ob das SDK korrekt initialisiert ist und ob openSession (Android) aufgerufen wird.
• Bestätigen Sie unter Android, dass eine Netzwerkanfrage an den Braze-Endpunkt gesendet wird. Wenn Sie diese nicht sehen, überprüfen Sie Ihren API-Schlüssel und die Endpunkt-Konfiguration.

Push-Benachrichtigungen

Push-Benachrichtigungsprotokolle helfen Ihnen zu überprüfen, ob Geräte-Token registriert sind, Benachrichtigungen zugestellt werden und Klick-Events getrackt werden.

Token-Registrierung

Wenn eine Sitzung beginnt, registriert das SDK das Push-Token des Geräts bei Braze.

• swift
• android

1
2
3
4

Updated push notification authorization:
- authorization: authorized

Received remote notifications device token: <PUSH_TOKEN>

1
2
3
4
5
6

"attributes": [
  {
    "push_token": "<PUSH_TOKEN>",
    "user_id": "<USER_ID>"
  }
]

1
2
3
4

"device": {
  "ios_push_auth": "authorized",
  "remote_notification_enabled": 1
}

1

Registering for Firebase Cloud Messaging token using sender id: <SENDER_ID>

Was Sie überprüfen sollten

• Wenn push_token im Anfragekörper fehlt, wurde das Token nicht erfasst. Überprüfen Sie die Push-Einrichtung in Ihrer App-Konfiguration.
• Wenn ios_push_auth den Wert denied oder provisional anzeigt, hat die bzw. der Nutzer:in keine vollständige Push-Berechtigung erteilt.
• Wenn auf Android SENDER_ID_MISMATCH angezeigt wird, aktualisieren Sie Ihre FCM-Sender-ID, damit sie mit Ihrem Firebase-Projekt übereinstimmt.

Push-Zustellung und Klick

Wenn eine Push-Benachrichtigung angetippt wird, protokolliert das SDK die Verarbeitung und Klick-Events.

• swift
• android

1
2
3
4
5
6
7
8
9
10
11
12
13

Processing push notification:
- date: <TIMESTAMP>
- silent: false
- userInfo: {
  "ab": { ... },
  "ab_uri": "<DEEP_LINK_OR_URL>",
  "aps": {
    "alert": {
      "body": "<MESSAGE_BODY>",
      "title": "<MESSAGE_TITLE>"
    }
  }
}

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: pushClick(campaignId: ...)

1
2
3
4

Opening '<URL>':
- channel: notification
- useWebView: false
- isUniversalLink: false

1

BrazeFirebaseMessagingService: Got Remote Message from FCM

Was Sie überprüfen sollten

• Überprüfen Sie, ob der Push-Payload den erwarteten title, body und etwaige Deeplinks (ab_uri) enthält.
• Bestätigen Sie, dass nach dem Antippen ein pushClick-Event protokolliert wird.
• Wenn das Klick-Event fehlt, prüfen Sie, ob Ihr App-Delegate oder Benachrichtigungs-Handler Push-Events korrekt an das Braze SDK weiterleitet.

In-App-Nachrichten

In-App-Nachrichten-Logs zeigen Ihnen den gesamten Lebenszyklus: Zustellung vom Server, Auslösung basierend auf Events, Anzeige, Impression-Protokollierung und Klick-Tracking.

Nachrichtenzustellung

Wenn Nutzer:innen eine Sitzung starten und für eine In-App-Nachricht infrage kommen, empfängt das SDK den Nachrichten-Payload vom Server.

• swift
• android

1
2
3
4
5
6
7
8
9

"templated_message": {
  "data": {
    "message": "...",
    "type": "HTML",
    "message_close": "SWIPE",
    "trigger_id": "<TRIGGER_ID>"
  },
  "type": "inapp"
}

1

Triggering action: <CAMPAIGN_BSON_ID>

Nachrichtenanzeige und Impression

• swift
• android

1
2
3

In-app message ready for display:
- triggerId: (campaignId: <CAMPAIGN_ID>, ...)
- extras: { ... }

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageImpression(triggerIds: [...])

1

handleExistingInAppMessagesInStackWithDelegate:: Displaying in-app message

Klick- und Button-Events

Wenn Nutzer:innen auf einen Button tippen oder die Nachricht schließen:

• swift
• android

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: inAppMessageButtonClick(triggerIds: [...], buttonId: "<BUTTON_ID>")

1

No matching trigger for event.

Was Sie überprüfen sollten

• Wenn die In-App-Nachricht nicht angezeigt wird, überprüfen Sie, ob zuerst ein Sitzungsstart protokolliert wurde.
• Filtern Sie nach Antworten von Ihrem konfigurierten Braze-Endpunkt, um zu bestätigen, dass der Nachrichten-Payload zugestellt wurde.
• Wenn Impressionen nicht protokolliert werden, überprüfen Sie, ob Sie einen benutzerdefinierten inAppMessageDisplay-Delegate implementiert haben, der die Protokollierung unterdrückt.
• Wenn „No matching trigger for event“ erscheint, ist das normal und bedeutet, dass keine zusätzlichen In-App-Nachrichten für dieses Event konfiguriert sind.

Content Cards

Mithilfe von Content-Card-Protokollen können Sie überprüfen, ob Karten mit dem Gerät synchronisiert und den Nutzer:innen angezeigt werden und ob Interaktionen (Impressionen, Klicks, Ablehnungen) nachverfolgt werden.

Kartensynchronisierung

Content Cards werden zu Beginn der Sitzung und bei einer manuellen Aktualisierung synchronisiert. Wenn keine Sitzung protokolliert ist, werden keine Content Cards angezeigt.

• swift
• android

1
2
3
4
5
6
7
8
9
10
11

"cards": [
  {
    "id": "<CARD_ID>",
    "tt": "<CARD_TITLE>",
    "ds": "<CARD_DESCRIPTION>",
    "tp": "short_news",
    "v": 0,
    "cl": 0,
    "p": 1
  }
]

1

Requesting content cards sync.

Impressionen, Klicks und Ablehnungen

• swift
• android

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardImpression(cardIds: [...])

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardClick(cardIds: [...])

1
2
3

Opening '<URL>':
- channel: contentCard
- useWebView: true

1
2
3
4

Logged event:
- userId: <USER_ID>
- sessionId: <SESSION_ID>
- data: contentCardDismissed(cardIds: [...])

Was zu überprüfen ist

• Keine Karten angezeigt: Überprüfen Sie, ob ein Sitzungsstart protokolliert wurde. Content Cards erfordern eine aktive Sitzung, um synchronisiert zu werden.
• Fehlende Karten für neue Nutzer:innen: Neue Nutzer:innen sehen möglicherweise bei ihrer ersten Sitzung keine Content Cards bis zur nächsten Sitzung. Dies ist das erwartete Verhalten.
• Karte überschreitet die Größenbeschränkung: Content Cards über 2 KB werden nicht angezeigt, und die Nachricht wird abgebrochen.
• Karte bleibt nach Beendigung der Campaign bestehen: Überprüfen Sie, ob die Synchronisierung nach Beendigung der Campaign abgeschlossen wurde. Content Cards werden nach einer erfolgreichen Synchronisierung vom Gerät entfernt. Stellen Sie beim Beenden einer Campaign sicher, dass die Option zum Entfernen aktiver Karten aus den Feeds der Nutzer:innen ausgewählt ist.

Deeplinks

Deeplink-Protokolle erscheinen kanalübergreifend bei Push-Benachrichtigungen, In-App-Nachrichten und Content Cards. Die Protokollstruktur ist unabhängig vom Quellkanal konsistent.

• swift
• android

1
2
3
4
5

Opening '<DEEP_LINK_URL>':
- channel: <SOURCE_CHANNEL>
- useWebView: false
- isUniversalLink: false
- extras: { ... }

1

adb shell am start -W -a android.intent.action.VIEW -d "<YOUR_DEEP_LINK>" "<YOUR_PACKAGE_NAME>"

Worauf Sie achten sollten

• Überprüfen Sie, ob die Deeplink-URL mit der in der Campaign konfigurierten URL übereinstimmt.
• Wenn der Deeplink über einen Kanal (z. B. Push) funktioniert, aber über einen anderen nicht (z. B. Content Cards), prüfen Sie, ob Ihre Deeplink-Verarbeitungsimplementierung alle Kanäle unterstützt.
• Unter iOS erfordern Universal Links eine zusätzliche Verarbeitung. Wenn Universal Links über Braze-Kanäle nicht funktionieren, stellen Sie sicher, dass Ihre App das BrazeDelegate-Protokoll für die URL-Verarbeitung implementiert.
• Unter Android prüfen Sie, ob die automatische Deeplink-Verarbeitung deaktiviert ist, wenn Sie einen benutzerdefinierten Handler verwenden. Andernfalls kann der Standard-Handler mit Ihrer Implementierung in Konflikt geraten.

Nutzer:innen-Identifizierung

Wenn ein:e Nutzer:in mit einer external_id identifiziert wird, protokolliert das SDK ein Change-User-Event.

• android
• swift

1

changeUser called with: <EXTERNAL_ID>

1

"user_id": "<EXTERNAL_ID>"

Netzwerk-Anfragen

Ausführliche Protokolle enthalten vollständige HTTP-Anfrage- und Antwortdetails für die SDK-Kommunikation mit Braze-Servern. Diese sind nützlich für die Diagnose von Verbindungsproblemen.

Anfragestruktur

Filtern Sie nach Anfragen an Ihren konfigurierten Braze-Endpunkt (z. B. sdk.iad-01.braze.com). Die Anfragestruktur umfasst:

• swift
• android

1
2
3
4
5
6
7

[http] request POST: <YOUR_BRAZE_ENDPOINT>
- Headers:
  - Content-Type: application/json
  - X-Braze-Api-Key: <REDACTED>
  - X-Braze-Req-Attempt: 1
  - X-Braze-Req-Tokens-Remaining: <COUNT>
- Body: { ... }

1

Making request(id = <REQUEST_ID>) to <YOUR_BRAZE_ENDPOINT>

Was Sie prüfen sollten

• API-Schlüssel: Überprüfen Sie, ob XBraze-ApiKey mit dem API-Schlüssel Ihres Workspace übereinstimmt.
• Endpunkt: Bestätigen Sie, dass die Anfrage-URL mit Ihrem konfigurierten SDK-Endpunkt übereinstimmt.
• Wiederholungsversuche: XBraze-Req-Attempt größer als 1 zeigt an, dass das SDK eine fehlgeschlagene Anfrage erneut versucht, was auf Verbindungsprobleme hindeuten kann.
• Rate-Limiting: XBraze-Req-Tokens-Remaining zeigt die verbleibenden Anfrage-Token an. Ein niedriger Wert kann darauf hinweisen, dass das SDK die Rate-Limits erreicht.
• Fehlende Anfragen: Wenn Sie auf Android nach dem Sitzungsstart keine Anfrage an den Braze-Endpunkt sehen, überprüfen Sie Ihren API-Schlüssel und die Endpunkt-Konfiguration.

Häufige Event-Abkürzungen

In ausführlichen Log-Payloads verwendet Braze abgekürzte Event-Namen. Hier ist eine Übersicht:

Fehlerbehebung

Geofences werden auf Android SDK 13.1.0–15.x nicht ausgelöst

Das Braze Android SDK 13.1.0 bis 15.x hatte eine Regression, die dazu führen konnte, dass Geofence-Update-Events nicht aufgezeichnet wurden. Auf Geräten mit Android 10 oder älter konnten auch Standortaktualisierungen beim Sitzungsstart fehlschlagen. Führen Sie ein Upgrade auf Android SDK 16.0.0 oder höher durch. Informationen zur SDK-Einrichtung finden Sie unter Geofences.

Wann kann ein:e Nutzer:in 0 Sitzungen in ihrem Profil aufweisen?

Ein Nutzerprofil kann 0 Sitzungen anzeigen, wenn Sie den/die Nutzer:in über die REST API (/users/track) oder einen CSV-Import ohne die Felder First session oder Last session importieren. Sitzungen werden aufgezeichnet, wenn Nutzer:innen über das SDK mit Ihrer App interagieren. Weitere Details finden Sie unter Nutzerprofil hat 0 Sitzungen.

Diskrepanzen bei Nutzerdaten bei gleichzeitiger Verwendung von SDK und REST API

Wenn Sie das SDK und die REST API gleichzeitig verwenden, können Race-Conditions zu Datendiskrepanzen führen. Nachdem Sie changeUser() aufgerufen haben, lassen Sie das SDK ausstehende Daten senden, bevor Sie kritische REST-API-Aufrufe durchführen. Vermeiden Sie die Stapelverarbeitung zeitkritischer Updates und erwägen Sie, eine kurze Verzögerung zwischen SDK- und API-Anfragen einzufügen. Informationen zum Verhalten von changeUser() finden Sie unter Wie changeUser() funktioniert.

Daten erreichen Braze nicht

Wenn Daten Braze nicht erreichen, stellen Sie sicher, dass Ihre Firewall ausgehenden Datenverkehr zu Braze-API-Endpunkten und CDN-Anbietern zulässt. Führen Sie einen MTR-Test durch und verwenden Sie Fastly Debug, während das Problem auftritt. Informationen zu Allowlisting und Fehlerbehebung bei der Konnektivität finden Sie unter API-Netzwerkverbindungsprobleme.