工作原理
从一句提示到实时仪表板
接入数据分析通常要选择服务、创建项目、复制密钥并集成 SDK。Ziva 会在 Godot 编辑器里替你完成这些步骤。
- 01
告诉 Ziva
说出你想了解什么，例如：“为我的游戏添加数据分析。追踪玩家收集金币或通过第一关的时刻。”
- 02
Ziva 安装 SDK
它会在你的 Ziva 账户中创建分析项目，添加 ZivaAnalytics 自动加载，并把设置保存到 project.godot。然后为你的事件添加追踪调用。
- 03
运行并检查
运行游戏，然后让 Ziva 检查数据分析（“check analytics”），确认事件已送达。事件通常会在 5-15 秒内出现在仪表板上。
ZivaAnalytics.track("level_complete", {"level": 3, "time_s": 41.2})
ZivaAnalytics.identify("Bobby")仪表板
看清谁在玩、玩了什么
在 Ziva 中通过 Settings → Pro Features → Game Analytics 打开，或在 ziva.sh 上通过 Account → Analytics 打开。
当前在线玩家
最近 2 分钟的活跃会话、今日每日活跃玩家，以及所选时间范围内的独立玩家数。
活动趋势
最近 1 小时、24 小时、7 天或 30 天的事件数量，以及最近 30 天的每日活跃玩家。
热门事件
所选时间范围内最常见的事件，方便比较每一关被开始和通关的次数。
实时事件流
显示最新事件，每隔几秒刷新一次，可按事件名称、玩家名称或事件详情搜索。
玩家查询
按名称或 ID 查找玩家并查看其事件。只有当游戏提供玩家名称时才会显示名称。
排除测试运行
按来源筛选，只看导出的构建，排除你自己在编辑器中的运行和 Ziva 的测试运行，避免测试数据干扰统计。
自动追踪
无需添加任何事件，就能获得有用数据
SDK 安装后，无需额外代码即可记录以下事件：
- session_start
- 游戏启动时记录，包含 Godot 版本和语言区域。
- scene_changed
- 当前场景切换时记录，包含场景名称。
- heartbeat
- 每 60 秒记录一次，包含目前的游玩时长。
- session_end
- 窗口关闭时尽力记录，包含总游玩时长。
每个事件还包含会话 ID、随机玩家 ID、平台，以及已设置时的游戏版本。
数据分析可在编辑器、Ziva 游戏测试以及导出的游戏（包括 Web 构建）中运行。SDK 在后台发送事件，不会阻塞游戏。如果服务器拒绝事件，只会在本次会话中关闭数据分析，而不会让游戏停止。
与其他工具对比
比独立的分析插件设置更少
专业数据分析服务提供更深入的报告。Ziva Analytics 面向希望直接获得答案、不想自己搭建数据管道的 Godot 开发者。
| 功能 | 独立分析插件 | Ziva Analytics |
|---|---|---|
| 自动创建项目和密钥 | 注册并复制密钥 | 一句提示 |
| 为你的事件编写追踪代码 | 每个调用都要自己写 | 用日常语言提出需求 |
| 检查事件是否送达 | 打开仪表板自己查看 | 让 Ziva 检查 |
| 区分测试运行和导出的构建 | 因服务而异 | 编辑器、代理和玩家来源 |
| 漏斗、同期群和留存报告 | 通常提供 | 实时事件流、每日玩家和热门事件 |
| 免费方案 | 通常提供 | 需要 Pro |
隐私与限制
会发送哪些数据
- 数据分析会发送事件、基本游戏信息、随机玩家 ID，以及游戏提供的事件详情或玩家名称。
- SDK 不会读取硬件标识符、IP 地理位置或文件路径。除非游戏的隐私政策已涵盖，否则不要包含个人数据。
- 保存在项目中的密钥只能向你的项目添加事件，无法读取任何数据，因此可以安全地随导出版本发布。
- 原始事件保留 90 天。