Skip to content

Speicher

Erfahren Sie mehr über die verschiedenen Eigenschaften auf Geräteebene, die vom Braze SDK gespeichert werden.

Geräteeigenschaften

Standardmäßig erfasst Braze die folgenden Eigenschaften auf Geräteebene, um die Personalisierung von Nachrichten auf der Grundlage von Gerät, Sprache und Zeitzone zu ermöglichen:

  • BROWSER
  • BROWSER_VERSION
  • LANGUAGE
  • OS
  • RESOLUTION
  • TIME_ZONE
  • USER_AGENT
  • AD_TRACKING_ENABLED
  • ANDROID_VERSION
  • CARRIER
  • IS_BACKGROUND_RESTRICTED
  • LOCALE
  • MODEL
  • NOTIFICATION_ENABLED
  • RESOLUTION
  • TIMEZONE
  • Netzbetreiber des Geräts (siehe Hinweis zur CTCarrier-Deprecation)
  • Gebietsschema des Geräts
  • Gerätemodell
  • Betriebssystemversion des Geräts
  • Push-Autorisierungsstatus
  • Push-Anzeigeoptionen
  • Push aktiviert
  • Geräteauflösung
  • Zeitzone des Geräts

Standardmäßig sind alle Eigenschaften aktiviert. Sie können sie jedoch auch manuell aktivieren oder deaktivieren. Beachten Sie, dass einige Features des Braze SDK bestimmte Eigenschaften erfordern (z. B. Zustellung zur Ortszeit und Zeitzone). Testen Sie daher unbedingt Ihre Konfiguration, bevor Sie sie in die Produktion überführen.

Sie können zum Beispiel die Sprache des Geräts angeben, die auf die Allowlist gesetzt werden soll. Weitere Informationen finden Sie unter der Option devicePropertyAllowlist für InitializationOptions.

1
2
3
4
5

import * as braze from"@braze/web-sdk";
braze.initialize("API-KEY", {
    baseUrl: "BASE-URL",
    devicePropertyAllowlist: [ braze.DeviceProperties.LANGUAGE ] // list of `DeviceProperties` you want to collect
});

Sie können zum Beispiel die Android-Betriebssystemversion und das Gebietsschema des Geräts angeben, die auf die Allowlist gesetzt werden sollen. Weitere Informationen finden Sie in den Methoden setDeviceObjectAllowlistEnabled() und setDeviceObjectAllowlist().

1
2
3

new BrazeConfig.Builder()
    .setDeviceObjectAllowlistEnabled(true)
    .setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));

Sie können zum Beispiel die Erfassung von Zeitzone und Gebietsschema angeben, die zugelassen werden sollen. Weitere Informationen finden Sie unter der Eigenschaft devicePropertyAllowList des configuration-Objekts.

1

configuration.devicePropertyAllowList = [.timeZone, .locale]

1
2
3
4

configuration.devicePropertyAllowList = @[
    BRZDeviceProperty.timeZone,
    BRZDeviceProperty.locale
];

Speichern von Cookies (nur Internet)

Nach der Initialisierung des Internet Braze SDK werden Cookies mit einer Gültigkeitsdauer von 400 Tagen erstellt und gespeichert, die bei neuen Sitzungen automatisch erneuert werden.

Die folgenden Cookies werden gespeichert:

Cookie Beschreibung Größe
ab.storage.userId.[your-api-key] Wird verwendet, um festzustellen, ob sich die aktuell angemeldete Nutzer:in geändert hat, und um Ereignisse mit der aktuellen Nutzer:in zu verknüpfen. Basierend auf der Größe des Werts, der an changeUser übergeben wird
ab.storage.sessionId.[your-api-key] Zufällig generierter String, der verwendet wird, um festzustellen, ob die Nutzer:in eine neue oder bestehende Sitzung startet, um Nachrichten zu synchronisieren und Sitzungs-Analytics zu berechnen. ~200 Bytes
ab.storage.deviceId.[your-api-key] Zufällig generierter String zur Identifizierung anonymer Nutzer:innen und zur Unterscheidung der Geräte der Nutzer:innen, der gerätebasiertes Messaging ermöglicht. ~200 Bytes
ab.optOut Wird verwendet, um die Opt-out-Präferenz einer Nutzer:in zu speichern, wenn disableSDK aufgerufen wird. ~40 Bytes
ab._gd Wird vorübergehend erstellt (und dann gelöscht), um die Root-Level-Cookie-Domain zu bestimmen, damit das SDK über Sub-Domains hinweg korrekt funktioniert. k. A.

Standardmäßig laufen Braze-Cookies nach 400 Tagen ab. Um dies zu überschreiben, verwenden Sie die Option cookieExpiryInDays bei der Initialisierung des Internet SDK. Die Werte müssen größer als 0 sein. Wird die Option weggelassen oder auf 0 oder weniger gesetzt, gilt der Standard von 400 Tagen. Diese Option erfordert Internet SDK 6.6.0 oder höher.

1
2
3
4
5

import * as braze from "@braze/web-sdk";
braze.initialize("API-KEY", {
  baseUrl: "BASE-URL",
  cookieExpiryInDays: 30 // expires after 30 days
});

Cookies deaktivieren

Um alle Cookies zu deaktivieren, verwenden Sie die Option noCookies bei der Initialisierung des Internet SDK. Damit verhindern Sie, dass anonyme Nutzer:innen, die über Sub-Domains hinweg navigieren, miteinander verknüpft werden. Dies führt dazu, dass auf jeder Sub-Domain eine neue Nutzer:in angelegt wird.

1
2
3
4
5

import * as braze from "@braze/web-sdk";
braze.initialize("API-KEY", {
  baseUrl: "BASE-URL",
  noCookies: true
});

Um das Braze-Tracking generell zu beenden oder alle gespeicherten Browserdaten zu löschen, verwenden Sie die SDK-Methoden disableSDK bzw. wipeData. Diese beiden Methoden können nützlich sein, wenn eine Nutzer:in ihre Zustimmung widerruft oder Sie alle Braze-Funktionen beenden möchten, nachdem das SDK bereits initialisiert wurde.
New Stuff!