개인정보 보호 매니페스트

Braze SDK에서 추적 데이터를 수집하는 경우, Apple은 추적 데이터 수집 이유와 방법을 설명하는 개인정보 보호 매니페스트를 추가하도록 요구합니다.

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

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

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

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

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

API 추적 데이터 도메인

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

Braze 추적 데이터 선언하기

1단계: 현재 정책 검토

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

2단계: 개인정보 보호 매니페스트 만들기

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

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

Xcode 프로젝트에서 앱의 PrivacyInfo.xcprivacy 파일을 연 다음, 테이블을 마우스 오른쪽 버튼으로 클릭하고 원시 키 및 값을 확인합니다.

앱 개인정보 보호 구성에서 NSPrivacyTracking을 선택하고 값을 YES로 설정합니다.

앱 개인정보 구성에서 NSPrivacyTrackingDomains를 선택합니다. 도메인 배열에서 새 요소를 추가하고 이전에 AppDelegate에 추가한 엔드포인트(접두사 sdk-tracking)로 설정합니다.

4단계: 추적 데이터 신고

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

• 정적 예제
• 동적 예제

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단계: 무한 재시도 루프 방지

SDK가 무한 재시도 루프에 빠지지 않도록 set(adTrackingEnabled: enableAdTracking) 메서드를 사용하여 ATT 권한을 처리합니다. 메서드의 adTrackingEnabled 속성정보는 다음과 유사하게 처리해야 합니다.

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