Collecte de données SDK
Lorsque vous intégrez le SDK de Braze à votre application ou à votre site, Braze collecte automatiquement certains types de données. Certaines de ces données sont essentielles à nos processus, tandis que d’autres peuvent être activées ou désactivées en fonction de vos besoins. Vous pouvez également configurer Braze pour collecter d’autres types de données afin d’enrichir votre segmentation et votre envoi de messages.
Braze est conçu pour offrir une collecte de données flexible. Vous pouvez intégrer le SDK de Braze de plusieurs manières :
- Intégration minimale : Braze collecte automatiquement les données nécessaires à la communication avec les services de Braze.
- Données facultatives collectées par défaut : Braze capture automatiquement certaines données utiles pour la plupart de vos cas d’usage. Vous pouvez désactiver la collecte automatique de ces données si elles ne sont pas indispensables à la communication avec les services de Braze.
- Données facultatives non collectées par défaut : Braze capture certaines données utiles pour des cas d’usage spécifiques, mais n’active pas automatiquement leur collecte pour des raisons de conformité générale. Vous pouvez choisir de collecter ces données lorsque cela correspond à vos besoins.
- Intégration personnalisée : Braze vous offre la possibilité de collecter des données supplémentaires en plus des données facultatives par défaut.
Intégration minimale
La liste suivante présente les données strictement nécessaires générées et reçues par Braze lorsque vous initialisez le SDK. Ces données ne sont pas configurables et sont essentielles au fonctionnement de base de la plateforme. À l’exception du début et de la fin de session, toutes les autres données suivies automatiquement ne sont pas comptabilisées dans votre consommation de points de donnée.
| Attribut | Description | Pourquoi cette donnée est collectée |
|---|---|---|
| App-Version-Name / App-Version-Code |
La version la plus récente de l’application | Cet attribut est utilisé pour envoyer des messages liés à la compatibilité de la version de l’application aux appareils appropriés. Il peut être utilisé pour informer les utilisateurs d’interruptions de service ou de bugs. |
| Pays | Pays identifié par la géolocalisation de l’adresse IP. Si la géolocalisation de l’adresse IP n’est pas disponible, le pays est identifié par les paramètres régionaux de l’appareil. La valeur peut également être celle définie directement par les SDK avec setCountry, mais notez que le passage d’une valeur d’attribut via le SDK ou l’API consomme des points de donnée. Une fois le pays défini manuellement (via la méthode du SDK, la REST API ou un import CSV), le SDK ne met plus à jour cette valeur automatiquement. |
Cet attribut est utilisé pour cibler les messages en fonction de la localisation. |
| ID de l’appareil | Identifiant de l’appareil, une chaîne de caractères générée aléatoirement | Cet attribut est utilisé pour différencier les appareils des utilisateurs et envoyer les messages au bon appareil. |
| Système d’exploitation et version du système d’exploitation | Le système d’exploitation ou le navigateur actuellement signalé, ainsi que la version de l’appareil ou du navigateur | Cet attribut est utilisé pour n’envoyer des messages qu’aux appareils compatibles. Il peut également être utilisé dans la segmentation pour cibler les utilisateurs afin qu’ils mettent à jour la version de leur application. |
| Début et fin de session | Lorsque l’utilisateur commence à utiliser votre application ou site intégré | Le SDK Braze transmet les données de session utilisées par le tableau de bord de Braze pour calculer l’engagement des utilisateurs et d’autres analyses essentielles à la compréhension de vos utilisateurs. Le moment exact où le début et la fin de session sont déclenchés par votre application ou site est configurable par un développeur (Android, iOS, Web). |
| Données d’interaction avec les messages du SDK | Ouvertures directes de notifications push, interactions avec les messages in-app, interactions avec les Content Cards | Cet attribut est utilisé à des fins de contrôle qualité, par exemple pour vérifier qu’un message a bien été reçu et que l’envoi n’est pas dupliqué. |
| Version du SDK | Version actuelle du SDK | Cet attribut est utilisé pour n’envoyer des messages qu’aux appareils compatibles et éviter les interruptions de service. |
| ID de session et horodatage de session | Identifiant de session, une chaîne de caractères générée aléatoirement, et horodatage de session | Utilisé pour déterminer si l’utilisateur démarre une nouvelle session ou reprend une session existante, et pour déterminer la rééligibilité aux messages destinés à cet utilisateur. Certains canaux de communication tels que les messages in-app et les Content Cards sont synchronisés avec l’appareil au début de la session. Le backend utilise ensuite les données relatives au dernier contact avec les serveurs Braze (que l’appareil stocke et renvoie) pour déterminer si l’utilisateur est éligible à de nouveaux messages. |
Indicateurs calculés
Braze génère des indicateurs calculés à partir de trois sources : les données suivies par le SDK (par exemple, le début et la fin de session), les données d’interaction avec les messages pour les canaux non-SDK et les champs de reporting dérivés par Braze. Ces valeurs sont générées par les services Braze, de sorte qu’un profil utilisateur peut contenir à la fois des données suivies par le SDK et des données générées par Braze.
Les indicateurs calculés comprennent des indicateurs par canal (répertoriés dans le Glossaire des indicateurs de rapport) ainsi que les attributs suivants.
| Attribut | Description |
|---|---|
| Première utilisation de l’application | Heure |
| Dernière utilisation de l’application | Heure |
| Nombre total de sessions | Nombre |
| Carte cliquée | Nombre |
| Dernier message reçu (tous types) | Heure |
| Dernière Campaign e-mail reçue | Heure |
| Dernière Campaign push reçue | Heure |
| Nombre d’éléments de feedback | Nombre |
| Nombre de sessions au cours des Y derniers jours | Nombre et heure |
| A reçu un message d’une Campaign | Booléen. Ce filtre cible les utilisateurs selon qu’ils ont reçu ou non une Campaign précédente. |
| A reçu un message d’une Campaign avec une étiquette | Booléen. Ce filtre cible les utilisateurs selon qu’ils ont reçu ou non une Campaign portant actuellement une étiquette. |
| Recibler une Campaign | Booléen. Ce filtre cible les utilisateurs selon qu’ils ont ouvert ou cliqué sur un e-mail, une notification push ou un message in-app spécifique dans le passé. |
| Désinstallé | Booléen et heure |
L’intégration minimale signifie que vous ne collectez que les données requises répertoriées dans Intégration minimale et que vous désactivez les données optionnelles collectées par défaut en bloquant la collecte de données optionnelles du SDK.
Si vous souhaitez une intégration minimale et que vous utilisez mParticle, Segment, Tealium ou GTM, notez les points suivants :
- Plateformes mobiles : vous devez mettre à jour manuellement le code pour ces configurations. mParticle et Segment ne proposent pas de moyen de le faire via leur plateforme.
- Web : l’intégration Braze doit être effectuée nativement pour permettre la configuration d’intégration minimale. Les gestionnaires d’étiquettes ne proposent pas de moyen de le faire via leur plateforme.
Données optionnelles collectées par défaut
En plus des données d’intégration minimales, les attributs suivants sont automatiquement capturés par Braze lorsque vous initialisez l’intégration SDK. Vous pouvez désactiver la collecte de ces attributs pour permettre une intégration minimale.
| Attribut | Plateforme | Description | Raison de la collecte |
|---|---|---|---|
| Nom du navigateur | Web | Nom du navigateur | Cet attribut est utilisé pour envoyer des messages uniquement aux navigateurs compatibles. Il peut également être utilisé pour la segmentation basée sur le navigateur. |
| Paramètres régionaux de l’appareil | Android, iOS, Web | Les paramètres régionaux par défaut de l’appareil | Cet attribut est utilisé pour traduire les messages dans la langue préférée de l’utilisateur. |
| Paramètres régionaux les plus récents de l’appareil | Android, iOS, Web | Les paramètres régionaux par défaut les plus récents de l’appareil | Cet attribut provient des paramètres de l’appareil de l’utilisateur et est utilisé pour traduire les messages dans la langue préférée de l’utilisateur. Il est indépendant de l’attribut Most Recent Location. |
| Modèle de l’appareil | Android, iOS | Le matériel spécifique de l’appareil | Cet attribut est utilisé pour envoyer des messages uniquement aux appareils compatibles. Il peut également être utilisé dans la segmentation. |
| Marque de l’appareil | Android | La marque de l’appareil (par exemple, Samsung) | Cet attribut est utilisé pour envoyer des messages uniquement aux appareils compatibles. |
| Opérateur mobile de l’appareil | Android, iOS | L’opérateur mobile | Cet attribut est utilisé de manière optionnelle pour le ciblage des messages. Remarque : Ce champ est obsolète depuis iOS 16 et sera défini par défaut sur -- dans une future version d’iOS. |
| Langue | Android, iOS, Web | Langue de l’appareil ou du navigateur, issue des paramètres régionaux de l’appareil. | Cet attribut est utilisé pour traduire les messages dans la langue préférée de l’utilisateur. Il est basé sur les paramètres régionaux de l’appareil. |
| Paramètres de notification | Android, iOS, Web | Indique si cette application a les notifications push activées. | Cet attribut est utilisé pour activer les notifications push. |
| Résolution | Android, iOS, Web | Résolution de l’appareil ou du navigateur | Utilisé de manière optionnelle pour le ciblage des messages basé sur l’appareil. Le format de cette valeur est « <width>x<height> ». |
| Fuseau horaire | Android, iOS, Web | Fuseau horaire de l’appareil ou du navigateur | Cet attribut est utilisé pour envoyer des messages au moment approprié, en fonction du fuseau horaire local de chaque utilisateur. |
| Agent utilisateur | Web | Agent utilisateur | Cet attribut est utilisé pour envoyer des messages uniquement aux appareils compatibles. Il peut également être utilisé dans la segmentation. |
Pour en savoir plus sur le suivi des propriétés au niveau de l’appareil (telles que l’opérateur mobile, le fuseau horaire, la résolution et autres), consultez la documentation spécifique à chaque plateforme : Android, iOS, Web.
Données non collectées par défaut
Par défaut, les attributs suivants ne sont pas collectés. Chaque attribut doit être intégré manuellement.
| Attribut | Plateforme | Description | Pourquoi il n’est pas collecté |
|---|---|---|---|
| Suivi publicitaire de l’appareil activé | Android, iOS | Sur iOS :set(adTrackingEnabled:)Sur Android : Braze.setGoogleAdvertisingId() |
Cette propriété nécessite des autorisations supplémentaires au niveau de l’application, qui doivent être accordées par l’intégrateur. |
| IDFA de l’appareil | iOS | Identifiant de l’appareil pour les annonceurs | Cela nécessite le framework Ad Tracking Transparency, qui déclenchera un examen de confidentialité supplémentaire de la part de l’App Store. Pour plus de détails, consultez set(identifierForAdvertiser:) |
| Google Advertising ID | Android | Identifiant publicitaire au sein des applications Google Play | Cela nécessite que l’application récupère le GAID et le transmette à Braze. Pour plus de détails, consultez Google Advertising ID optionnel. |
| Localisation la plus récente | Android, iOS | Il s’agit de la dernière position GPS connue de l’appareil de l’utilisateur. Elle est mise à jour au début de la session et stockée dans le profil de l’utilisateur. | Cela nécessite que l’utilisateur accorde l’autorisation de localisation à votre application. |
Le SDK Braze ne stocke aucune adresse IP localement.
Intégration personnalisée
Pour tirer le meilleur parti de Braze, nos intégrateurs SDK implémentent souvent les SDK Braze et enregistrent des attributs personnalisés, des événements personnalisés et des événements d’achat pertinents pour leur activité, en complément des données collectées automatiquement.
Une intégration personnalisée permet une communication sur mesure, adaptée à l’expérience de vos utilisateurs.
Braze bannira ou bloquera les utilisateurs ayant plus de 5 000 000 de sessions (« utilisateurs fictifs ») et n’ingérera plus leurs événements SDK. Pour en savoir plus, consultez la section Blocage du spam.