文件

遵守数据隐私法

通过通知 Singular 用户同意 GDPR、CCPA 和其他消费者隐私法规的选择，实施符合隐私法规的数据收集。

当用户同意或拒绝与第三方共享其信息时，使用 Singular 的隐私方法来传达他们的选择。这将确保遵守《加州消费者隐私法案》（CCPA）等法规，并使合作伙伴尊重用户的隐私偏好。

了解更多信息：有关Singular如何处理隐私同意的详细信息，请参阅用户隐私和限制数据共享。

限制数据共享

控制第三方数据共享

通知Singular用户是否同意使用limitDataSharing方法与第三方合作伙伴共享个人数据。

方法签名：

+ (void)limitDataSharing:(BOOL)shouldLimitDataSharing;

参数：

否（假）：用户已选择并同意共享其数据
YES（真）：用户已退出，不同意共享其数据

重要提示：虽然此方法是可选的，但它会影响属性数据的共享。有些合作伙伴只有在明确通知用户已选择加入时，才会共享完整的归因信息。

使用示例

// 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
func handlePrivacyConsent(userConsented: Bool) {
    // Pass inverse: false = opted in, true = opted out
    Singular.limitDataSharing(!userConsented)
    
    print("Data sharing: \(userConsented ? "Enabled" : "Limited")")
}

// User has opted in to share their data
[Singular limitDataSharing:NO];

// User has opted out and declined to share their data
[Singular limitDataSharing:YES];

// Example: Set based on user preference
- (void)handlePrivacyConsent:(BOOL)userConsented {
    // Pass inverse: NO = opted in, YES = opted out
    [Singular limitDataSharing:!userConsented];
    
    NSLog(@"Data sharing: %@", userConsented ? @"Enabled" : @"Limited");
}

如何使用：

Singular 在用户隐私回邮中使用此设置，并将其传递给需要遵守法规的合作伙伴。

GDPR 合规方法

管理用户跟踪同意和控制SDK功能，以符合GDPR（通用数据保护条例）和其他隐私法规。

跟踪同意管理

跟踪同意

通过向 Singular 服务器发送 GDPR 选入事件，记录用户对跟踪的明确同意。

方法签名：

+ (void)trackingOptIn;

何时使用：

GDPR 合规性：当用户明确同意在受 GDPR 监管的地区进行跟踪时调用
同意记录：在 Singular 系统中将用户标记为已提供 GDPR 同意
默认行为：如果没有此调用，SDK 会继续跟踪，但不会明确记录同意信息

// User accepted tracking consent
Singular.trackingOptIn()

// Example: Call after consent dialog
func onUserAcceptedTracking() {
    Singular.trackingOptIn()
    print("User opted in to tracking")
}

// User accepted tracking consent
[Singular trackingOptIn];

// Example: Call after consent dialog
- (void)onUserAcceptedTracking {
    [Singular trackingOptIn];
    NSLog(@"User opted in to tracking");
}

跟踪控制方法

停止所有跟踪

完全禁用当前用户在此设备上的所有 SDK 跟踪活动。

方法签名：

+ (void)stopAllTracking;

严重警告：此方法会永久禁用 SDK，直到调用resumeAllTracking 。禁用状态会在应用程序重启时持续存在，只能通过编程方式逆转。

行为：

立即生效：立即停止所有跟踪、事件报告和数据收集功能
持续状态：即使在应用程序关闭和重新打开后也会保持禁用状态
无法自动重置：必须明确调用resumeAllTracking 才能重新启用

// User declined all tracking
Singular.stopAllTracking()

// Example: Handle user opt-out
func onUserDeclinedTracking() {
    Singular.stopAllTracking()
    print("All tracking stopped")
    
    // Optionally store preference
    saveUserTrackingPreference(false)
}

// User declined all tracking
[Singular stopAllTracking];

// Example: Handle user opt-out
- (void)onUserDeclinedTracking {
    [Singular stopAllTracking];
    NSLog(@"All tracking stopped");
    
    // Optionally store preference
    [self saveUserTrackingPreference:NO];
}

恢复所有跟踪

在使用stopAllTracking 停止跟踪后重新启用跟踪。

方法签名：

+ (void)resumeAllTracking;

使用案例：

同意更改：用户更改隐私偏好并选择恢复跟踪
隐私设置：用户通过应用程序设置菜单更新同意
地区合规性：当用户移动到非监管区域时，重新启用追踪功能

// User opted back in to tracking
Singular.resumeAllTracking()

// Example: Handle consent update
func onUserResumedTracking() {
    Singular.resumeAllTracking()
    print("Tracking resumed")
    
    // Optionally update stored preference
    saveUserTrackingPreference(true)
}

// User opted back in to tracking
[Singular resumeAllTracking];

// Example: Handle consent update
- (void)onUserResumedTracking {
    [Singular resumeAllTracking];
    NSLog(@"Tracking resumed");
    
    // Optionally update stored preference
    [self saveUserTrackingPreference:YES];
}

是否已停止所有跟踪

检查当前用户是否已禁用跟踪功能。

方法签名：

+ (BOOL)isAllTrackingStopped;

返回返回返回返回值值值值

是（true）：当前已通过stopAllTracking停止跟踪
否（false）：跟踪处于活动状态（从未停止或恢复

// Check current tracking status
let isTrackingStopped = Singular.isAllTrackingStopped()

// Example: Display privacy status in settings
func getPrivacyStatusText() -> String {
    return Singular.isAllTrackingStopped() ? "Tracking: Disabled" : "Tracking: Enabled"
}

// Example: Sync UI with tracking state
func updatePrivacyToggle() {
    let isStopped = Singular.isAllTrackingStopped()
    privacyToggle.isOn = !isStopped
    print("Current tracking state: \(isStopped ? "Stopped" : "Active")")
}

// Check current tracking status
BOOL isTrackingStopped = [Singular isAllTrackingStopped];

// Example: Display privacy status in settings
- (NSString *)getPrivacyStatusText {
    return [Singular isAllTrackingStopped] ? @"Tracking: Disabled" : @"Tracking: Enabled";
}

// Example: Sync UI with tracking state
- (void)updatePrivacyToggle {
    BOOL isStopped = [Singular isAllTrackingStopped];
    self.privacyToggle.on = !isStopped;
    NSLog(@"Current tracking state: %@", isStopped ? @"Stopped" : @"Active");
}

儿童隐私保护

trackingUnder13

通知Singular用户未满13岁，以遵守COPPA（儿童在线隐私保护法案）和其他儿童隐私法规。

方法签名：

+ (void)trackingUnder13;

合规要求：

COPPA 合规性：在美国收集 13 岁以下儿童数据的应用程序必须遵守
有年龄限制的内容：当用户在注册或年龄验证时表明自己未满 13 岁时使用
限制跟踪：限制数据收集，以遵守儿童隐私保护法

// User identified as under 13
Singular.trackingUnder13()

// Example: Call after age verification
func onAgeVerified(userAge: Int) {
    if userAge < 13 {
        Singular.trackingUnder13()
        print("COPPA mode enabled for user under 13")
    }
}

// User identified as under 13
[Singular trackingUnder13];

// Example: Call after age verification
- (void)onAgeVerified:(int)userAge {
    if (userAge < 13) {
        [Singular trackingUnder13];
        NSLog(@"COPPA mode enabled for user under 13");
    }
}

重要提示：在确定用户未满 13 周岁后尽早调用此方法，最好是在应用程序初始化期间或年龄验证后立即调用。这样可以确保所有后续跟踪都遵守儿童隐私保护法规。

限制广告标识符

在混合受众应用程序的 SDK 初始化过程中，限制广告标识符（iOS 上为 IDFA）的收集和使用。

配置属性：

@property (assign) BOOL limitAdvertisingIdentifiers;

使用案例：

混合受众应用程序：同时为成人和儿童服务的应用程序，其年龄在应用程序启动前确定
已知 COPPA 用户：在初始化时就知道用户未满 13 岁的情况
隐私优先方法：从第一个 SDK 会话开始应用广告标识符限制

配置方法

在 SDK 初始化期间为预先知道隐私要求的应用程序设置广告标识符限制。

// Limit advertising identifiers at initialization
let config = SingularConfig(apiKey: "SDK_KEY", andSecret: "SDK_SECRET")
config?.limitAdvertisingIdentifiers = true

Singular.start(config)

// Limit advertising identifiers at initialization
SingularConfig *config = [[SingularConfig alloc] 
    initWithApiKey:@"SDK_KEY" 
    andSecret:@"SDK_SECRET"];
config.limitAdvertisingIdentifiers = YES;

[Singular start:config];

最佳实践：为全面遵守 COPPA，在初始化过程中同时使用limitAdvertisingIdentifiers ，并在验证用户年龄后调用trackingUnder13() 。这样可确保从第一个会话开始提供全面保护。

实施最佳实践

完整隐私管理示例

实施全面的隐私控制，尊重用户偏好并遵守相关法规。

import Foundation

class PrivacyManager {
    
    private let userDefaults = UserDefaults.standard
    private let consentKey = "user_consent"
    private let dataSharingKey = "data_sharing"
    
    // Initialize privacy settings on app start
    func initializePrivacy() {
        let hasUserConsent = getUserConsent()
        let allowDataSharing = getDataSharingPreference()
        
        // Apply stored preferences
        if hasUserConsent {
            Singular.trackingOptIn()
            Singular.resumeAllTracking()
        } else {
            Singular.stopAllTracking()
        }
        
        // Set data sharing preference
        Singular.limitDataSharing(!allowDataSharing)
        
        print("Privacy initialized: consent=\(hasUserConsent), sharing=\(allowDataSharing)")
    }
    
    // User accepts tracking via consent dialog
    func userAcceptedTracking() {
        saveUserConsent(true)
        Singular.trackingOptIn()
        Singular.resumeAllTracking()
        print("User accepted tracking")
    }
    
    // User declines tracking
    func userDeclinedTracking() {
        saveUserConsent(false)
        Singular.stopAllTracking()
        print("User declined tracking")
    }
    
    // User updates data sharing preference
    func setDataSharingEnabled(_ enabled: Bool) {
        saveDataSharingPreference(enabled)
        // Note: limitDataSharing uses inverse logic
        Singular.limitDataSharing(!enabled)
        print("Data sharing: \(enabled ? "Enabled" : "Limited")")
    }
    
    // Get current tracking status
    func isTrackingEnabled() -> Bool {
        return !Singular.isAllTrackingStopped()
    }
    
    // Private helper methods
    private func getUserConsent() -> Bool {
        return userDefaults.bool(forKey: consentKey)
    }
    
    private func saveUserConsent(_ consent: Bool) {
        userDefaults.set(consent, forKey: consentKey)
    }
    
    private func getDataSharingPreference() -> Bool {
        return userDefaults.bool(forKey: dataSharingKey)
    }
    
    private func saveDataSharingPreference(_ enabled: Bool) {
        userDefaults.set(enabled, forKey: dataSharingKey)
    }
}

#import <Foundation/Foundation.h>
#import <Singular/Singular.h>

@interface PrivacyManager : NSObject

- (void)initializePrivacy;
- (void)userAcceptedTracking;
- (void)userDeclinedTracking;
- (void)setDataSharingEnabled:(BOOL)enabled;
- (BOOL)isTrackingEnabled;

@end

@implementation PrivacyManager

static NSString *const kConsentKey = @"user_consent";
static NSString *const kDataSharingKey = @"data_sharing";

// Initialize privacy settings on app start
- (void)initializePrivacy {
    BOOL hasUserConsent = [self getUserConsent];
    BOOL allowDataSharing = [self getDataSharingPreference];
    
    // Apply stored preferences
    if (hasUserConsent) {
        [Singular trackingOptIn];
        [Singular resumeAllTracking];
    } else {
        [Singular stopAllTracking];
    }
    
    // Set data sharing preference
    [Singular limitDataSharing:!allowDataSharing];
    
    NSLog(@"Privacy initialized: consent=%d, sharing=%d", hasUserConsent, allowDataSharing);
}

// User accepts tracking via consent dialog
- (void)userAcceptedTracking {
    [self saveUserConsent:YES];
    [Singular trackingOptIn];
    [Singular resumeAllTracking];
    NSLog(@"User accepted tracking");
}

// User declines tracking
- (void)userDeclinedTracking {
    [self saveUserConsent:NO];
    [Singular stopAllTracking];
    NSLog(@"User declined tracking");
}

// User updates data sharing preference
- (void)setDataSharingEnabled:(BOOL)enabled {
    [self saveDataSharingPreference:enabled];
    // Note: limitDataSharing uses inverse logic
    [Singular limitDataSharing:!enabled];
    NSLog(@"Data sharing: %@", enabled ? @"Enabled" : @"Limited");
}

// Get current tracking status
- (BOOL)isTrackingEnabled {
    return ![Singular isAllTrackingStopped];
}

// Private helper methods
- (BOOL)getUserConsent {
    return [[NSUserDefaults standardUserDefaults] boolForKey:kConsentKey];
}

- (void)saveUserConsent:(BOOL)consent {
    [[NSUserDefaults standardUserDefaults] setBool:consent forKey:kConsentKey];
}

- (BOOL)getDataSharingPreference {
    return [[NSUserDefaults standardUserDefaults] boolForKey:kDataSharingKey];
}

- (void)saveDataSharingPreference:(BOOL)enabled {
    [[NSUserDefaults standardUserDefaults] setBool:enabled forKey:kDataSharingKey];
}

@end

最佳实践：

持久存储：将用户偏好保存在 UserDefaults 或安全存储中
尽早初始化：尽可能在 SDK 初始化前应用隐私设置
UI 同步：使用isAllTrackingStopped保持设置 UI 与实际 SDK 状态同步
清晰沟通：在应用程序设置中提供清晰、易用的隐私控件
合规文档：保持清晰的隐私实施记录，以备监管审核

iOS SDK - 数据隐私

遵守数据隐私法

限制数据共享

控制第三方数据共享

使用示例

GDPR 合规方法

跟踪同意管理

跟踪同意

跟踪控制方法

停止所有跟踪

恢复所有跟踪

是否已停止所有跟踪

儿童隐私保护

trackingUnder13

限制广告标识符

配置方法

实施最佳实践

完整隐私管理示例