Stockage
Découvrez les différentes propriétés au niveau de l’appareil qui sont stockées par le SDK de 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 :
BROWSERBROWSER_VERSIONLANGUAGEOSRESOLUTIONTIME_ZONEUSER_AGENT
AD_TRACKING_ENABLEDANDROID_VERSIONCARRIERIS_BACKGROUND_RESTRICTEDLOCALEMODELNOTIFICATION_ENABLEDRESOLUTIONTIMEZONE
Les propriétés AD_TRACKING_ENABLED et TIMEZONE ne sont pas collectées si elles sont null ou vides. La propriété GOOGLE_ADVERTISING_ID n’est pas collectée automatiquement par le SDK et doit être transmise via setGoogleAdvertisingId.
- 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 push
- Options d’affichage push
- Push activé
- Résolution de l’appareil
- Fuseau horaire de l’appareil
Le SDK de Braze ne recueille pas automatiquement l’IDFA. Les applications peuvent éventuellement transmettre l’IDFA à Braze en implémentant directement les méthodes ci-dessous. Les applications doivent obtenir l’abonnement explicite au suivi par l’utilisateur final via le framework App Tracking Transparency avant de transmettre l’IDFA à Braze.
- Pour définir l’état du suivi publicitaire, utilisez
set(adTrackingEnabled:). - Pour définir l’identifiant publicitaire (IDFA), utilisez
set(identifierForAdvertiser:).
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 de 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 à autoriser. 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
];
Pour en savoir plus sur les propriétés d’appareil collectées automatiquement, consultez la section Collecte de données du SDK.
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 |
Modifier l’expiration des cookies
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.
Modifier cette page sur GitHub