SDK-Datenerfassung
Wenn Sie das Braze SDK in Ihre App oder Website integrieren, sammelt Braze automatisch bestimmte Arten von Daten. Einige dieser Daten sind für unsere Prozesse unerlässlich, und einige dieser Daten können je nach Ihren Bedürfnissen ein- oder ausgeschaltet werden. Sie können Braze auch so konfigurieren, dass es weitere Datentypen erfasst, um Segmentierung und Messaging zu verbessern.
Braze ist auf eine flexible Datenerfassung ausgelegt. Daher können Sie das Braze SDK auf folgende Weise integrieren:
- Minimale Integration: Braze sammelt automatisch Daten, die für die Kommunikation mit den Braze-Diensten erforderlich sind.
- Optionale Daten, die standardmäßig erfasst werden: Braze erfasst automatisch bestimmte Daten, die für die meisten Anwendungsfälle nützlich sind. Sie können die automatische Erfassung dieser Daten deaktivieren, wenn sie für die Kommunikation mit den Diensten von Braze nicht erforderlich sind.
- Optionale Daten, die standardmäßig nicht erfasst werden: Braze erfasst bestimmte Daten, die für einzelne Anwendungsfälle nützlich sind, tut dies aber aus allgemeinen Compliance-Gründen nicht automatisch. Sie können diese Daten in den Fällen erfassen lassen, in denen dies zweckdienlich ist.
- Personalisierte Integration: Braze bietet Ihnen die Möglichkeit, zusätzlich zu den standardmäßigen optionalen Daten weitere Daten zu erfassen.
Minimale Integration
Hier finden Sie die zwingend erforderlichen Daten, die Braze bei der Initialisierung des SDK erzeugt und empfängt. Diese Daten sind nicht konfigurierbar und für die Kernfunktionen der Plattform unerlässlich. Mit Ausnahme des Beginns und des Endes einer Sitzung werden alle anderen automatisch erfassten Daten nicht auf Ihre Datenpunkt-Nutzung angerechnet.
| Attribut | Beschreibung | Hintergründe der Datenerfassung |
|---|---|---|
| App-Version-Name / App-Version-Code |
Die aktuellste Version der App | Dieses Attribut wird verwendet, um Nachrichten über die Kompatibilität der App-Version an die richtigen Geräte zu senden. Es kann verwendet werden, um Nutzer:innen über Dienstunterbrechungen oder Fehler zu informieren. |
| Land | Durch Geolocation der IP-Adresse identifiziertes Land. Wenn die Geolocation der IP-Adresse nicht verfügbar ist, wird dies durch die Lokalisierung des Geräts identifiziert. Der Wert könnte alternativ auch derjenige sein, den die SDKs direkt mit setCountry festlegen. Beachten Sie jedoch, dass die Übergabe eines Attributwerts über SDK oder API Datenpunkte protokolliert. Nachdem das Land manuell festgelegt wurde (über die SDK-Methode, REST API oder CSV-Upload), aktualisiert das SDK diesen Wert nicht mehr automatisch. |
Dieses Attribut wird verwendet, um Nachrichten auf der Grundlage des Standorts zu versenden. |
| Geräte-ID | Bezeichner des Geräts, ein zufällig generierter String | Dieses Attribut wird verwendet, um die Geräte der Nutzer:innen zu unterscheiden und Nachrichten an das richtige Gerät zu senden. |
| OS und OS-Version | Aktuell gemeldetes Gerät oder Browser und Geräte- oder Browserversion | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. Es kann auch im Rahmen der Segmentierung verwendet werden, um Nutzer:innen für Upgrades von App-Versionen anzusprechen. |
| Sitzungsbeginn und Sitzungsende | Wenn Nutzer:innen beginnen, Ihre integrierte App oder Website zu nutzen | Das Braze SDK meldet die vom Braze-Dashboard verwendeten Sitzungsdaten, um das Nutzer-Engagement und andere Analytics zu berechnen, die für das Verständnis Ihrer Nutzer:innen wichtig sind. Wann genau Sitzungsbeginn und -ende von Ihrer App bzw. Website gemeldet werden, kann von Entwickler:innen konfiguriert werden (Android, iOS, Web). |
| SDK-Daten zur Nachrichteninteraktion | Direkte Push-Öffnungen, In-App-Nachricht-Interaktionen, Content-Card-Interaktionen | Dieses Attribut wird zur Qualitätskontrolle verwendet, z. B. um zu überprüfen, ob eine Nachricht eingegangen ist und ob sie nicht doppelt gesendet wurde. |
| SDK-Version | Aktuelle SDK-Version | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden und Dienstunterbrechungen zu vermeiden. |
| Sitzungs-ID und -Zeitstempel | Sitzungskennung: zufällige Zeichenfolge und Zeitstempel | Wird verwendet, um festzustellen, ob Nutzer:innen eine neue oder eine bestehende Sitzung starten, und um zu bestimmen, ob Nachrichten, die für diese Nutzer:innen bestimmt sind, erneut zugestellt werden können. Bestimmte Messaging-Kanäle wie In-App-Nachrichten und Content Cards werden zu Beginn der Sitzung mit dem Gerät synchronisiert. Unser Backend verwendet dann die Daten des letzten Kontakts mit den Servern von Braze (die das Gerät speichert und zurücksendet), um festzustellen, ob Nutzer:innen für neue Nachrichten berechtigt sind. |
Berechnete Metriken
Braze erstellt Metriken anhand von SDK-Daten, Interaktionsdaten zu Nicht-SDK-Nachrichten und daraus abgeleiteten Informationen. Zur Verdeutlichung: Die errechneten Daten werden nicht vom SDK erfasst, sondern von Braze generiert. Nutzerprofile enthalten sowohl erfasste als auch generierte Daten.
Die berechneten Metriken umfassen kanalbasierte Metriken (aufgeführt im Glossar der Berichtsmetriken) und die folgenden Attribute.
| Attribut | Beschreibung |
|---|---|
| Zuerst verwendete App | Uhrzeit |
| Zuletzt verwendete App | Uhrzeit |
| Sitzungsanzahl insgesamt | Zahl |
| Angeklickte Karte | Zahl |
| Zuletzt empfangene Nachricht | Uhrzeit |
| Zuletzt erhaltene E-Mail-Kampagne | Uhrzeit |
| Zuletzt eingegangene Push-Kampagne | Uhrzeit |
| Anzahl der Feedback-Artikel | Zahl |
| Anzahl der Sitzungen in den letzten Y Tagen | Zahl und Uhrzeit |
| Empfangene Nachricht der Kampagne | Boolescher Wert. Dieser Filter gibt Nutzer:innen aus, denen eine frühere Kampagne zugestellt worden ist. |
| Empfangene Nachricht von Kampagne mit Tag | Boolescher Wert. Dieser Filter gibt Nutzer:innen aus, denen eine Kampagne zugestellt worden ist, die derzeit mit einem Tag versehen ist. |
| Retarget-Kampagne | Boolescher Wert. Dieser Filter stellt darauf ab, ob Nutzer:innen in der Vergangenheit eine bestimmte E-Mail, Push- oder In-App-Nachricht geöffnet oder angeklickt haben. |
| Deinstalliert | Boolescher Wert und Uhrzeit |
Wenn Sie nur an der minimalen Integration interessiert sind und Sie mParticle, Segment, Tealium oder GTM verwenden, beachten Sie Folgendes:
- Mobile Plattformen: Sie müssen den Code für derartige Konfigurationen manuell anpassen. mParticle und Segment bieten keine Möglichkeit, dies über ihre Plattform zu tun.
- Web: Die Braze-Integration muss nativ erfolgen, um eine minimale Integration zu ermöglichen. Tag-Manager bieten keine Möglichkeit, dies über ihre Plattform zu tun.
Standardmäßig erfasste optionale Daten
Zusätzlich zu den Daten für die minimale Integration werden die folgenden Attribute automatisch von Braze erfasst, wenn Sie die SDK-Integration initialisieren. Sie können sich gegen die Erfassung dieser Attribute entscheiden, um eine minimale Integration zu ermöglichen.
| Attribut | Plattform | Beschreibung | Hintergründe der Datenerfassung |
|---|---|---|---|
| Browsername | Internet | Name des Browsers | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Browser zu senden. Es kann auch für die browserbasierte Segmentierung verwendet werden. |
| Gerätegebietsschema | Android, iOS, Internet | Das Standardgebietsschema des Geräts | Dieses Attribut wird verwendet, um Nachrichten in die bevorzugte Sprache der Nutzer:innen zu übersetzen. |
| Neuestes Gerätegebietsschema | Android, iOS, Internet | Das letzte Standardgebietsschema des Geräts | Dieses Attribut stammt aus den Geräteeinstellungen der Nutzer:innen und wird verwendet, um Nachrichten in die bevorzugte Sprache der Nutzer:innen zu übersetzen. Es ist unabhängig vom Attribut Most Recent Location. |
| Gerätemodell | Android, iOS | Die spezifische Hardware des Geräts | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. Es kann auch im Rahmen der Segmentierung verwendet werden. |
| Gerätemarke | Android | Die Marke des Geräts (z. B. Samsung) | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. |
| Mobilfunkanbieter | Android, iOS | Der Mobilfunkanbieter | Dieses Attribut wird optional für das Targeting von Nachrichten verwendet. Hinweis: Dieses Feld ist seit iOS 16 veraltet und wird in einer zukünftigen iOS-Version standardmäßig auf -- gesetzt. |
| Sprache | Android, iOS, Internet | Geräte- oder Browsersprache, entnommen aus dem Gebietsschema des Geräts. | Dieses Attribut wird verwendet, um Nachrichten in die bevorzugte Sprache der Nutzer:innen zu übersetzen. Es basiert auf dem Gebietsschema des Geräts. |
| Benachrichtigungseinstellungen | Android, iOS, Internet | Ob in dieser App Push-Benachrichtigungen aktiviert sind. | Dieses Attribut wird verwendet, um Push-Benachrichtigungen zu aktivieren. |
| Auflösung | Android, iOS, Internet | Geräte- oder Browserauflösung | Wird optional für gerätebasiertes Messaging-Targeting verwendet. Das Format dieses Wertes ist „<width>x<height>“. |
| Zeitzone | Android, iOS, Internet | Zeitzone des Geräts oder des Browsers | Dieses Attribut wird verwendet, um Nachrichten je nach Ortszeit der Nutzer:innen zum richtigen Zeitpunkt zu versenden. |
| User-Agent | Internet | User-Agent | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. Es kann auch im Rahmen der Segmentierung verwendet werden. |
Wenn Sie mehr über Geräteeigenschaften (wie Mobilfunkanbieter, Zeitzone, Auflösung etc.) erfahren möchten, lesen Sie die Dokumentation zur jeweiligen Plattform: Android, iOS, Web.
Standardmäßig nicht erfasste Daten
Standardmäßig werden die folgenden Attribute nicht erfasst. Jedes Attribut muss manuell integriert werden.
| Attribut | Plattform | Beschreibung | Warum es nicht erfasst wird |
|---|---|---|---|
| Ad-Tracking auf Gerät aktiviert | Android, iOS | Auf iOS:set(adTrackingEnabled:)Auf Android: Braze.setGoogleAdvertisingId() |
Diese Eigenschaft erfordert zusätzliche App-Berechtigungen, die von der integrierenden Partei erteilt werden müssen. |
| Geräte-IDFA | iOS | Gerätekennung für Werbetreibende | Erfordert das Ad Tracking Transparency Framework, das eine zusätzliche Datenschutzprüfung durch den App Store veranlasst. Weitere Informationen finden Sie unter set(identifierForAdvertiser:) |
| Google Advertising ID | Android | Bezeichner für Werbung in Google Play Apps | Dazu muss die App die GAID abrufen und sie an Braze weitergeben. Weitere Einzelheiten finden Sie unter Optionale Google Advertising ID. |
| Jüngster Standort | Android, iOS | Dies ist der letzte bekannte GPS-Standort des Geräts der Nutzer:innen. Dieser wird beim Start der Sitzung aktualisiert und im Nutzerprofil gespeichert. | Dazu müssen Nutzer:innen Ihrer App die Standortberechtigung erteilen. |
Das Braze SDK speichert keine IP-Adressen lokal.
Personalisierte Integration
Um das Beste aus Braze herauszuholen, implementieren unsere SDK-Integratoren häufig die SDKs von Braze und protokollieren zusätzlich zu den automatisch erfassten Daten angepasste Attribute, angepasste Events und Kauf-Events, die für ihr Unternehmen relevant sind.
Eine personalisierte Integration ermöglicht eine angepasste Kommunikation, die auf die Erfahrungen Ihrer Nutzer:innen abgestimmt ist.
Braze sperrt bzw. blockiert Nutzer:innen mit mehr als 5.000.000 Sitzungen („Dummy-Nutzer:innen“) und nimmt deren SDK-Events nicht mehr auf. Weitere Informationen finden Sie unter Spam-Blockierung.