Android SDK - 데이터 개인 정보 보호

문서

데이터 개인정보 보호법 준수

GDPR, CCPA 및 기타 소비자 개인정보 보호 규정에 대한 사용자 동의 선택 사항을 Singular에 알림으로써 개인정보 보호 규정을 준수하는 데이터 수집을 구현하세요.

사용자가 제3자와의 정보 공유에 동의하거나 거부할 경우, Singular의 개인정보 보호 방법을 사용하여 사용자의 선택 사항을 전달하세요. 이를 통해 캘리포니아 소비자 개인정보 보호법(CCPA)과 같은 규정을 준수하고 파트너가 사용자의 개인정보 보호 기본 설정을 존중할 수 있습니다.

자세히 알아보기: Singular가 개인정보 동의를 처리하는 방법에 대한 자세한 내용은 사용자 개인정보 보호 및 데이터 공유 제한을참조하세요.


데이터 공유 제한

타사 데이터 공유 제어

limitDataSharing 방법을 사용하여 사용자가 타사 파트너와 개인 데이터를 공유하는 데 동의했는지 여부를 Singular에 알립니다.

메소드 서명:

Singular.limitDataSharing(boolean shouldLimitDataSharing)

매개변수:

  • false: 사용자가 데이터 공유에 동의하고 옵트인했습니다.
  • true: 사용자가 옵트아웃했으며 데이터 공유에 동의하지 않음

중요: 선택 사항이지만, 이 방법은 어트리뷰션 데이터 공유에 영향을 줍니다. 일부 파트너는 사용자가 옵트인했음을 명시적으로 알린 경우에만 완전한 어트리뷰션 정보를 공유합니다.

사용 예시

KotlinJava
// User has opted in to share their data
Singular.limitDataSharing(false)

// User has opted out and declined to share their data
Singular.limitDataSharing(true)

// Example: Set based on user preference
fun handlePrivacyConsent(userConsented: Boolean) {
    // Pass inverse: false = opted in, true = opted out
    Singular.limitDataSharing(!userConsented)
    
    Log.d("Privacy", "Data sharing: ${if (userConsented) "Enabled" else "Limited"}")
}

작동 방식:

Singular는 사용자 개인정보 포스트백에서이 설정을 사용하여 규정 준수를 위해 이 설정이 필요한 파트너에게 전달합니다.


GDPR 준수 방법

사용자 추적 동의를 관리하고 SDK 기능을 제어하여 GDPR(일반 데이터 보호 규정) 및 기타 개인정보 보호 규정을 준수합니다.

추적 동의 관리

추적 옵트인

Singular 서버에 GDPR 옵트인 이벤트를 전송하여 추적에 대한 명시적인 사용자 동의를 기록합니다.

메서드 서명:

Singular.trackingOptIn()

사용 시기:

  • GDPR 준수: 사용자가 GDPR 규제 지역에서 추적에 명시적으로 동의할 때 호출합니다.
  • 동의 기록: 사용자가 Singular의 시스템에서 GDPR 동의를 제공한 것으로 표시합니다.
  • 기본 동작: 이 호출이 없으면 SDK는 추적을 계속하지만 동의를 구체적으로 기록하지 않습니다.
KotlinJava
// User accepted tracking consent
Singular.trackingOptIn()

// Example: Call after consent dialog
fun onUserAcceptedTracking() {
    Singular.trackingOptIn()
    Log.d("GDPR", "User opted in to tracking")
}

추적 제어 방법

stopAllTracking

이 디바이스에서 현재 사용자에 대한 모든 SDK 추적 활동을 완전히 비활성화합니다.

메소드 서명:

Singular.stopAllTracking()

심각 중요: 이 메서드는 resumeAllTracking() 이 호출될 때까지 SDK를 영구적으로 비활성화합니다. 비활성화 상태는 앱을 다시 시작할 때에도 유지되며 프로그래밍 방식으로만 되돌릴 수 있습니다.

동작:

  • 즉각적인 효과: 모든 추적, 이벤트 보고 및 데이터 수집을 즉시 중지합니다.
  • 영구 상태: 앱을 닫았다가 다시 열어도 비활성화 상태로 유지됨
  • 자동 재설정 없음: 다시 활성화하려면 resumeAllTracking() 을 명시적으로 호출해야 합니다.
KotlinJava
// User declined all tracking
Singular.stopAllTracking()

// Example: Handle user opt-out
fun onUserDeclinedTracking() {
    Singular.stopAllTracking()
    Log.d("Privacy", "All tracking stopped")
    
    // Optionally store preference
    saveUserTrackingPreference(false)
}

resumeAllTracking

로 추적을 중지한 후 다시 활성화합니다( stopAllTracking()).

메소드 서명:

Singular.resumeAllTracking()

사용 사례:

  • 동의 변경: 사용자가 개인정보 기본 설정을 변경하고 추적을 다시 사용하도록 선택
  • 개인정보 설정: 사용자가 앱 설정 메뉴를 통해 동의를 업데이트합니다.
  • 지역 규정 준수: 사용자가 비규제 지역으로 이동할 경우 추적을 다시 활성화합니다.
KotlinJava
// User opted back in to tracking
Singular.resumeAllTracking()

// Example: Handle consent update
fun onUserResumedTracking() {
    Singular.resumeAllTracking()
    Log.d("Privacy", "Tracking resumed")
    
    // Optionally update stored preference
    saveUserTrackingPreference(true)
}

isAllTrackingStopped

현재 사용자에 대한 추적이 비활성화되었는지 확인합니다.

메소드 서명:

boolean Singular.isAllTrackingStopped()

반환합니다:

  • true: 현재 stopAllTracking()을 통해 추적이 중지되었습니다.
  • false: 추적이 활성 상태입니다(중지되거나 재개되지 않음).
KotlinJava
// Check current tracking status
val isTrackingStopped = Singular.isAllTrackingStopped()

// Example: Display privacy status in settings
fun getPrivacyStatusText(): String {
    return if (Singular.isAllTrackingStopped()) {
        "Tracking: Disabled"
    } else {
        "Tracking: Enabled"
    }
}

// Example: Sync UI with tracking state
fun updatePrivacyToggle() {
    val isStopped = Singular.isAllTrackingStopped()
    privacyToggle.isChecked = !isStopped
    Log.d("Privacy", "Current tracking state: ${if (isStopped) "Stopped" else "Active"}")
}

어린이 개인정보 보호

trackingUnder13

사용자가 13세 미만임을 Singular에 알려 COPPA(아동 온라인 개인정보 보호법) 및 기타 아동 개인정보 보호 규정을 준수하도록 합니다.

방법 서명:

Singular.trackingUnder13()

준수 요구 사항:

  • COPPA 준수: 미국에서 13세 미만 아동의 데이터를 수집하는 앱에 필수입니다.
  • 연령 제한 콘텐츠: 등록 또는 연령 확인 시 사용자가 13세 미만임을 확인할 때 사용합니다.
  • 제한된 추적: 아동 개인정보 보호법을 준수하기 위해 데이터 수집을 제한합니다.
KotlinJava
// User identified as under 13
Singular.trackingUnder13()

// Example: Call after age verification
fun onAgeVerified(userAge: Int) {
    if (userAge < 13) {
        Singular.trackingUnder13()
        Log.d("Privacy", "COPPA mode enabled for user under 13")
    }
}

중요: 사용자가 13세 미만임을 확인한 후 가능한 한 빨리, 즉 앱 초기화 중 또는 연령 확인 직후에 이 방법을 호출하세요. 이렇게 하면 이후 모든 추적에서 아동의 개인정보 보호 규정을 준수할 수 있습니다.


설정 제한 광고 식별자

혼합 오디언스 앱의 경우 SDK 초기화 후 광고 식별자(Android의 경우 GAID)의 수집 및 사용을 제한합니다.

메서드 서명:

Singular.setLimitAdvertisingIdentifiers()

사용 사례:

  • 혼합 오디언스 앱: 앱 출시 후 연령이 결정되는 성인과 어린이 모두에게 서비스를 제공하는 앱
  • 동적 개인정보 제어: 사용자 행동 또는 액세스하는 콘텐츠에 따라 추적 조정
  • 런타임 제한: 초기 SDK 설정 후 광고 식별자 제한 적용
KotlinJava
// Limit advertising identifiers after initialization
Singular.setLimitAdvertisingIdentifiers()

// Example: Mixed audience app with age gate
fun onKidsModeSwitched(isKidsMode: Boolean) {
    if (isKidsMode) {
        Singular.setLimitAdvertisingIdentifiers()
        Log.d("Privacy", "Advertising identifiers limited for kids mode")
    }
}

// Example: Content-based restrictions
fun onViewingChildrensContent() {
    Singular.setLimitAdvertisingIdentifiers()
    Log.d("Privacy", "Ad identifiers restricted for children's content")
}

구성 대안: SDK가 시작되기 전에 개인정보 보호 요구 사항을 알고 있는 경우 SingularConfig.withLimitAdvertisingIdentifiers() 을 사용하여 SDK 초기화 중에 광고 식별자를 제한할 수도 있습니다.

구성 방법

개인정보 보호 요구 사항을 미리 알고 있는 앱의 경우 SDK 초기화 중에 광고 식별자 제한을 설정합니다.

KotlinJava
// Limit advertising identifiers at initialization
val config = SingularConfig("SDK_KEY", "SDK_SECRET")
    .withLimitAdvertisingIdentifiers()

Singular.init(applicationContext, config)

구현 모범 사례

완전한 개인정보 관리 예시

사용자 기본 설정을 존중하고 규정을 준수하는 포괄적인 개인정보 관리 기능을 구현하세요.

KotlinJava
class PrivacyManager(private val context: Context) {
    
    private val prefs = context.getSharedPreferences("privacy_prefs", Context.MODE_PRIVATE)
    
    // Initialize privacy settings on app start
    fun initializePrivacy() {
        val hasUserConsent = getUserConsent()
        val allowDataSharing = getDataSharingPreference()
        val userAge = getUserAge()
        
        // Apply stored preferences
        if (hasUserConsent) {
            Singular.trackingOptIn()
            Singular.resumeAllTracking()
        } else {
            Singular.stopAllTracking()
        }
        
        // Set data sharing preference
        Singular.limitDataSharing(!allowDataSharing)
        
        // Handle children's privacy
        if (userAge > 0 && userAge < 13) {
            Singular.trackingUnder13()
            Singular.setLimitAdvertisingIdentifiers()
        }
        
        Log.d("Privacy", "Initialized: consent=$hasUserConsent, sharing=$allowDataSharing, age=$userAge")
    }
    
    // User accepts tracking via consent dialog
    fun userAcceptedTracking() {
        saveUserConsent(true)
        Singular.trackingOptIn()
        Singular.resumeAllTracking()
        Log.d("Privacy", "User accepted tracking")
    }
    
    // User declines tracking
    fun userDeclinedTracking() {
        saveUserConsent(false)
        Singular.stopAllTracking()
        Log.d("Privacy", "User declined tracking")
    }
    
    // User updates data sharing preference
    fun setDataSharingEnabled(enabled: Boolean) {
        saveDataSharingPreference(enabled)
        // Note: limitDataSharing uses inverse logic
        Singular.limitDataSharing(!enabled)
        Log.d("Privacy", "Data sharing: ${if (enabled) "Enabled" else "Limited"}")
    }
    
    // Handle age verification result
    fun onAgeVerified(age: Int) {
        saveUserAge(age)
        if (age < 13) {
            Singular.trackingUnder13()
            Singular.setLimitAdvertisingIdentifiers()
            Log.d("Privacy", "COPPA restrictions applied for user under 13")
        }
    }
    
    // Get current tracking status
    fun isTrackingEnabled(): Boolean {
        return !Singular.isAllTrackingStopped()
    }
    
    // Private helper methods
    private fun getUserConsent(): Boolean {
        return prefs.getBoolean("user_consent", false)
    }
    
    private fun saveUserConsent(consent: Boolean) {
        prefs.edit().putBoolean("user_consent", consent).apply()
    }
    
    private fun getDataSharingPreference(): Boolean {
        return prefs.getBoolean("data_sharing", false)
    }
    
    private fun saveDataSharingPreference(enabled: Boolean) {
        prefs.edit().putBoolean("data_sharing", enabled).apply()
    }
    
    private fun getUserAge(): Int {
        return prefs.getInt("user_age", 0)
    }
    
    private fun saveUserAge(age: Int) {
        prefs.edit().putInt("user_age", age).apply()
    }
}

모범 사례:

  • 영구 저장소: 공유 환경설정 또는 보안 스토리지에 사용자 환경설정을 저장하세요.
  • 조기 초기화: 가능한 경우 SDK 초기화 전에 개인정보 보호 설정을 적용하세요.
  • UI 동기화: isAllTrackingStopped() 을 사용하여 설정 UI를 실제 SDK 상태와 동기화 유지
  • 명확한 커뮤니케이션: 앱 설정에서 명확하고 접근 가능한 개인정보 보호 컨트롤 제공
  • 연령 확인: 어린이를 대상으로 하는 앱에 강력한 연령 인증을 구현합니다.
  • 결합된 제어: 13세 미만 사용자의 경우 trackingUnder13()setLimitAdvertisingIdentifiers()을 모두 적용합니다.