用途:在 Unity 项目中集成或修改 Wardx,使用 com.wardx.sdk、WardxClient 或 WardxBehaviour,覆盖遥测、Remote Config、实验分组与留存。非 Unity 应用应使用 wardx-csharp,目录、实验定义与 MCP 操作使用 wardx-server。
主要能力:提供 Counter、Gauge、Histogram、Distinct、Timer、Event、Log、RetentionActivity 等信号;Config.Get 读取本地快照;Experiment.Goal 上报实验目标;支持 Identify 设置默认实验对象。
使用方式:从指定 Git 修订或磁盘安装 com.wardx.sdk;在 Unity 主线程创建客户端,或使用 WardxBehaviour。启用时 WardxOptions 必填 Endpoint、ProjectKey、Project、Role、AppVersion、Environment、PrivacySalt;AppVersion 留空时使用 Application.version。Project 须匹配凭据的服务端映射,Role 为除 * 外的开放名称,PrivacySalt 在同一项目内保持稳定。指标句柄按客户端与稳定名称/维度组合创建一次并复用;维度使用低基数取值,禁止用用户 ID、邮箱或唯一交易 ID。
适用场景:Unity 播放器内的遥测采集、远程配置读取、A/B 实验分组与目标上报、留存活动统计。
限制:测量为同步内存更新,非网络调用;投递为至多一次,失败批次丢弃,无磁盘队列或重试,无损数据需另用机制。Distinct 发送加盐 HLL 草图而非标识符;漏斗按命名步骤比较,不追踪唯一用户旅程。Config.Get 无网络 I/O,缺失键返回调用方回退值。无实验对象时 Goal 抛异常。FlushAsync 即使无待发帧也同步且不停止调度;ShutdownAsync 停止调度并尝试最终刷新;Stop 不保证末帧投递。不要在主线程用 .Wait() 或 .Result 阻塞 HTTP。追踪不发送到服务器。具体收费、价格与平台支持暂未提供。