데이터 수집 관리

Apple의 개인정보 취급방침

추적 데이터란 무엇인가요?

Apple은 “추적 데이터”를 서드파티 데이터(예: 타겟 광고) 또는 데이터 브로커에 연결된 최종사용자 또는 기기에 대해 앱에서 수집한 데이터로 정의합니다. 예제와 함께 전체 정의는 Apple: 추적을 참조하세요.

기본적으로 Braze SDK는 추적 데이터를 수집하지 않습니다. 하지만 Braze SDK 구성에 따라 앱의 개인정보 보호 매니페스트에 Braze 관련 데이터를 나열해야 할 수도 있습니다.

개인정보 보호 매니페스트란?

개인정보 보호 매니페스트는 앱 및 서드파티 SDK가 데이터를 수집하는 이유와 데이터 수집 방법을 설명하는 Xcode 프로젝트의 파일입니다. 데이터를 추적하는 각 서드파티 SDK에는 자체 개인정보 보호 매니페스트가 필요합니다. 앱의 프라이버시 보고서를 생성하면 이러한 개인정보 보호 매니페스트 파일이 단일 보고서로 자동 집계됩니다.

API 추적 데이터 도메인

iOS 17.2부터 Apple은 최종사용자가 광고 추적 투명성(ATT) 프롬프트를 수락할 때까지 앱에서 선언된 모든 추적 엔드포인트를 차단합니다. Braze는 추적 데이터를 라우팅할 수 있는 추적 엔드포인트를 제공하는 동시에, 추적하지 않는 퍼스트파티 데이터를 원래 엔드포인트로 라우팅할 수 있도록 합니다.

Braze 추적 데이터 선언

팁

전체 안내는 개인정보 추적 데이터 튜토리얼을 참조하세요.

전제 조건

이 기능을 구현하려면 다음 Braze SDK 버전이 필요합니다:

1단계: 현재 정책 검토

법무팀과 함께 Braze SDK의 현재 데이터 수집 정책을 검토하여 앱이 Apple이 정의한 추적 데이터를 수집하는지 확인하세요. 추적 데이터를 수집하지 않는 경우, 현재 Braze SDK에 대한 개인정보 보호 매니페스트를 커스텀할 필요가 없습니다. Braze SDK의 데이터 수집 정책에 대한 자세한 내용은 SDK 데이터 수집을 참조하세요.

중요

Braze 이외의 SDK가 추적 데이터를 수집하는 경우, 해당 정책을 별도로 검토해야 합니다.

2단계: 개인정보 보호 매니페스트 생성

먼저 Xcode 프로젝트에서 PrivacyInfo.xcprivacy 파일을 검색하여 개인정보 보호 매니페스트가 이미 있는지 확인하세요. 이 파일이 이미 있는 경우 다음 단계로 진행할 수 있습니다. 그렇지 않은 경우 Apple: 개인정보 보호 매니페스트 생성을 참조하세요.

3단계: 개인정보 보호 매니페스트에 엔드포인트 추가

Xcode 프로젝트에서 앱의 PrivacyInfo.xcprivacy 파일을 열고, 테이블을 마우스 오른쪽 버튼으로 클릭한 다음 Raw Keys and Values를 선택하세요.

App Privacy Configuration에서 NSPrivacyTracking을 선택하고 값을 YES로 설정하세요.

App Privacy Configuration에서 NSPrivacyTrackingDomains를 선택하세요. 도메인 배열에 새 요소를 추가하고, 이전에 AppDelegate에 추가한 엔드포인트 앞에 sdk-tracking을 접두사로 붙여 값을 설정하세요.

4단계: 추적 데이터 선언

다음으로 AppDelegate.swift를 열고 정적 또는 동적 추적 목록을 생성하여 선언하려는 각 추적 속성을 나열하세요. Apple은 최종사용자가 ATT 프롬프트를 수락할 때까지 이러한 속성을 차단하므로, 본인과 법무팀이 추적으로 간주하는 속성만 나열하세요. 예를 들어:

• 정적 예시
• 동적 예시

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

5단계: 무한 재시도 루프 방지

SDK가 무한 재시도 루프에 빠지는 것을 방지하려면 set(adTrackingEnabled: enableAdTracking) 메서드를 사용하여 ATT 권한을 처리하세요. SceneDelegate.swift 메서드의 adTrackingEnabled 속성은 다음과 유사하게 처리해야 합니다:

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

데이터 추적 비활성화하기

SWIFT SDK에서 데이터 추적 활동을 비활성화하려면 Braze 인스턴스의 enabled 속성을 false로 설정하세요. enabled가 false로 설정되면 Braze SDK는 공개 API에 대한 모든 호출을 무시합니다. 또한 SDK는 네트워크 요청, 이벤트 처리 등 진행 중인 모든 작업을 취소합니다.

이전에 저장된 데이터 삭제

wipeData() 메서드를 사용하여 사용자 기기에 로컬로 저장된 SDK 데이터를 완전히 삭제할 수 있습니다.

Braze SWIFT 버전 7.0.0 이상에서는 SDK와 wipeData() 메서드가 기기 ID에 대해 UUID를 무작위로 생성합니다. 그러나 useUUIDAsDeviceId가 false로 설정되어 있거나 SWIFT SDK 버전 5.7.0 이하를 사용하는 경우, IDFV가 해당 사용자의 기기 ID로 자동 사용되므로 /users/delete에 POST 요청도 보내야 합니다.

수동 푸시 통합을 사용하고 있으며 앱에서 wipeData()를 호출한 후 동일한 앱 실행 중에 SDK를 다시 활성화하는 경우, Braze가 갱신된 기기 토큰을 수신할 수 있도록 registerForRemoteNotifications()를 다시 호출해야 합니다. 자세한 내용은 푸시 알림 설정을 참조하세요.

데이터 추적 재개

데이터 수집을 재개하려면 enabled를 true로 설정하세요. 이전에 삭제된 데이터는 복원되지 않는다는 점에 유의하세요.

로그아웃 및 푸시 등록 해제

Braze SDK는 사용자가 푸시 알림 등록을 해제하거나 로그아웃할 때 기기를 타겟팅 대상에서 제외하는 메서드를 제공합니다. 이 메서드는 Braze 서버와 SDK에서 현재 사용자의 푸시 등록 데이터를 제거하므로, Braze는 해당 사용자에게 더 이상 푸시 알림 Campaign을 전송하지 않습니다.

로그아웃

사용자가 애플리케이션에서 로그아웃할 때, SDK의 logout 메서드를 호출하여 현재 사용자로부터 기기의 푸시 등록을 제거하고 SDK에서 자동으로 정리 작업을 수행합니다. logout 메서드는 다음 작업을 수행합니다:

• Braze 서버에서 현재 사용자의 기기 푸시 토큰 및 모든 Live Activities push-to-start 토큰의 등록을 해제합니다.
• 등록 해제 호출이 성공하면, SDK는 로컬에 저장된 SDK 데이터를 삭제하고 SDK를 비활성화합니다.
• 실패 시, 오류와 isRetriable 플래그를 발생시켜 통합 담당자가 조치를 취할 수 있도록 합니다.

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

logout 후 추적 및 푸시 다시 활성화하기

logout이 성공한 후, enabled를 다시 true로 설정한 다음, Swift 푸시 설정을 따라 운영 체제(OS) 또는 푸시 공급자에 알림을 다시 등록하세요.

즉시 등록 해제 호출 방지

OS 또는 푸시 공급자에 푸시 알림을 등록한 직후에 logout 또는 unregisterPush를 호출하지 마세요. 비동기 서버 처리로 인해 드물게 푸시 토큰이 Braze 사용자에게 다시 추가될 수 있습니다.

푸시 등록 해제

추가적인 자동 정리 없이 기기에 대한 푸시 전송을 중지하려면 unregisterPush 메서드를 사용하세요. 이 메서드는 Braze 서버에서 현재 사용자의 기기 푸시 토큰을 제거하고, 로컬에 저장된 토큰을 삭제합니다.

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

unregisterPush 후 푸시 다시 등록하기

unregisterPush를 호출한 후, Braze 푸시 알림을 다시 전송하기 전에 Swift 푸시 설정을 따라 OS 또는 푸시 공급자에 알림을 다시 등록하세요.

즉시 등록 해제 호출 방지

OS 또는 푸시 공급자에 푸시 알림을 등록한 직후에 logout 또는 unregisterPush를 호출하지 마세요. 비동기 서버 처리로 인해 드물게 푸시 토큰이 Braze 사용자에게 다시 추가될 수 있습니다.

Live Activities의 push-to-start 토큰 등록 해제

Live Activities는 push-to-start 토큰을 사용하여 원격으로 시작할 수 있습니다. Braze가 기기에서 Live Activities를 원격으로 시작하지 못하도록 하려면, unregisterPushToStart 메서드를 호출하여 현재 등록된 모든 유형(기본값) 또는 지정된 Activity 유형 목록의 등록을 해제하세요.

현재 실행 중인 Live Activities는 계속 업데이트를 수신하며, 이 메서드는 새로운 활동을 원격으로 시작하는 기능만 제거합니다. Live Activities에 대한 자세한 내용은 Live Activities를 참조하세요.

참고

Live Activity에 대해 registerPushToStart를 호출한 직후에 logout 또는 unregisterPushToStart를 호출하지 마세요. 서버 처리의 비동기 특성으로 인해 드물게 push-to-start 토큰이 Braze 사용자에게 다시 추가될 수 있습니다.

다음 예제는 모든 push-to-start Activity 유형의 등록을 해제하는 방법을 보여줍니다. 로그아웃한 사용자가 더 이상 원격으로 시작되는 새로운 Live Activities를 수신하지 않아야 할 때 사용하세요.

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

다음 예제는 특정 Activity 유형의 등록을 해제하는 방법을 보여줍니다. 선택한 Live Activities만 원격 시작을 중지해야 할 때 사용하세요.

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

참고

unregisterPushToStart는 Live Activities가 Swift 전용 타입에 의존하므로 OBJECTIVE-C API가 없습니다.

IDFV 수집

이전 버전의 Braze iOS SDK에서는 IDFV(Identifier for Vendor) 필드가 사용자의 기기 ID로 자동 수집되었습니다. Swift SDK v5.7.0부터 IDFV 필드를 선택적으로 비활성화할 수 있게 되었으며, 대신 Braze가 랜덤 UUID를 기기 ID로 설정하도록 변경되었습니다. Swift SDK v7.0.0부터는 IDFV 필드가 기본적으로 수집되지 않으며, 대신 UUID가 기기 ID로 설정됩니다.

useUUIDAsDeviceId 기능은 Swift SDK가 기기 ID를 UUID로 설정하도록 구성합니다. 기존에는 iOS SDK가 Apple에서 생성한 IDFV 값과 동일한 기기 ID를 할당했습니다. 이 기능이 iOS 앱에서 기본적으로 활성화되면, SDK를 통해 생성된 모든 신규 사용자에게 UUID와 동일한 기기 ID가 할당됩니다.

IDFV를 별도로 수집하려면 set(identifierforvendor:)를 사용할 수 있습니다.

참고

braze.deviceId를 읽으면 SDK가 초기화 후 작업을 완료할 때까지 호출 스레드가 차단됩니다. 메인 스레드 또는 지연 시간에 민감한 컨텍스트에서는 대신 비차단 대안을 사용하세요.

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

고려 사항

SDK 버전

Swift SDK v7.0.0+에서 useUUIDAsDeviceId가 활성화된 경우(기본값), 새로 생성된 모든 사용자에게 랜덤 기기 ID가 할당됩니다. 기존에 존재하던 모든 사용자는 동일한 기기 ID 값을 유지하며, 이 값은 IDFV였을 수 있습니다.

이 기능이 활성화되지 않은 경우, 기기는 생성 시 계속 IDFV가 할당됩니다.

다운스트림

기술 파트너: 이 기능이 활성화되면, Braze 기기 ID에서 IDFV 값을 파생하는 기술 파트너는 더 이상 이 데이터에 접근할 수 없습니다. 파트너 통합에 기기에서 파생된 IDFV 값이 필요한 경우, 이 기능을 false로 설정하는 것을 권장합니다.

Currents: useUUIDAsDeviceId를 true로 설정하면 Currents에서 전송되는 기기 ID가 더 이상 IDFV 값과 동일하지 않게 됩니다.

자주 묻는 질문

이 변경 사항이 Braze의 기존 사용자에게 영향을 미치나요?

아니요. 이 기능이 활성화되어도 Braze의 기존 사용자 데이터를 덮어쓰지 않습니다. 새로운 UUID 기기 ID는 새 기기에서만 생성되거나 wipedata()가 호출될 때만 생성됩니다.

이 기능을 켠 후 다시 끌 수 있나요?

네, 이 기능은 필요에 따라 자유롭게 켜고 끌 수 있습니다. 이전에 저장된 기기 ID는 절대 덮어쓰이지 않습니다.

Braze의 다른 곳에서 IDFV 값을 여전히 캡처할 수 있나요?

네, Swift SDK를 통해 IDFV를 선택적으로 수집할 수 있습니다(기본적으로 수집은 비활성화되어 있습니다).