客户端 SDK

隐私控制

允许用户选择退出数据采集

Version:

SDK 提供了客户在实施隐私偏好时可以使用的控制能力。该控制只是合规实施的一部分,本身并不能决定正确的同意、披露、保留期限或法律依据。

开关数据采集

允许用户选择退出分析数据采集:

// 关闭数据采集
AudiencelabSDK.ToggleMetricsCollection(false);

// 重新开启数据采集
AudiencelabSDK.ToggleMetricsCollection(true);

// 查询当前状态
bool isEnabled = AudiencelabSDK.GetIsMetricsCollection();

关闭时的行为

当数据采集被关闭时:

  • 事件会被直接丢弃(不会发送)
  • 不会向 Audiencelab 服务器发起任何网络请求
  • 重新开启后,事件会按正常流程发送

示例实现

// 在你的设置界面中
public void OnPrivacyToggleChanged(bool isEnabled)
{
    AudiencelabSDK.ToggleMetricsCollection(isEnabled);

    // 保存用户偏好
    PlayerPrefs.SetInt("AnalyticsEnabled", isEnabled ? 1 : 0);
    PlayerPrefs.Save();
}

// 应用启动时恢复用户偏好
void Start()
{
    bool analyticsEnabled = PlayerPrefs.GetInt("AnalyticsEnabled", 1) == 1;
    AudiencelabSDK.ToggleMetricsCollection(analyticsEnabled);
}

“使用理由必填”API 的归属

此宿主项目示例使用 Unity PlayerPrefs 保存偏好。Audiencelab SDK 本身不直接调用 Apple UserDefaults 或其他“使用理由必填”API。PlayerPrefs 是 Unity 的抽象;底层 UserDefaults 访问由 Unity 负责,Unity Engine 的隐私清单会提供对应声明。因此,Audiencelab SDK 本身不需要 增加“使用理由必填”API 声明。客户代码和其他嵌入式 SDK 仍需单独审查。