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.

Tracking-Daten von Braze deklarieren

Tipp

Eine vollständige Anleitung finden Sie im Privacy Tracking Data Tutorial.

Voraussetzungen

Für die Implementierung dieses Features ist die folgende Braze-SDK-Version erforderlich:

Schritt 1: Aktuelle Richtlinien überprüfen

Überprüfen Sie die aktuellen Richtlinien zur Datenerfassung Ihres Braze SDK 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 Privacy Manifest für das Braze SDK derzeit nicht anpassen. Weitere Informationen zu den Richtlinien zur Datenerfassung 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: Privacy Manifest erstellen

Überprüfen Sie zunächst, ob Sie bereits ein Privacy Manifest haben, indem Sie in Ihrem Xcode-Projekt nach einer PrivacyInfo.xcprivacy-Datei suchen. Falls diese Datei bereits vorhanden ist, können Sie mit dem nächsten Schritt fortfahren. Andernfalls siehe Apple: Create a privacy manifest.

Schritt 3: Ihren Endpunkt zum Privacy Manifest 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 seinen 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 seinen Wert auf den Endpunkt, den Sie zuvor in Ihrem AppDelegate hinzugefügt haben, mit dem Präfix sdk-tracking.

Schritt 4: Ihre 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 der/die Endnutzer:in die ATT-Aufforderung akzeptiert. 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 Verarbeitung 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 Daten-Trackings

Um die Daten-Tracking-Aktivität 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 an die öffentliche 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/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 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/dieses Nutzer:in verwendet wird.

Wenn Sie die manuelle Push-Integration verwenden und Ihre App wipeData() aufruft und anschließend das SDK 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.

Daten-Tracking wieder aufnehmen

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 des aktuellen/der aktuellen Nutzer:in auf dem Braze-Server und im SDK, sodass Braze keine zukünftigen Push-Benachrichtigungs-Campaigns mehr an diese/n Nutzer:in 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 vom aktuellen/von der aktuellen Nutzer:in 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 sowie aller Push-to-Start-Tokens für Live Activities vom aktuellen/von der aktuellen Nutzer:in 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);
  }
}];

Hinweis

logout beendet keine aktuell laufenden Live Activities. Beenden Sie im Erfolgs-Callback alle laufenden Live Activities manuell mithilfe der end(_:dismissalPolicy:)-Methode von ActivityKit.

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 die Anleitung unter Swift Push-Einrichtung befolgen.

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 dem/der Braze-Nutzer:in 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 vom aktuellen/von der aktuellen Nutzer:in 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

Nachdem Sie unregisterPush aufgerufen haben, registrieren Sie sich erneut für Benachrichtigungen bei Ihrem Betriebssystem oder Push-Anbieter, indem Sie die Anleitung unter Swift Push-Einrichtung befolgen, bevor Sie erneut Braze Push-Benachrichtigungen versenden.

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 dem/der Braze-Nutzer:in hinzugefügt wird.

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

Live Activities können remote über Push-to-Start-Tokens gestartet werden. Um zu verhindern, dass Braze Live Activities remote auf einem Gerät 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.

Laufende Live Activities beenden

unregisterPushToStart beendet keine aktuell laufenden Live Activities. Beenden Sie im Erfolgs-Callback alle laufenden Live Activities manuell mithilfe der end(_:dismissalPolicy:)-Methode von ActivityKit.

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 dem/der Braze-Nutzer:in 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 über keine 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/des Nutzers: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 festgelegt 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 IDFV weiterhin separat erfassen möchten, können Sie set(identifierforvendor:) verwenden.

Hinweis

Apple ist für die Erstellung von IDFV verantwortlich, und IDFV wird von Apple verwaltet. Braze transformiert oder ändert IDFVs nicht, und Apple gibt keine Garantien bezüglich Groß-/Kleinschreibung oder Format.

Hinweis

Das Lesen von braze.deviceId blockiert den aufrufenden Thread, bis das SDK seine Post-Initialisierungsoperationen abgeschlossen hat. Verwenden Sie für Main-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);
}];

Hinweise

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 ein IDFV war.

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

Nachgelagerte Auswirkungen

Technologie-Partner: Wenn dieses Feature aktiviert ist, können Technologie-Partner, die den IDFV-Wert aus der Braze-Geräte-ID ableiten, nicht mehr auf diese Daten zugreifen. Falls 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 aktiviert, überschreibt dieses Feature keine Nutzerdaten in Braze. 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 anderweitig über Braze erfassen?

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