事件¶
概要¶
事件是用于查看和管理 Analytics 所有分析基础的事件及其下创建的属性的功能。
仅通过集成 SDK，就会自动收集 50 种以上无需额外开发的事件，例如登录、购买、安装等。在此基础上，直接定义并添加所需事件后，可进行更精细的分析。
若要直接发送自定义事件，请参考 事件设计与发送指南。
可以做什么？¶
业务/营销负责人¶
- 如果在此页面定义分析所需的事件和属性，可以直接作为提供给开发团队的需求文档。
- 一眼掌握当前正在收集的事件列表后，可以立即确认可用哪些数据进行分析。
数据分析师¶
- 从事件列表中掌握可分析事件和属性的整体状况后，可以快速设计分析范围。
- 通过数据预览直接查看事件实际值，可在分析前验证数据质量。
开发者¶
- 可在此页面直接确认事件名和属性列表，高效推进 SDK 集成工作。
- 事件发送后，在 数据预览 中确认接收到的属性值，可立即验证发送结果。
- 利用 ETL 模拟 功能，可以在实际发布前预先确认事件发送结果。
快速开始¶
首次注册事件时，请按以下步骤创建第一个事件。
- 在左侧侧边栏点击 数据 > 事件 菜单。
- 点击右上角 注册 按钮。
- 输入事件名和事件说明。
- 移动到 属性选项卡，添加要随事件一起发送的属性。
- 设置属性名、说明和数据类型。
- 点击 保存 按钮。
- 向开发部门传达事件名和属性列表，请求发送事件数据。
Note
有关事件属性·数据预览·ETL 模拟等详细设置，请参考 全部功能。
全部功能¶
主要概念¶
| 概念 | 说明 |
|---|---|
| 事件 | 用户在游戏中执行的特定行为的数据记录单元（例如：登录、购买、升级） |
| 平台事件 | 仅通过 SDK 集成即可由 Hive 默认收集的事件 |
| MMP 事件 | 通过 Airbridge、AppsFlyer、Adjust 等 MMP 发送的事件 |
| 自定义事件 | 自行定义并发送的自定义事件 |
| 属性 | 事件分类结构中附属于事件的详细数据项。区分为平台属性和事件属性 |
| 平台属性 | 仅通过 SDK 集成即可由 Hive 默认收集的属性（例如：国家、市场、服务器 ID、OS 等） |
| 事件属性 | 与事件一起发送的属性（例如：购买事件的道具 ID、金额、货币单位） |
事件列表查看¶
以列表形式查看注册到 Analytics 的所有事件。 
筛选与搜索¶
| 选项 | 说明 |
|---|---|
| 事件类型 | 按事件类型（自定义事件、AppsFlyer、Airbridge 等）筛选列表 |
| 事件名/创建者搜索 | 先选择搜索基准（事件名或创建者），再输入搜索词进行事件搜索 |
| 仅显示正在使用的事件 | 开启开关时，仅显示正在被使用的事件 |
列表列项¶
| 列名 | 说明 |
|---|---|
| 编号 | 事件注册顺序 |
| 事件类型 | 自定义 / AppsFlyer / Airbridge 等事件来源 |
| 事件名 | 事件名称。点击后跳转到详情页面 |
| 说明 | 注册事件时输入的说明 |
| 创建日 | 事件首次注册的时间 |
| 创建者 | 注册该事件的账号。系统自动创建的事件显示为 system |
| 数据最后输入日 | 该事件的数据最后一次被收集的时间。按 10 分钟同步；若无收集记录则显示为 - |
| 是否使用 | 通过开关控制事件启用/停用。关闭时，该事件会在图表/漏斗/留存等分析页面的选择列表中隐藏 |
事件注册¶
点击事件列表页面右上角的 注册 按钮，会进入事件注册页面。 
| 项目 | 是否必填 | 说明 |
|---|---|---|
| 事件名 | 必填 | 实际发送数据时使用的唯一代码 |
| 说明 | 可选 | 说明事件的发生条件和目的 |
Note
Analytics 推荐的事件名命名规则请参考 事件设计与发送指南。
事件详情查看¶
[基本信息] 选项卡¶
查看并修改已注册事件的事件名和说明。 
[属性] 选项卡¶
定义每个事件一起发送的属性。 
| 项目 | 说明 |
|---|---|
| 属性名 | 实际发送时使用的代码 |
| 说明 | 属性值的含义和示例 |
| 数据类型 | 字符串 / 数字 / 日期类型三选一 |
数据类型说明¶
| 类型 | 说明 | 示例 |
|---|---|---|
| 字符串 | 文本值 | 国家代码(KR)、道具名(sword) |
| 数字 | 整数或小数值 | 等级(50)、支付金额(9.99) |
| 日期 | 日期/时间值 | 事件发生时间(2026-03-29T10:00:00) |
货币属性 / 金额属性¶
可以在事件中将包含 货币值 和 收入金额 的属性指定到系统中。只有完成此设置，才能在 图表 中按所需货币基准查看收入数值。
| 项目 | 说明 |
|---|---|
| 货币属性 | 指定包含货币代码值的属性（例如：包含 KRW、USD 等货币单位的属性） |
| 金额属性 | 指定用于收入计算的数值属性（例如：包含支付金额的属性） |
Note
货币属性和金额属性可在事件详情页面的 [属性] 选项卡中设置。请在属性列表中选择相应属性后，为各项分别指定。
Warning
如果未指定货币属性或金额属性，就无法在图表中按货币基准查看收入相关指标。若要分析购买事件，请务必同时指定这两个属性。
[数据预览] 选项卡¶
查看实际由 Analytics 收集的事件数据样本。可用于验证事件是否正确发送、属性值是否按预期收集。
查询条件¶
| 项目 | 说明 |
|---|---|
| 查询期间 | 选择要查询数据的日期范围。开始日期和结束日期的范围最多限制为 1 个月。 |
| 字段名 | 选择要应用筛选器的属性（字段）。 |
| 条件 | 选择要应用到所选字段的比较条件。 |
| 搜索 | 输入条件使用的值。 |
| 重置 | 清除所有已设置的筛选条件。 |
Warning
如果查询期间超过 1 个月，则无法查询数据。请缩短期间后重新查询。
[源生成] 选项卡¶
自动生成将该事件发送到 Analytics 所需的源代码。开发者无需单独编写代码，也可以直接使用此选项卡生成的源发送数据。 
| 选项卡 | 说明 |
|---|---|
| 客户端开发者 | 提供在游戏客户端中发送事件的源代码 |
| 服务器开发者 | 提供在游戏服务器中发送事件的源代码 |
| 文档 | 提供事件收集表 schema 的参考文档 |
[ETL 模拟] 选项卡¶
用于事件发送测试的模拟功能。
- 为各事件收集表字段输入适当的数据。
- 点击 发送 按钮。
- 在 [数据预览] 选项卡中确认事件是否接收以及属性解析结果。
Warning
appId 字段中必须输入Hive 控制台 > App Center 中注册的应用 ID。输入错误值可能导致数据无法收集。
事件显示控制¶
- 通过事件列表中的 是否使用 开关设置每个事件的显示状态。 - 设置为 OFF 后，该事件会在图表/漏斗/留存等分析画面的选择列表中隐藏。 - 数据仍会继续收集，但不会在分析 UI 中显示。
事件复制与删除¶
- 复制：基于现有事件快速创建相似事件
- 删除：删除不再使用的事件
Warning
如果有图表/指标正在使用已删除事件，则对应内容可能会受到影响。
注意事项 & Tips¶
- 事件名在发布后如果更改，会与历史数据产生不一致。请谨慎决定事件名。
- 若属性类型设置错误，可能导致数据汇总错误。
- 若要使用 MMP 事件，需要先在 数据 > 集成 菜单中完成相应的 MMP 集成设置。
- 不再使用的事件请设为 显示 OFF，以保持分析 UI 整洁。
- 当事件数量变多时，清晰地编写名称和说明有助于提升团队整体分析效率。