문서

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

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

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

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

데이터 공유 제한

타사 데이터 공유 제어

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

메소드 서명:

static void limitDataSharing(bool shouldLimitDataSharing)

매개변수:

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

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

전체 메서드 설명서는 limitDataSharing 참조를 참조하세요.

사용 예시

사용자 개인정보 기본 설정에 따라 데이터 공유 제어를 구현합니다.

import 'package:singular_flutter_sdk/singular.dart';

// User has opted in to share their data
void onUserOptedInToDataSharing() {
  Singular.limitDataSharing(false);
  print('Data sharing enabled');
}

// User has opted out and declined to share their data
void onUserOptedOutOfDataSharing() {
  Singular.limitDataSharing(true);
  print('Data sharing limited');
}

// Set based on user preference
void handlePrivacyConsent(bool userConsented) {
  // Pass inverse: false = opted in, true = opted out
  Singular.limitDataSharing(!userConsented);

  print('Data sharing: ${userConsented ? 'Enabled' : 'Limited'}');
}

작동 방식:

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

GDPR 준수 방법

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

추적 동의 관리

TrackingOptIn

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

메서드 서명:

static void trackingOptIn()

사용 시기:

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

전체 메서드 문서는 trackingOptIn 참조를 참조하세요.

구현 예시

사용자가 앱의 동의 대화 상자를 통해 추적 동의를 수락한 후 trackingOptIn() 으로 호출합니다.

import 'package:flutter/material.dart';
import 'package:singular_flutter_sdk/singular.dart';
import 'package:shared_preferences/shared_preferences.dart';

class GDPRManager extends StatefulWidget {
  @override
  _GDPRManagerState createState() => _GDPRManagerState();
}

class _GDPRManagerState extends State<GDPRManager> {
  bool? hasConsent;

  @override
  void initState() {
    super.initState();
    checkStoredConsent();
  }

  Future<void> checkStoredConsent() async {
    final prefs = await SharedPreferences.getInstance();
    final consent = prefs.getString('gdpr_consent');

    if (consent == null) {
      // Show consent dialog
      showGDPRConsentDialog();
    } else {
      setState(() {
        hasConsent = consent == 'true';
      });
    }
  }

  void showGDPRConsentDialog() {
    showDialog(
      context: context,
      barrierDismissible: false,
      builder: (context) => AlertDialog(
        title: Text('Privacy Consent'),
        content: Text(
          'We would like your permission to track app usage and improve your experience.'
        ),
        actions: [
          TextButton(
            onPressed: () {
              Navigator.of(context).pop();
              setState(() {
                hasConsent = false;
              });
            },
            child: Text('Decline'),
          ),
          ElevatedButton(
            onPressed: () async {
              Navigator.of(context).pop();
              await onUserAcceptedTracking();
            },
            child: Text('Accept'),
          ),
        ],
      ),
    );
  }

  Future<void> onUserAcceptedTracking() async {
    // Record user consent
    Singular.trackingOptIn();
    print('User opted in to tracking');

    // Save preference
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('gdpr_consent', 'true');

    setState(() {
      hasConsent = true;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: hasConsent != null
            ? Text('Privacy Status: ${hasConsent! ? 'Opted In' : 'Declined'}')
            : CircularProgressIndicator(),
      ),
    );
  }
}

추적 제어 메서드

StopAllTracking

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

메소드 서명:

static void stopAllTracking()

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

동작:

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

전체 메서드 문서는 stopAllTracking 참조를 참조하세요.

구현 예시

사용자가 동의를 거부하거나 개인정보 설정을 통해 옵트아웃하면 추적을 중지합니다.

import 'package:singular_flutter_sdk/singular.dart';
import 'package:shared_preferences/shared_preferences.dart';

// User declined all tracking
Future<void> onUserDeclinedTracking() async {
  Singular.stopAllTracking();
  print('All tracking stopped');

  // Store preference
  final prefs = await SharedPreferences.getInstance();
  await prefs.setBool('tracking_enabled', false);
}

// Handle user opt-out from settings menu
void handlePrivacySettingsChange(bool trackingEnabled) {
  if (!trackingEnabled) {
    Singular.stopAllTracking();
    print('Privacy settings: Tracking disabled');
  }
}

ResumeAllTracking

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

메서드 서명:

static void resumeAllTracking()

사용 사례:

동의 변경: 사용자가 개인정보 기본 설정을 변경하고 추적을 다시 선택함
개인정보 설정: 사용자가 앱 설정 메뉴를 통해 동의를 업데이트합니다.
지역 규정 준수: 사용자가 비규제 지역으로 이동하는 경우 추적을 다시 활성화합니다.

전체 메서드 설명서는 resumeAllTracking 참조를 참조하세요.

구현 예시

사용자가 다시 옵트인하거나 개인정보 기본 설정을 업데이트하면 추적을 재개합니다.

import 'package:singular_flutter_sdk/singular.dart';
import 'package:shared_preferences/shared_preferences.dart';

// User opted back in to tracking
Future<void> onUserResumedTracking() async {
  Singular.resumeAllTracking();
  print('Tracking resumed');

  // Update stored preference
  final prefs = await SharedPreferences.getInstance();
  await prefs.setBool('tracking_enabled', true);
}

// Handle consent update from settings
void handlePrivacySettingsChange(bool trackingEnabled) {
  if (trackingEnabled) {
    Singular.resumeAllTracking();
    print('Privacy settings: Tracking enabled');
  }
}

IsAllTrackingStopped

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

메서드 서명:

static Future<bool> isAllTrackingStopped()

반환합니다:

Future<true>: 현재 stopAllTracking()을 통해 추적이 중지되었습니다.
Future<false>: 추적이 활성 상태입니다(중지되지 않았거나 재개되지 않았습니다).

전체 메서드 문서는 isAllTrackingStopped 참조를 참조하세요.

구현 예제

추적 상태를 확인하여 UI 상태를 SDK 추적 상태와 동기화합니다.

import 'package:flutter/material.dart';
import 'package:singular_flutter_sdk/singular.dart';

class PrivacySettingsUI extends StatefulWidget {
  @override
  _PrivacySettingsUIState createState() => _PrivacySettingsUIState();
}

class _PrivacySettingsUIState extends State<PrivacySettingsUI> {
  bool trackingEnabled = false;
  String statusText = 'Checking...';

  @override
  void initState() {
    super.initState();
    updatePrivacyUI();
  }

  // Check current tracking status
  Future<bool> isTrackingEnabled() async {
    final isStopped = await Singular.isAllTrackingStopped();
    return !isStopped;
  }

  // Display privacy status in settings
  Future<String> getPrivacyStatusText() async {
    final isStopped = await Singular.isAllTrackingStopped();
    return isStopped ? 'Tracking: Disabled' : 'Tracking: Enabled';
  }

  // Sync UI with tracking state
  Future<void> updatePrivacyUI() async {
    final isStopped = await Singular.isAllTrackingStopped();
    final status = await getPrivacyStatusText();

    setState(() {
      trackingEnabled = !isStopped;
      statusText = status;
    });

    print('Current tracking state: ${isStopped ? 'Stopped' : 'Active'}');
  }

  // Handle toggle change from UI
  Future<void> onTrackingToggleChanged(bool enabled) async {
    if (enabled) {
      Singular.resumeAllTracking();
    } else {
      Singular.stopAllTracking();
    }

    await updatePrivacyUI();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Text(statusText),
        Switch(
          value: trackingEnabled,
          onChanged: onTrackingToggleChanged,
        ),
      ],
    );
  }
}

어린이 개인정보 보호

TrackingUnder13

사용자가 13세 미만인 경우 COPPA(아동 온라인 개인 정보 보호법) 및 기타 아동 개인 정보 보호 규정을 준수하기 위해 Singular에 알립니다.

방법 서명:

static void trackingUnder13()

준수 요구 사항:

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

전체 메서드 문서는 13세 미만 추적 참조를 참조하세요.

구현 예시

연령 확인을 통해 사용자가 13세 미만임을 확인한 후 즉시 trackingUnder13() 으로 전화합니다.

import 'package:flutter/material.dart';
import 'package:singular_flutter_sdk/singular.dart';
import 'package:singular_flutter_sdk/singular_config.dart';
import 'package:shared_preferences/shared_preferences.dart';

class COPPAManager extends StatefulWidget {
  @override
  _COPPAManagerState createState() => _COPPAManagerState();
}

class _COPPAManagerState extends State<COPPAManager> {
  final TextEditingController ageController = TextEditingController();

  // User identified as under 13
  Future<void> onUserUnder13() async {
    Singular.trackingUnder13();
    print('COPPA mode enabled for user under 13');

    // Store age category for app restart
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('user_age_category', 'under_13');
  }

  // Call after age verification
  Future<void> onAgeVerified(int userAge) async {
    final prefs = await SharedPreferences.getInstance();

    if (userAge < 13) {
      Singular.trackingUnder13();
      print('COPPA restrictions applied');

      // Also limit advertising identifiers
      Singular.limitDataSharing(true);

      await prefs.setString('user_age_category', 'under_13');

      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          title: Text('Child Account'),
          content: Text('Special privacy protections have been applied.'),
          actions: [
            TextButton(
              onPressed: () => Navigator.of(context).pop(),
              child: Text('OK'),
            ),
          ],
        ),
      );
    } else {
      await prefs.setString('user_age_category', 'adult');
      print('Adult account - standard tracking');
    }
  }

  void handleAgeSubmit() {
    final userAge = int.tryParse(ageController.text);

    if (userAge == null || userAge < 1 || userAge > 120) {
      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          title: Text('Invalid Age'),
          content: Text('Please enter a valid age.'),
          actions: [
            TextButton(
              onPressed: () => Navigator.of(context).pop(),
              child: Text('OK'),
            ),
          ],
        ),
      );
      return;
    }

    onAgeVerified(userAge);
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        TextField(
          controller: ageController,
          decoration: InputDecoration(
            hintText: 'Enter your age',
          ),
          keyboardType: TextInputType.number,
        ),
        ElevatedButton(
          onPressed: handleAgeSubmit,
          child: Text('Submit'),
        ),
      ],
    );
  }

  @override
  void dispose() {
    ageController.dispose();
    super.dispose();
  }
}

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

광고 식별자 제한 설정

어린이에게 서비스를 제공하는 앱의 SDK 초기화 중에 광고 식별자(Android의 경우 GAID, iOS의 경우 IDFA)의 수집 및 사용을 제한합니다.

구성 속성:

bool? limitAdvertisingIdentifiers

파라미터:

true: 제한된 광고 식별자 모드 활성화(수집 제한)
false: 제한된 광고 식별자 모드 비활성화(일반 수집)

사용 사례:

어린이 중심 앱: 주로 13세 미만의 사용자를 위해 설계된 앱
혼합 대상 앱: 성인과 어린이 모두에게 서비스를 제공하는 앱으로, SDK 초기화 전에 연령이 결정됩니다.
개인정보 보호 우선 앱: 처음부터 광고 식별자 제한을 적용합니다.

전체 구성 설명서는 limitAdvertisingIdentifiers 참조를 참조하세요.

구성 예시

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

import 'package:singular_flutter_sdk/singular.dart';
import 'package:singular_flutter_sdk/singular_config.dart';

// Limit advertising identifiers at initialization
void initializeSingular() {
  final config = SingularConfig(
    'YOUR_SDK_KEY',
    'YOUR_SDK_SECRET'
  );

  // Enable limited advertising identifiers mode
  config.limitAdvertisingIdentifiers = true;

  Singular.start(config);
  print('SDK initialized with advertising identifier restrictions');
}

결합 접근 방식: 어린이를 대상으로 하는 앱의 경우 trackingUnder13() 과 limitAdvertisingIdentifiers = true 을 결합하여 포괄적인 COPPA 준수를 보장합니다.

구현 모범 사례

완벽한 개인정보 관리 예시

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

import 'package:flutter/material.dart';
import 'package:singular_flutter_sdk/singular.dart';
import 'package:singular_flutter_sdk/singular_config.dart';
import 'package:shared_preferences/shared_preferences.dart';

const String PREF_USER_CONSENT = 'privacy_user_consent';
const String PREF_DATA_SHARING = 'privacy_data_sharing';
const String PREF_AGE_CATEGORY = 'user_age_category';

/// Initialize privacy settings on app startup based on stored preferences
Future<void> initializePrivacySettings() async {
  final hasUserConsent = await getUserConsent();
  final allowDataSharing = await getDataSharingPreference();
  final ageCategory = await getAgeCategory();

  // Apply age-based restrictions first
  if (ageCategory == 'under_13') {
    Singular.trackingUnder13();
    print('COPPA restrictions applied on startup');
  }

  // Apply stored tracking preference
  if (hasUserConsent) {
    Singular.trackingOptIn();
    Singular.resumeAllTracking();
    print('Privacy initialized: Tracking enabled with consent');
  } else {
    Singular.stopAllTracking();
    print('Privacy initialized: Tracking disabled');
  }

  // Set data sharing preference (inverse logic)
  Singular.limitDataSharing(!allowDataSharing);

  print('Privacy initialized: consent=$hasUserConsent, sharing=$allowDataSharing');
}

/// User accepts tracking via consent dialog
Future<void> onUserAcceptedTracking() async {
  await saveUserConsent(true);

  Singular.trackingOptIn();
  Singular.resumeAllTracking();

  print('User accepted tracking');
}

/// User declines tracking
Future<void> onUserDeclinedTracking() async {
  await saveUserConsent(false);

  Singular.stopAllTracking();

  print('User declined tracking');
}

/// User updates data sharing preference
Future<void> setDataSharingEnabled(bool enabled) async {
  await saveDataSharingPreference(enabled);

  // Note: limitDataSharing uses inverse logic
  // false = data sharing enabled, true = data sharing limited
  Singular.limitDataSharing(!enabled);

  print('Data sharing: ${enabled ? 'Enabled' : 'Limited'}');
}

/// Check if tracking is currently enabled
Future<bool> isTrackingEnabled() async {
  final isStopped = await Singular.isAllTrackingStopped();
  return !isStopped;
}

/// Get current privacy status as readable text
Future<String> getPrivacyStatus() async {
  final isEnabled = await isTrackingEnabled();
  final dataSharingEnabled = await getDataSharingPreference();
  final ageCategory = await getAgeCategory();

  String status = 'Tracking: ${isEnabled ? 'Enabled' : 'Disabled'}
';
  status += 'Data Sharing: ${dataSharingEnabled ? 'Enabled' : 'Limited'}';

  if (ageCategory == 'under_13') {
    status += '
COPPA: Restrictions Applied';
  }

  return status;
}

// Private helper methods for SharedPreferences

Future<bool> getUserConsent() async {
  final prefs = await SharedPreferences.getInstance();
  return prefs.getBool(PREF_USER_CONSENT) ?? false;
}

Future<void> saveUserConsent(bool consent) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setBool(PREF_USER_CONSENT, consent);
}

Future<bool> getDataSharingPreference() async {
  final prefs = await SharedPreferences.getInstance();
  return prefs.getBool(PREF_DATA_SHARING) ?? false;
}

Future<void> saveDataSharingPreference(bool enabled) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setBool(PREF_DATA_SHARING, enabled);
}

Future<String?> getAgeCategory() async {
  final prefs = await SharedPreferences.getInstance();
  return prefs.getString(PREF_AGE_CATEGORY);
}

// Flutter widget to initialize privacy on app startup
class PrivacyInitializer extends StatefulWidget {
  final Widget child;

  const PrivacyInitializer({Key? key, required this.child}) : super(key: key);

  @override
  _PrivacyInitializerState createState() => _PrivacyInitializerState();
}

class _PrivacyInitializerState extends State<PrivacyInitializer> {
  @override
  void initState() {
    super.initState();
    initializePrivacySettings();
  }

  @override
  Widget build(BuildContext context) {
    return widget.child;
  }
}

주요 구현 가이드라인

모범 사례:

영구 저장소: 공유 환경설정 또는 보안 스토리지 솔루션을 사용하여 사용자 환경설정을 저장하세요.
조기 초기화: 가능하면 SDK 초기화 전에 개인정보 보호 설정을 적용하세요.
UI 동기화: isAllTrackingStopped() 을 사용하여 설정 UI를 실제 SDK 상태와 동기화 유지
명확한 커뮤니케이션: 앱 설정에서 명확하고 접근 가능한 개인정보 보호 컨트롤 제공
역논리: limitDataSharing(false) 은 데이터 공유가 활성화되어 있음을 의미하고 true 은 제한됨을의미합니다.
COPPA 우선순위: 다른 개인정보 보호 설정보다 어린이 개인정보 보호(trackingUnder13())를 먼저 적용하세요.
규정 준수 문서: 사용자가 동의를 제공하거나 철회한 시기와 방법에 대한 기록을 유지합니다.

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

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

데이터 공유 제한

타사 데이터 공유 제어

사용 예시

GDPR 준수 방법

추적 동의 관리

TrackingOptIn

구현 예시

추적 제어 메서드

StopAllTracking

구현 예시

ResumeAllTracking

구현 예시

IsAllTrackingStopped

구현 예제

어린이 개인정보 보호

TrackingUnder13

구현 예시

광고 식별자 제한 설정

구성 예시

구현 모범 사례

완벽한 개인정보 관리 예시

주요 구현 가이드라인