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.
Mindestintegration
Im Folgenden sind die strikt notwendigen Daten aufgeführt, die von Braze generiert und empfangen werden, wenn Sie das SDK initialisieren. Diese Daten sind nicht konfigurierbar und für die Kernfunktionen der Plattform unerlässlich. Mit Ausnahme von Sitzungsstart und Sitzungsende zählen alle anderen automatisch erfassten Daten nicht zu Ihrer Datenpunkt-Nutzung.
| Attribut | Beschreibung | Warum es erfasst wird |
|---|---|---|
| App-Versionsname / App-Versionscode |
Die aktuellste App-Version | Dieses Attribut wird verwendet, um Nachrichten zur App-Versionskompatibilität an die richtigen Geräte zu senden. Es kann genutzt werden, um Nutzer:innen über Dienstunterbrechungen oder Fehler zu informieren. |
| Land | Land, das durch IP-Adress-Geolocation identifiziert wird. Wenn die IP-Adress-Geolocation nicht verfügbar ist, wird es durch die Gerätesprache identifiziert. Der Wert kann alternativ das sein, was die SDKs direkt mit setCountry festlegen, aber beachten Sie, 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 standortbasiert auszurichten. |
| Geräte-ID | Gerätebezeichner, 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. |
| Betriebssystem und Betriebssystemversion | 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 innerhalb der Segmentierung verwendet werden, um Nutzer:innen zum Upgrade von App-Versionen anzusprechen. |
| Sitzungsstart und Sitzungsende | Wenn die Nutzer:innen beginnen, Ihre integrierte App oder Website zu verwenden | Das Braze SDK meldet Sitzungsdaten, die vom Braze-Dashboard zur Berechnung des Nutzer-Engagements und anderer Analytics verwendet werden, die für das Verständnis Ihrer Nutzer:innen wesentlich sind. Wann genau der Sitzungsstart und das Sitzungsende von Ihrer App oder Website aufgerufen wird, ist von Entwickler:innen konfigurierbar (Android, iOS, Web). |
| SDK-Nachrichteninteraktionsdaten | Push-Direktöffnungen, In-App-Nachricht-Interaktionen, Content-Card-Interaktionen | Dieses Attribut wird zur Qualitätskontrolle verwendet, z. B. um zu prüfen, ob eine Nachricht empfangen wurde und ob der Versand nicht dupliziert wird. |
| 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 Sitzungszeitstempel | Sitzungsbezeichner, ein zufällig generierter String und Sitzungszeitstempel | Wird verwendet, um festzustellen, ob Nutzer:innen eine neue oder bestehende Sitzung starten, und um die erneute Berechtigung für Nachrichten zu bestimmen, die für diese Nutzer:innen bestimmt sind. Bestimmte Messaging-Kanäle wie In-App-Nachrichten und Content Cards werden bei Sitzungsstart mit dem Gerät synchronisiert. Unser Backend verwendet dann Daten darüber, wann es zuletzt die Braze-Server kontaktiert hat (die das Gerät speichert und zurücksendet), um festzustellen, ob die Nutzer:innen für neue Nachrichten berechtigt sind. |
Berechnete Metriken
Braze generiert berechnete Metriken aus drei Eingaben: SDK-erfasste Daten (zum Beispiel Sitzungsstart und Sitzungsende), Nachrichteninteraktionsdaten für Nicht-SDK-Kanäle und von Braze abgeleitete Berichtsfelder. Diese Werte werden von Braze-Diensten generiert, sodass ein Nutzerprofil sowohl SDK-erfasste als auch von Braze generierte Daten enthalten kann.
Berechnete Metriken umfassen kanalbasierte Metriken (aufgeführt im Glossar der Berichtsmetriken) und die folgenden Attribute.
| Attribut | Beschreibung |
|---|---|
| App erstmals verwendet | Zeitpunkt |
| App zuletzt verwendet | Zeitpunkt |
| Gesamtanzahl der Sitzungen | Anzahl |
| Karte angeklickt | Anzahl |
| Zuletzt eine Nachricht erhalten | Zeitpunkt |
| Zuletzt E-Mail-Campaign erhalten | Zeitpunkt |
| Zuletzt Push-Campaign erhalten | Zeitpunkt |
| Anzahl der Feedback-Elemente | Anzahl |
| Anzahl der Sitzungen in den letzten Y Tagen | Anzahl und Zeitpunkt |
| Nachricht von Campaign erhalten | Boolean. Dieser Filter richtet sich an Nutzer:innen basierend darauf, ob sie eine vorherige Campaign erhalten haben. |
| Nachricht von Campaign mit Tag erhalten | Boolean. Dieser Filter richtet sich an Nutzer:innen basierend darauf, ob sie eine Campaign erhalten haben, die derzeit einen Tag hat. |
| Retarget-Campaign | Boolean. Dieser Filter richtet sich an Nutzer:innen basierend darauf, ob sie in der Vergangenheit eine bestimmte E-Mail, Push-Benachrichtigung oder In-App-Nachricht geöffnet oder angeklickt haben. |
| Deinstalliert | Boolean und Zeitpunkt |
Mindestintegration bedeutet, dass Sie nur die unter Mindestintegration aufgeführten erforderlichen Daten erfassen und die standardmäßig erfassten optionalen Daten durch Blockierung der optionalen SDK-Datenerfassung deaktivieren.
Wenn Sie eine Mindestintegration wünschen und mParticle, Segment, Tealium oder GTM verwenden, beachten Sie Folgendes:
- Mobile Plattformen: Sie müssen den Code für diese Konfigurationen manuell aktualisieren. mParticle und Segment bieten keine Möglichkeit, dies über ihre Plattform zu tun.
- Web: Die Braze-Integration muss nativ erfolgen, um die Konfiguration der Mindestintegration zu ermöglichen. Tag-Manager bieten keine Möglichkeit, dies über ihre Plattform zu tun.
Optionale Daten, die standardmäßig erfasst werden
Zusätzlich zu den Mindestintegrationsdaten werden die folgenden Attribute automatisch von Braze erfasst, wenn Sie die SDK-Integration initialisieren. Sie können die Erfassung dieser Attribute deaktivieren, um eine Mindestintegration zu ermöglichen.
| Attribut | Plattform | Beschreibung | Warum es erfasst wird |
|---|---|---|---|
| Browsername | Web | Name des Browsers | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Browser zu senden. Es kann auch für browserbasierte Segmentierung verwendet werden. |
| Geräte-Locale | Android, iOS, Web | Die Standard-Locale des Geräts | Dieses Attribut wird verwendet, um Nachrichten in die bevorzugte Sprache der Nutzer:innen zu übersetzen. |
| Letzte Geräte-Locale | Android, iOS, Web | Die zuletzt eingestellte Standard-Locale 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 für die Segmentierung verwendet werden. |
| Gerätemarke | Android | Die Marke des Geräts (zum Beispiel Samsung) | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. |
| Mobilfunkanbieter des Geräts | Android, iOS | Der Mobilfunkanbieter | Dieses Attribut wird optional für das Nachrichten-Targeting verwendet. Hinweis: Dieses Feld ist seit iOS 16 veraltet und wird in einer zukünftigen iOS-Version standardmäßig -- zurückgeben. |
| Sprache | Android, iOS, Web | Geräte- oder Browsersprache, abgeleitet von der Geräte-Locale. | Dieses Attribut wird verwendet, um Nachrichten in die bevorzugte Sprache der Nutzer:innen zu übersetzen. Es basiert auf der Geräte-Locale. |
| Benachrichtigungseinstellungen | Android, iOS, Web | Ob diese App Push-Benachrichtigungen aktiviert hat. | Dieses Attribut wird verwendet, um Push-Benachrichtigungen zu aktivieren. |
| Auflösung | Android, iOS, Web | Geräte- oder Browserauflösung | Wird optional für gerätebasiertes Nachrichten-Targeting verwendet. Das Format dieses Werts ist „<width>x<height>“. |
| Zeitzone | Android, iOS, Web | Geräte- oder Browserzeitzone | Dieses Attribut wird verwendet, um Nachrichten zur passenden Zeit gemäß der Ortszeit der jeweiligen Nutzer:innen zu senden. |
| User-Agent | Web | User-Agent | Dieses Attribut wird verwendet, um Nachrichten nur an kompatible Geräte zu senden. Es kann auch für die Segmentierung verwendet werden. |
Um mehr über das Tracking von Eigenschaften auf Geräteebene (wie Mobilfunkanbieter, Zeitzone, Auflösung und andere) zu erfahren, lesen Sie die plattformspezifische Dokumentation: 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 |
|---|---|---|---|
| Device Ad Tracking Enabled | Android, iOS | Auf iOS:set(adTrackingEnabled:)Auf Android: Braze.setGoogleAdvertisingId() |
Diese Eigenschaft erfordert zusätzliche Berechtigungen auf App-Ebene, die von der integrierenden Person erteilt werden müssen. |
| Device IDFA | iOS | Gerätebezeichner für Werbetreibende (Identifier for Advertisers, IDFA) | Dies erfordert das Ad Tracking Transparency Framework, das eine zusätzliche Datenschutzprüfung durch den App Store auslöst. Weitere Informationen finden Sie unter set(identifierForAdvertiser:) |
| Google Advertising ID | Android | Bezeichner für Werbung innerhalb von Google Play Apps | Dies erfordert, dass die App die GAID abruft und an Braze übergibt. Weitere Informationen finden Sie unter Optionale Google Advertising ID. |
| Letzter bekannter Standort | Android, iOS | Dies ist der zuletzt bekannte GPS-Standort des Geräts der Nutzer:innen. Dieser wird bei Sitzungsbeginn aktualisiert und im Nutzerprofil gespeichert. | Dies erfordert, dass die 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 Braze SDKs und protokollieren angepasste Attribute, angepasste Events und Kauf-Events, die für ihr Geschäft relevant sind – zusätzlich zu den automatisch erfassten Daten.
Eine personalisierte Integration ermöglicht eine maßgeschneiderte Kommunikation, die für die Erfahrung Ihrer Nutzer:innen relevant ist.
Braze sperrt oder blockiert Nutzer:innen mit über 5.000.000 Sitzungen („Dummy-Nutzer:innen“) und nimmt deren SDK-Events nicht mehr auf. Weitere Informationen finden Sie unter Spam-Blocking.