客户端 SDK
用户属性
设置与管理用户属性，用于分群与数据丰富
Version:
用户属性（User Properties）是附加在所有 SDK 请求上的键值对。你可以用它们来给用户分群，并丰富分析维度。
白名单属性（Whitelisted Properties）
标准属性：会被发送到 AudienceLab 后端并被存储。
// 设置属性
AudiencelabSDK.SetUserProperty("subscription_tier", "premium");
AudiencelabSDK.SetUserProperty("player_level", 42);
AudiencelabSDK.SetUserProperty("country", "US");
AudiencelabSDK.SetUserProperty("is_vip", true);
// 删除某个属性
AudiencelabSDK.UnsetUserProperty("subscription_tier");
// 清空所有白名单属性
AudiencelabSDK.ClearUserProperties();黑名单属性（Blacklisted Properties）
敏感属性：会随请求发送，但不会被存储。适用于广告网络需要的匹配数据（例如用于匹配的哈希标识符）。
平台支持
对于 TikTok 和 Meta，支持 email 与 phone 两个属性。值必须是哈希后的结果。
// 设置黑名单属性（用于广告网络匹配）
AudiencelabSDK.SetUserProperty("email", "sha256_hash_here", blacklisted: true);
AudiencelabSDK.SetUserProperty("phone", "sha256_hash_here", blacklisted: true);
// 删除黑名单属性
AudiencelabSDK.UnsetUserProperty("email", blacklisted: true);
// 清空所有属性（包含黑名单）
AudiencelabSDK.ClearUserProperties(includeBlacklisted: true);约束限制
| 约束项 | 限制 |
|---|---|
| 每个集合的最大属性数 | 50 |
| key 最大长度 | 64 字符 |
| string value 最大长度 | 256 字符 |
| 序列化后的最大大小 | 2,048 bytes |
保留 key
以 _（下划线）开头的属性 key 为后端保留，SDK 侧不能设置。AudienceLab 会用这些 key 附加服务端属性（例如归因数据）。
最佳实践
- 尽早设置属性（例如用户登录后）
- 用户状态变化时及时更新属性
- 黑名单属性仅用于 PII 的哈希值