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.

Deklaration von Braze-Tracking-Daten

Tipp

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

Voraussetzungen

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

Schritt 1: Aktuelle Richtlinien überprüfen

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

Wichtig

Wenn eines Ihrer Nicht-Braze-SDKs Tracking-Daten erfasst, müssen Sie diese Richtlinien separat überprüfen.

Schritt 2: Datenschutzmanifest erstellen

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 lesen Sie Apple: Datenschutzmanifest erstellen.

Schritt 3: Endpunkt zum Datenschutzmanifest hinzufügen

Öffnen Sie in Ihrem Xcode-Projekt die PrivacyInfo.xcprivacy-Datei Ihrer App, klicken Sie dann mit der rechten Maustaste 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 in Ihrem AppDelegate hinzugefügt haben, mit dem Präfix sdk-tracking.

Schritt 4: Tracking-Daten deklarieren

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

• statisches beispiel
• dynamisches beispiel

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 sceneDidBecomeActive(_ scene: UIScene) {
  // 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]
    )
  }
}

Schritt 5: Endlose Wiederholungsschleifen verhindern

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

1
2
3
4
5
6
7
8
func sceneDidBecomeActive(_ scene: UIScene) {
    // 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 Trackings von Daten

Um das Tracking von Daten im Swift SDK zu deaktivieren, setzen Sie die Eigenschaft enabled auf Ihrer Braze-Instanz auf false. Wenn enabled auf false gesetzt ist, ignoriert das Braze SDK alle Aufrufe der öffentlichen API. Das SDK bricht außerdem alle laufenden Aktionen ab, wie z. B. Netzwerkanfragen, Ereignisverarbeitung usw.

Zuvor gespeicherte Daten löschen

Sie können die Methode wipeData() verwenden, um lokal gespeicherte SDK-Daten auf dem Gerät einer Nutzerin oder eines Nutzers 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 jedoch useUUIDAsDeviceId 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 der Identifier for Vendors (IDFV) automatisch als Geräte-ID dieser Nutzerin bzw. dieses Nutzers verwendet wird.

Wenn Sie die manuelle Push-Integration verwenden und Ihre App wipeData() aufruft und das SDK anschließend im selben App-Durchlauf 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 Trackings von Daten

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

Abmelden und Push-Registrierung aufheben

Das Braze SDK stellt Methoden bereit, um ein Gerät nicht mehr anzusprechen, wenn Nutzer:innen sich von Push-Benachrichtigungen abmelden oder sich ausloggen. Diese Methoden entfernen die Push-Registrierungsdaten der aktuellen Nutzer:innen auf dem Braze-Server und im SDK, sodass Braze keine zukünftigen Push-Benachrichtigungs-Campaigns mehr an diese Nutzer:innen sendet.

Abmelden

Wenn sich Nutzer:innen aus einer Anwendung abmelden, rufen Sie die logout-Methode des SDK auf, um die Push-Registrierung des Geräts von den aktuellen Nutzer:innen zu entfernen und automatisch Bereinigungsaktionen im SDK durchzuführen. Die logout-Methode führt Folgendes aus:

• Hebt die Registrierung des Push-Tokens des Geräts und aller Push-to-Start-Tokens für Live Activities von den aktuellen Nutzer:innen auf dem Braze-Server auf.
• Wenn der Aufruf zur Aufhebung der Registrierung erfolgreich ist, löscht das SDK lokal gespeicherte SDK-Daten und deaktiviert das SDK.
• Bei einem Fehler wird ein Fehler und ein isRetriable-Flag ausgelöst, damit die Integration entsprechende Maßnahmen ergreifen kann.

• swift
• objective-c

1
2
3
4
5
6
7
8
9
// Completion handler
AppDelegate.braze?.logout { result in
  switch result {
  case .success:
    print("Logout successful")
  case .failure(let error):
    print("Logout failed: \(error.message), isRetriable: \(error.isRetriable)")
  }
}

1
2
3
4
5
6
7
// Async/await
do {
  try await AppDelegate.braze?.logout()
  print("Logout successful")
} catch let error as Braze.LogoutErrorResult {
  print("Logout failed: \(error.message), isRetriable: \(error.isRetriable)")
}

1
2
3
4
5
6
[AppDelegate.braze logoutWithCompletion:^(NSError * _Nullable error) {
  if (error) {
    NSNumber *isRetriable = error.userInfo[BRZLogoutErrorUserInfoKey.isRetriable];
    NSLog(@"Logout failed: %@, isRetriable=%@", error.localizedDescription, isRetriable);
  }
}];

Tracking und Push nach logout wieder aktivieren

Nach einem erfolgreichen logout setzen Sie enabled wieder auf true und registrieren sich dann erneut für Benachrichtigungen bei Ihrem Betriebssystem oder Push-Anbieter, indem Sie der Swift-Push-Einrichtung folgen.

Sofortige Aufrufe zur Aufhebung der Registrierung vermeiden

Vermeiden Sie es, logout oder unregisterPush direkt nach der Registrierung für Push-Benachrichtigungen beim Betriebssystem oder Push-Anbieter aufzurufen. Aufgrund der asynchronen Serververarbeitung kann dies in seltenen Fällen dazu führen, dass das Push-Token erneut den Braze-Nutzer:innen hinzugefügt wird.

Push-Registrierung aufheben

Um den Push-Versand an ein Gerät ohne zusätzliche automatische Bereinigung zu stoppen, verwenden Sie die unregisterPush-Methode. Diese entfernt das Push-Token des Geräts von den aktuellen Nutzer:innen auf dem Braze-Server und löscht das lokal gespeicherte Token.

• swift
• objective-c

1
2
3
4
5
6
7
8
9
// Completion handler
AppDelegate.braze?.notifications.unregisterPush { result in
  switch result {
  case .success:
    print("Push unregistered successfully")
  case .failure(let error):
    print("Push unregistration failed: \(error.message), isRetriable: \(error.isRetriable)")
  }
}

1
2
3
4
5
6
7
// Async/await
do {
  try await AppDelegate.braze?.notifications.unregisterPush()
  print("Push unregistered successfully")
} catch let error as Braze.PushUnregistrationError {
  print("Push unregistration failed: \(error.message), isRetriable: \(error.isRetriable)")
}

1
2
3
4
5
6
7
8
[AppDelegate.braze.notifications unregisterPushWithCompletion:^(NSError * _Nullable error) {
  if (error) {
    NSNumber *isRetriable = error.userInfo[BRZPushUnregistrationErrorUserInfoKey.isRetriable];
    NSNumber *statusCode = error.userInfo[BRZPushUnregistrationErrorUserInfoKey.httpStatusCode];
    NSLog(@"Push unregistration failed: %@, isRetriable=%@ status=%@",
          error.localizedDescription, isRetriable, statusCode);
  }
}];

Push nach unregisterPush erneut registrieren

Nach dem Aufruf von unregisterPush registrieren Sie sich erneut für Benachrichtigungen bei Ihrem Betriebssystem oder Push-Anbieter, indem Sie der Swift-Push-Einrichtung folgen, bevor Sie erneut Braze-Push-Benachrichtigungen senden.

Sofortige Aufrufe zur Aufhebung der Registrierung vermeiden

Vermeiden Sie es, logout oder unregisterPush direkt nach der Registrierung für Push-Benachrichtigungen beim Betriebssystem oder Push-Anbieter aufzurufen. Aufgrund der asynchronen Serververarbeitung kann dies in seltenen Fällen dazu führen, dass das Push-Token erneut den Braze-Nutzer:innen hinzugefügt wird.

Push-to-Start-Tokens für Live Activities aufheben

Live Activities können remote über Push-to-Start-Tokens gestartet werden. Um zu verhindern, dass Braze Live Activities auf einem Gerät remote startet, rufen Sie die unregisterPushToStart-Methode auf, um alle aktuell registrierten Typen (Standard) oder eine bestimmte Liste von Activity-Typen abzumelden.

Beachten Sie, dass aktuell laufende Live Activities weiterhin Updates erhalten und dass diese Methode nur die Möglichkeit entfernt, neue Activities remote zu starten. Weitere Informationen zu Live Activities finden Sie unter Live Activities.

Hinweis

Vermeiden Sie es, logout oder unregisterPushToStart direkt nach dem Aufruf von registerPushToStart für eine Live Activity aufzurufen. Aufgrund der asynchronen Natur der Serververarbeitung kann dies in seltenen Fällen dazu führen, dass das Push-to-Start-Token erneut den Braze-Nutzer:innen hinzugefügt wird.

Das folgende Beispiel zeigt, wie Sie alle Push-to-Start-Activity-Typen abmelden. Verwenden Sie es, wenn abgemeldete Nutzer:innen keine neuen remote gestarteten Live Activities mehr erhalten sollen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Unregister all currently-registered activity types
// Completion handler
AppDelegate.braze?.liveActivities.unregisterPushToStart { result in
  switch result {
  case .success:
    print("Push-to-start unregistered successfully")
  case .failure(let error):
    print("Push-to-start unregistration failed: \(error.message), isRetriable: \(error.isRetriable)")
  }
}

// Async/await
do {
  try await AppDelegate.braze?.liveActivities.unregisterPushToStart()
  print("Push-to-start unregistered successfully")
} catch let error as Braze.PushUnregistrationError {
  print("Push-to-start unregistration failed: \(error.message), isRetriable: \(error.isRetriable)")
}

Das folgende Beispiel zeigt, wie Sie bestimmte Activity-Typen abmelden. Verwenden Sie es, wenn nur ausgewählte Live Activities nicht mehr remote gestartet werden sollen.

1
2
3
4
5
6
7
8
9
// Unregister specific activity types
AppDelegate.braze?.liveActivities.unregisterPushToStart(types: ["ActivityType1", "ActivityType2"]) { result in
  switch result {
  case .success:
    print("Push-to-start unregistered successfully")
  case .failure(let error):
    print("Push-to-start unregistration failed: \(error.message), isRetriable: \(error.isRetriable)")
  }
}

Hinweis

unregisterPushToStart verfügt nicht über eine Objective-C-API, da Live Activities auf Swift-exklusive Typen angewiesen sind.

IDFV-Erfassung

In früheren Versionen des Braze iOS SDK wurde das IDFV-Feld (Identifier for Vendors) automatisch als Geräte-ID der Nutzer:innen 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 gesetzt.

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

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

Hinweis

Das Lesen von braze.deviceId blockiert den aufrufenden Thread, bis das SDK seine Operationen nach der Initialisierung abgeschlossen hat. Verwenden Sie für den Haupt-Thread oder latenzempfindliche Kontexte stattdessen die nicht-blockierenden Alternativen.

• swift
• objective-c

1
2
3
4
5
6
7
// Completion handler — always delivers on the main thread.
AppDelegate.braze?.getDeviceId { deviceId in
  print("Device ID:", deviceId)
}

// Async/await (iOS 13.0+, tvOS 13.0+, watchOS 6.0+, macOS 10.15+)
let deviceId = await AppDelegate.braze?.getDeviceId()

1
2
3
4
// Completion handler — always delivers on the main thread.
[AppDelegate.braze getDeviceIdWithCompletion:^(NSString *deviceId) {
  NSLog(@"Device ID: %@", deviceId);
}];

Überlegungen

SDK-Version

Wenn in Swift SDK v7.0.0+ useUUIDAsDeviceId aktiviert ist (Standard), wird allen neuen Nutzer:innen eine zufällige Geräte-ID zugewiesen. Alle bereits vorhandenen 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.

Nachgelagerte Auswirkungen

Technologie-Partner: Wenn dieses Feature aktiviert ist, haben Technologie-Partner, die den IDFV-Wert aus 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, 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

Wirkt sich diese Änderung auf meine bestehenden Nutzer:innen in Braze aus?

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 nach der Aktivierung wieder deaktivieren?

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

Kann ich den IDFV-Wert weiterhin an anderer Stelle über Braze erfassen?

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