Skip to content

Stockage

Découvrez les différentes propriétés au niveau de l’appareil qui sont stockées par le SDK Braze.

Propriétés de l’appareil

Par défaut, Braze collecte les propriétés suivantes au niveau de l’appareil pour permettre la personnalisation des messages en fonction de l’appareil, de la langue et du fuseau horaire :

  • 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
  • Opérateur mobile (voir la note sur l’obsolescence de CTCarrier)
  • Paramètres régionaux de l’appareil
  • Modèle de l’appareil
  • Version du système d’exploitation de l’appareil
  • État de l’autorisation des notifications push
  • Options d’affichage push
  • Push activé
  • Résolution de l’appareil
  • Fuseau horaire de l’appareil

Par défaut, toutes les propriétés sont activées. Vous pouvez toutefois choisir de les activer ou de les désactiver manuellement. Gardez à l’esprit que certaines fonctionnalités du SDK Braze nécessitent des propriétés spécifiques (comme la distribution selon le fuseau horaire local), alors pensez à bien tester votre configuration avant de la mettre en production.

Par exemple, vous pouvez spécifier la langue de l’appareil à inscrire sur la liste d’autorisation. Pour plus d’informations, reportez-vous à l’option devicePropertyAllowlist pour 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
});

Par exemple, vous pouvez spécifier la version du système d’exploitation Android et les paramètres régionaux de l’appareil à inscrire sur la liste d’autorisation. Pour plus d’informations, consultez les méthodes setDeviceObjectAllowlistEnabled() et setDeviceObjectAllowlist().

1
2
3

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

Par exemple, vous pouvez spécifier le fuseau horaire et les paramètres régionaux à inscrire sur la liste d’autorisation. Pour plus d’informations, consultez la propriété devicePropertyAllowList de l’objet configuration.

1

configuration.devicePropertyAllowList = [.timeZone, .locale]

1
2
3
4

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

Stockage des cookies (web uniquement)

Après avoir initialisé le SDK Web de Braze, celui-ci crée et stocke des cookies avec une expiration de 400 jours, automatiquement renouvelée à chaque nouvelle session.

Les cookies suivants sont stockés :

Cookie Description Taille
ab.storage.userId.[your-api-key] Permet de déterminer si l’utilisateur actuellement connecté a changé et d’associer les événements à l’utilisateur actuel. Dépend de la taille de la valeur transmise à changeUser
ab.storage.sessionId.[your-api-key] Chaîne de caractères générée aléatoirement, utilisée pour déterminer si l’utilisateur démarre une nouvelle session ou poursuit une session existante, afin de synchroniser les messages et de calculer l’analytique de session. ~200 octets
ab.storage.deviceId.[your-api-key] Chaîne de caractères générée aléatoirement, utilisée pour identifier les utilisateurs anonymes et différencier les appareils des utilisateurs, permettant ainsi l’envoi de messages par appareil. ~200 octets
ab.optOut Stocke la préférence de refus de l’utilisateur lorsque disableSDK est appelé. ~40 octets
ab._gd Créé temporairement (puis supprimé) pour déterminer le domaine de cookie racine, ce qui permet au SDK de fonctionner correctement sur les sous-domaines. s/o

Par défaut, les cookies de Braze expirent après 400 jours. Pour modifier cette durée, utilisez l’option cookieExpiryInDays lors de l’initialisation du SDK Web. La valeur doit être supérieure à 0 ; si l’option est omise ou définie à 0 ou moins, la valeur par défaut de 400 jours s’applique. Cette option nécessite le SDK Web 6.6.0 ou une version ultérieure.

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
});

Désactiver les cookies

Pour désactiver tous les cookies, utilisez l’option noCookies lors de l’initialisation du SDK Web. Cela vous empêchera d’associer les utilisateurs anonymes qui naviguent entre les sous-domaines et entraînera la création d’un nouvel utilisateur sur chaque sous-domaine.

1
2
3
4
5

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

Pour arrêter le suivi de Braze de manière générale ou pour effacer toutes les données stockées dans le navigateur, consultez respectivement les méthodes disableSDK et wipeData du SDK. Ces deux méthodes peuvent s’avérer utiles si un utilisateur révoque son consentement ou si vous souhaitez désactiver toutes les fonctionnalités de Braze après l’initialisation du SDK.
New Stuff!