Datenerfassung verwalten

Apples Manifest zum Datenschutz

Was sind Tracking-Daten?

Apple definiert „Tracking-Daten“ als Daten, die in Ihrer App über eine:n Endnutzer:in oder ein Gerät gesammelt werden und die mit Drittanbieter-Daten (z. B. gezielte Werbung) oder einem Datenbroker verknüpft sind. Eine vollständige Definition mit Beispielen finden Sie unter Apple: Tracking.

Standardmäßig sammelt das Braze SDK keine Tracking-Daten. Je nach Konfiguration Ihres Braze SDK müssen Sie jedoch möglicherweise Braze-spezifische Daten im Datenschutzmanifest Ihrer App aufführen.

Was ist ein Datenschutzmanifest?

Ein Datenschutzmanifest ist eine Datei in Ihrem Xcode-Projekt, die den Grund für die Datenerfassung durch Ihre App und SDKs von Drittanbietern sowie deren Datenerfassungsmethoden beschreibt. Jedes Ihrer externen SDKs, das Daten trackt, benötigt ein eigenes Datenschutzmanifest. Wenn Sie den Datenschutzbericht Ihrer App erstellen, werden diese Datenschutzmanifestdateien automatisch in einem einzigen Bericht zusammengefasst.

API-Tracking-Daten-Domains

Ab iOS 17.2 blockiert Apple alle deklarierten Tracking-Endpunkte in Ihrer App, bis die:der Endnutzer:in eine Aufforderung zur Ad-Tracking-Transparenz (ATT) akzeptiert. Braze stellt Tracking-Endpunkte bereit, über die Sie Ihre Tracking-Daten weiterleiten können, während Sie First-Party-Daten, die nicht zum Tracking gehören, weiterhin an den ursprünglichen Endpunkt senden können.

Deklarieren der Tracking-Daten von Braze

Tipp

Eine vollständige Anleitung finden Sie im Tutorial zum Datenschutz-Tracking.

Voraussetzungen

Die folgende Braze-SDK-Version ist erforderlich, um dieses Feature zu implementieren:

1. Schritt: Überprüfen Sie Ihre aktuellen Richtlinien

Lassen Sie die aktuellen Datenerfassungsrichtlinien Ihres Braze SDK von Ihrer Rechtsabteilung prüfen, um festzustellen, ob Ihre App Tracking-Daten gemäß der Definition von Apple erfasst. Wenn Sie keine Tracking-Daten sammeln, müssen Sie Ihr Datenschutzmanifest für das Braze SDK zu diesem Zeitpunkt nicht anpassen. Weitere Informationen zu den Datenerfassungsrichtlinien des Braze SDK finden Sie unter Datenerfassung im SDK.

Wichtig

Wenn eines Ihrer SDKs, das nicht von Braze stammt, Tracking-Daten sammelt, müssen Sie diese Richtlinien separat prüfen.

2. Schritt: Erstellen Sie ein Datenschutzmanifest

Prüfen Sie zunächst, ob Sie bereits ein Datenschutzmanifest haben, indem Sie in Ihrem Xcode-Projekt nach einer PrivacyInfo.xcprivacy-Datei suchen. Wenn Sie diese Datei bereits haben, können Sie mit dem nächsten Schritt fortfahren. Andernfalls siehe Apple: Datenschutzmanifest erstellen.

3. Schritt: Fügen Sie Ihren Endpunkt zum Datenschutzmanifest hinzu

Öffnen Sie in Ihrem Xcode-Projekt die Datei PrivacyInfo.xcprivacy Ihrer App, rechtsklicken Sie dann auf die Tabelle und aktivieren Sie Raw Keys and Values.

Wählen Sie unter App Privacy Configuration den Eintrag NSPrivacyTracking und setzen Sie den Wert auf YES.

Wählen Sie unter App Privacy Configuration den Eintrag NSPrivacyTrackingDomains. Fügen Sie im Domains-Array ein neues Element hinzu und setzen Sie dessen Wert auf den Endpunkt, den Sie zuvor zu Ihrem AppDelegate hinzugefügt haben, mit dem Präfix sdk-tracking.

4. Schritt: Deklarieren Sie Ihre Tracking-Daten

Öffnen Sie als Nächstes AppDelegate.swift und listen Sie alle Tracking-Eigenschaften auf, die Sie deklarieren möchten, indem Sie eine statische oder dynamische Tracking-Liste erstellen. Beachten Sie, dass Apple diese Eigenschaften blockiert, bis die:der Endnutzer:in die ATT-Aufforderung akzeptiert. Listen Sie daher nur die Eigenschaften auf, die Sie und Ihre Rechtsabteilung als Tracking betrachten. Zum Beispiel:

• 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]
    )
  }
}

5. Schritt: Verhindern Sie unendliche Wiederholungsschleifen

Um zu verhindern, dass das SDK in eine unendliche Wiederholungsschleife gerät, verwenden Sie die Methode set(adTrackingEnabled: enableAdTracking) zur Behandlung von ATT-Berechtigungen. Die Eigenschaft adTrackingEnabled in Ihrer Methode sollte ähnlich wie folgt behandelt werden:

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

Deaktivieren des Daten-Trackings

Um die Daten-Tracking-Aktivität im Swift SDK zu deaktivieren, setzen Sie die Eigenschaft enabled in Ihrer Braze-Instanz auf false. Wenn enabled auf false gesetzt ist, ignoriert das Braze SDK alle Aufrufe an die öffentliche API. Das SDK bricht außerdem alle laufenden Aktionen ab, z. B. Netzwerkanfragen, Eventverarbeitung usw.

Löschen zuvor gespeicherter Daten

Sie können die Methode wipeData() verwenden, um lokal gespeicherte SDK-Daten auf dem Gerät einer:eines Nutzer:in vollständig zu löschen.

Ab Braze Swift Version 7.0.0 generieren das SDK und die Methode wipeData() eine zufällige UUID als Geräte-ID. Wenn Ihr useUUIDAsDeviceId jedoch auf false gesetzt ist oder Sie Swift SDK Version 5.7.0 oder früher verwenden, müssen Sie zusätzlich eine POST-Anfrage an /users/delete senden, da Ihr Identifier for Vendors (IDFV) automatisch als Geräte-ID der:des Nutzer:in verwendet wird.

Wenn Sie die manuelle Push-Integration verwenden und Ihre App wipeData() aufruft und das SDK später im selben App-Lauf wieder aktiviert, rufen Sie erneut registerForRemoteNotifications() auf, damit Braze ein aktualisiertes Geräte-Token erhalten kann. Weitere Informationen finden Sie unter Push-Benachrichtigungen einrichten.

Wiederaufnahme des Daten-Trackings

Um die Datenerfassung wieder aufzunehmen, setzen Sie enabled auf true. Beachten Sie, dass dadurch keine zuvor gelöschten Daten wiederhergestellt werden.

IDFV-Erfassung

In früheren Versionen des Braze iOS SDK wurde das IDFV-Feld (Identifier for Vendors) automatisch als Geräte-ID der:des Nutzer:in erfasst. Ab Swift SDK v5.7.0 konnte das IDFV-Feld optional deaktiviert werden, und Braze setzte stattdessen eine zufällige UUID als Geräte-ID. Ab Swift SDK v7.0.0 wird das IDFV-Feld standardmäßig nicht mehr erfasst, und stattdessen wird eine UUID als Geräte-ID festgelegt.

Das Feature useUUIDAsDeviceId konfiguriert das Swift SDK so, dass die Geräte-ID als UUID gesetzt wird. Traditionell wies das iOS SDK den von Apple generierten IDFV-Wert als Geräte-ID zu. Wenn dieses Feature in Ihrer iOS-App standardmäßig aktiviert ist, wird allen neuen Nutzer:innen, die über das SDK erstellt werden, eine Geräte-ID zugewiesen, die einer UUID entspricht.

Wenn Sie den IDFV dennoch separat erfassen möchten, können Sie set(identifierforvendor:) verwenden.

Überlegungen

SDK-Version

Wenn useUUIDAsDeviceId im Swift SDK v7.0.0+ aktiviert ist (Standard), wird allen neu erstellten Nutzer:innen eine zufällige Geräte-ID zugewiesen. Alle bereits bestehenden Nutzer:innen behalten ihren bisherigen Geräte-ID-Wert bei, der möglicherweise der IDFV war.

Wenn dieses Feature nicht aktiviert ist, wird Geräten bei der Erstellung weiterhin der IDFV zugewiesen.

Downstream

Technologie-Partner: Wenn dieses Feature aktiviert ist, haben alle Technologie-Partner, die den IDFV-Wert von der Braze-Geräte-ID ableiten, keinen Zugriff mehr auf diese Daten. Wenn der vom Gerät abgeleitete IDFV-Wert für Ihre Partnerintegration benötigt wird, empfehlen wir Ihnen, dieses Feature auf false zu setzen.

Currents: Wenn useUUIDAsDeviceId auf true gesetzt ist, entspricht die in Currents gesendete Geräte-ID nicht mehr dem IDFV-Wert.

Häufig gestellte Fragen

Wird sich diese Änderung auf meine bestehenden Nutzer:innen in Braze auswirken?

Nein. Wenn dieses Feature aktiviert ist, werden keine Nutzerdaten in Braze überschrieben. Neue UUID-Geräte-IDs werden nur für neue Geräte erstellt oder wenn wipedata() aufgerufen wird.

Kann ich dieses Feature ausschalten, nachdem ich es eingeschaltet habe?

Ja, dieses Feature kann nach Ihrem Ermessen ein- und ausgeschaltet werden. Zuvor gespeicherte Geräte-IDs werden niemals überschrieben.

Kann ich den IDFV-Wert auch anderweitig über Braze erfassen?

Ja, Sie können den IDFV weiterhin optional über das Swift SDK erfassen (die Erfassung ist standardmäßig deaktiviert).