Gestion de la collecte de données

Le manifeste de confidentialité d’Apple

Qu’est-ce que les données de suivi ?

Apple définit les « données de suivi » comme des données collectées dans votre application à propos d’un utilisateur final ou d’un appareil, liées à des données third-party (telles que la publicité ciblée) ou à un courtier en données. Pour une définition complète avec des exemples, consultez Apple : Suivi.

Par défaut, le SDK Braze ne collecte pas de données de suivi. Cependant, selon la configuration de votre SDK Braze, vous pourriez être amené à répertorier les données spécifiques à Braze dans le manifeste de confidentialité de votre application.

Qu’est-ce qu’un manifeste de confidentialité ?

Un manifeste de confidentialité est un fichier dans votre projet Xcode qui décrit les raisons pour lesquelles votre application et les SDK tiers collectent des données, ainsi que leurs méthodes de collecte. Chacun de vos SDK tiers qui effectue un suivi des données nécessite son propre manifeste de confidentialité. Lorsque vous créez le rapport de confidentialité de votre application, ces fichiers de manifeste de confidentialité sont automatiquement agrégés en un seul rapport.

Domaines de données de suivi d’API

À partir d’iOS 17.2, Apple bloquera tous les endpoints de suivi déclarés dans votre application jusqu’à ce que l’utilisateur final accepte une invite de transparence du suivi publicitaire (ATT). Braze fournit des endpoints de suivi pour acheminer vos données de suivi, tout en vous permettant d’acheminer les données first-party non liées au suivi vers l’endpoint d’origine.

Déclaration des données de suivi Braze

Conditions préalables

La version suivante du SDK Braze est requise pour implémenter cette fonctionnalité :

Étape 1 : Examinez vos politiques actuelles

Examinez les politiques actuelles de collecte de données de votre SDK Braze avec votre équipe juridique pour déterminer si votre application collecte des données de suivi telles que définies par Apple. Si vous ne collectez aucune donnée de suivi, vous n’avez pas besoin de personnaliser votre manifeste de confidentialité pour le SDK Braze pour le moment. Pour plus d’informations sur les politiques de collecte de données du SDK Braze, consultez Collecte de données SDK.

Étape 2 : Créez un manifeste de confidentialité

Commencez par vérifier si vous disposez déjà d’un manifeste de confidentialité en recherchant un fichier PrivacyInfo.xcprivacy dans votre projet Xcode. Si ce fichier existe déjà, vous pouvez passer à l’étape suivante. Sinon, consultez Apple : Créer un manifeste de confidentialité.

Étape 3 : Ajoutez votre endpoint au manifeste de confidentialité

Dans votre projet Xcode, ouvrez le fichier PrivacyInfo.xcprivacy de votre application, puis faites un clic droit sur le tableau et cochez Raw Keys and Values.

Sous App Privacy Configuration, choisissez NSPrivacyTracking et définissez sa valeur sur YES.

Sous App Privacy Configuration, choisissez NSPrivacyTrackingDomains. Dans le tableau des domaines, ajoutez un nouvel élément et définissez sa valeur sur l’endpoint que vous avez précédemment ajouté à votre AppDelegate préfixé par sdk-tracking.

Étape 4 : Déclarez vos données de suivi

Ensuite, ouvrez AppDelegate.swift puis listez chaque propriété de suivi que vous souhaitez déclarer en créant une liste de suivi statique ou dynamique. Gardez à l’esprit qu’Apple bloquera ces propriétés jusqu’à ce que l’utilisateur final accepte l’invite ATT. Ne listez donc que les propriétés que vous et votre équipe juridique considérez comme relevant du suivi. Par exemple :

• static example
• dynamic example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import UIKit
import BrazeKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

  static var braze: Braze? = nil

  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    let configuration = Braze.Configuration(apiKey: brazeApiKey, endpoint: brazeEndpoint)
    // Declare which types of data you wish to collect for user tracking.
    configuration.api.trackingPropertyAllowList = [
      .dateOfBirth,
      .customEvent(["event-1"]),
      .customAttribute(["attribute-1", "attribute-2"])
    ]
    let braze = Braze(configuration: configuration)
    AppDelegate.braze = braze
    return true
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
func applicationDidBecomeActive(_ application: UIApplication) {
  // Request and check your user's tracking authorization status.
  ATTrackingManager.requestTrackingAuthorization { status in
    // Let Braze know whether user data is allowed to be collected for tracking.
    let enableAdTracking = status == .authorized
    AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)

    // Add the `.firstName` and `.lastName` properties, while removing the `.everything` configuration.
    AppDelegate.braze.updateTrackingAllowList(
      adding: [.firstName, .lastName],
      removing: [.everything]
    )
  }
}

Étape 5 : Empêchez les boucles de réessai infinies

Pour empêcher le SDK d’entrer dans une boucle de réessai infinie, utilisez la méthode set(adTrackingEnabled: enableAdTracking) pour gérer les autorisations ATT. La propriété adTrackingEnabled dans votre méthode doit être gérée de manière similaire à ce qui suit :

1
2
3
4
5
6
7
8
func applicationDidBecomeActive(_ application: UIApplication) {
    // Request and check your user's tracking authorization status.
    ATTrackingManager.requestTrackingAuthorization { status in
      // Let Braze know whether user data is allowed to be collected for tracking.
      let enableAdTracking = status == .authorized
      AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)
    }
}

Désactivation du suivi des données

Pour désactiver le suivi des données sur le SDK Swift, définissez la propriété enabled sur false sur votre instance Braze. Lorsque enabled est défini sur false, le SDK Braze ignore tous les appels à l’API publique. Le SDK annule également toutes les actions en cours, telles que les requêtes réseau, le traitement des événements, etc.

Effacement des données précédemment stockées

Vous pouvez utiliser la méthode wipeData() pour effacer complètement les données SDK stockées localement sur l’appareil d’un utilisateur.

À partir de la version 7.0.0 de Braze Swift, le SDK et la méthode wipeData() génèrent aléatoirement un UUID comme identifiant d’appareil. Cependant, si votre useUUIDAsDeviceId est défini sur false ou si vous utilisez la version 5.7.0 ou antérieure du SDK Swift, vous devrez également effectuer une requête POST vers /users/delete car votre IDFV (Identifier for Vendors) sera automatiquement utilisé comme identifiant d’appareil de cet utilisateur.

Si vous utilisez l’intégration manuelle des notifications push et que votre application appelle wipeData() puis réactive le SDK au cours de la même session, appelez à nouveau registerForRemoteNotifications() pour que Braze puisse recevoir un jeton d’appareil actualisé. Pour plus d’informations, consultez Configuration des notifications push.

Reprise du suivi des données

Pour reprendre la collecte de données, définissez enabled sur true. Gardez à l’esprit que cela ne restaurera pas les données précédemment effacées.

Collecte de l’IDFV

Dans les versions antérieures du SDK iOS de Braze, le champ IDFV (Identifier for Vendor) était automatiquement collecté comme identifiant d’appareil de l’utilisateur. À partir du SDK Swift v5.7.0, le champ IDFV pouvait être désactivé de manière facultative, et Braze définissait à la place un UUID aléatoire comme identifiant d’appareil. À partir du SDK Swift v7.0.0, le champ IDFV n’est plus collecté par défaut, et un UUID est défini comme identifiant d’appareil à la place.

La fonctionnalité useUUIDAsDeviceId configure le SDK Swift pour définir l’identifiant d’appareil comme UUID. Traditionnellement, le SDK iOS attribuait un identifiant d’appareil égal à la valeur IDFV générée par Apple. Avec cette fonctionnalité activée par défaut sur votre application iOS, tous les nouveaux utilisateurs créés via le SDK se voient attribuer un identifiant d’appareil égal à un UUID.

Si vous souhaitez toujours collecter l’IDFV séparément, vous pouvez utiliser set(identifierforvendor:).

Considérations

Version du SDK

Dans le SDK Swift v7.0.0+, lorsque useUUIDAsDeviceId est activé (par défaut), tous les nouveaux utilisateurs créés se voient attribuer un identifiant d’appareil aléatoire. Tous les utilisateurs existants conservent leur valeur d’identifiant d’appareil actuelle, qui peut avoir été un IDFV.

Lorsque cette fonctionnalité n’est pas activée, les appareils continuent de se voir attribuer l’IDFV lors de leur création.

En aval

Partenaires technologiques : lorsque cette fonctionnalité est activée, les partenaires technologiques qui dérivent la valeur IDFV de l’identifiant d’appareil Braze n’auront plus accès à cette donnée. Si la valeur IDFV dérivée de l’appareil est nécessaire pour l’intégration de votre partenaire, nous vous recommandons de définir cette fonctionnalité sur false.

Currents : lorsque useUUIDAsDeviceId est défini sur true, l’identifiant d’appareil envoyé dans Currents ne correspondra plus à la valeur IDFV.

Foire aux questions

Ce changement aura-t-il un impact sur mes utilisateurs existants dans Braze ?

Non. Lorsqu’elle est activée, cette fonctionnalité n’écrase aucune donnée utilisateur dans Braze. Les nouveaux identifiants d’appareil UUID ne seront créés que pour les nouveaux appareils ou lorsque wipedata() est appelé.

Puis-je désactiver cette fonctionnalité après l’avoir activée ?

Oui, cette fonctionnalité peut être activée et désactivée à votre discrétion. Les identifiants d’appareil précédemment stockés ne seront jamais écrasés.

Puis-je toujours collecter la valeur IDFV via Braze par un autre moyen ?

Oui, vous pouvez toujours collecter l’IDFV de manière facultative via le SDK Swift (la collecte est désactivée par défaut).