事件¶
大纲¶
事件是一种检查和管理事件的功能，这些事件是 Analytics 中所有分析以及在事件下创建的属性的基础。
只需链接SDK，即可自动收集登录、购买等事件，无需任何额外开发。通过在此处直接定义和添加必要的事件，可以进行更精确的分析。
要直接发送自定义事件，请参阅发送事件。
你能做什么？¶
业务/营销经理¶
- 如果您在此屏幕上定义了分析所需的事件和属性，您可以立即将它们用作计划文档交付给开发团队。
- 通过一目了然地查看当前正在收集的事件列表，您可以立即了解可以分析哪些数据。
数据分析师¶
- 通过识别事件列表中可分析的事件和属性的整体状态，您可以快速设计分析范围。
- 您可以在分析前通过数据预览直接检查事件的实际值来验证数据质量。
开发者¶
- 您可以直接在此屏幕上查看事件名称和属性列表，以高效地进行SDK联动。
- 发送事件后，您可以通过检查数据预览中接收到的属性值来立即验证发送结果。
- 利用**ETL模拟**功能，您可以在实际部署前提前查看事件传输结果。
快速上手¶
如果这是您第一次注册活动，请按照以下步骤创建您的第一个活动。
- 单击左侧边栏上的**数据 > 事件**菜单。
- 单击右上角的**注册**按钮。
- 输入事件名称和事件描述。
- 转到属性选项卡并添加要随事件发送的属性。
- 设置属性名称、描述和数据类型。
- 单击“保存”按钮。
- 通过将事件名称和属性列表发送给开发部门来请求事件数据传输。
Note
事件属性、数据预览、ETL模拟等详细设置请参考所有功能。
全功能¶
关键概念¶
| 概念 | 描述 |
|---|---|
| 活动 | 用户在游戏中执行的特定操作（例如登录、购买、升级）的数据记录单位 |
| ㄴ自动收集活动 | 默认情况下，只需链接 SDK 即可从 Hive 收集事件 |
| ㄴ MMP 事件 | 通过 MMP 发送的事件，例如 Airbridge、AppsFlyer、Adjust 等 |
| ㄴ 自定义事件 | 您自己定义和发送的自定义事件 |
| 属性 | 事件发生时一起记录的详细数据项 |
| ㄴ 自动收集属性 | 默认情况下，仅通过链接 SDK 从 Hive 收集的属性（例如国家/地区、市场、服务器 ID、OS 等） |
| ㄴ 自定义属性 | 您直接随事件发送的属性（例如购买事件中的商品 ID、金额、货币单位） |
事件列表查询¶
检查在 Analytics 中以列表形式注册的所有事件。 
过滤器和搜索¶
| 选项 | 描述 |
|---|---|
| 事件类型 | 按事件类型过滤列表（自定义事件、AppsFlyer、Airbridge 等） |
| 事件名称/生成器搜索 | 选择搜索条件（活动名称或创建者）并输入搜索词来搜索活动 |
| 仅显示活动事件 | 切换 ON 以仅显示已启用的事件 |
列表列¶
| 专栏 | 描述 |
|---|---|
| 数量 | 活动报名号 |
| 事件类型 | 自定义 / AppsFlyer / Airbridge 等 事件源 |
| 活动名称 | 活动名称。点击进入详情页 |
| 描述 | 注册活动时输入的描述 |
| 创建日期 | 首次注册活动的日期和时间 |
| 发电机 | 注册事件的帐户。系统自动生成的事件标记为 system |
| 最后数据输入日期 | 上次收集此事件数据的日期和时间。每10分钟同步一次，如果没有采集历史则显示为- |
| 使用或不使用 | 切换以控制事件激活/停用。当选择 OFF 处的事件时，它会从列表中隐藏 |
活动报名¶
点击活动列表界面右上角的**注册**按钮，进入活动注册页面。 
| 项目 | 必填 | 描述 |
|---|---|---|
| 活动名称 | 必填 | 传输实际数据时使用的唯一代码 |
| 描述 | 选择 | 事件发生条件及目的描述 |
Note
有关 Analytics 推荐的事件命名约定，请参阅事件发送。
查看活动详情¶
【基本信息】选项卡¶
检查并编辑已注册事件的事件名称和描述。 
[属性] 选项卡¶
定义随每个事件发送的属性。 
| 项目 | 描述 |
|---|---|
| 属性名称 | 实际传输使用的代码 |
| 描述 | 属性值含义及示例 |
| 数据类型 | 从字母/数字/日期类型中选择 1 |
数据类型描述¶
| 类型 | 描述 | 示例 |
|---|---|---|
| 文字 | 字符串值 | 国家/地区代码 (KR)、商品名称 (sword) |
| 数量 | 整数或小数值 | 级别 (50)、付款金额 (9.99) |
| 日期 | 日期/时间值 | 事件发生时间 (2026-03-29T10:00:00) |
货币属性/金额属性¶
事件中注册的属性中，可以在系统中指定包含货币值和销售额的属性。设置后，您可以在图表中查看所需货币的销售数据。
| 项目 | 描述 |
|---|---|
| 货币属性 | 指定包含货币代码值的属性（例如包含货币单位的属性，例如 KRW、USD 等） |
| 金额属性 | 指定包含要在销售计算中使用的数字的属性（例如包含付款金额的属性） |
Note
货币属性和金额属性可以在活动详情页面的[属性]选项卡中设置。从属性列表中选择相关属性，然后指定每个项目。
Warning
如果未指定货币属性或金额属性，则无法在图表中以货币形式查看与销售相关的指标。如果要使用购买事件进行分析，则必须指定这两个属性。
[数据预览] 选项卡¶
查看 Analytics 实际收集的事件数据示例。它用于验证事件是否正确传输以及属性值是否按预期收集。
搜索条件¶
| 项目 | 描述 |
|---|---|
| 查询期 | 选择查看数据的日期范围。开始日期和结束日期的范围最多限制为一个月。 |
| 字段名称 | 选择要应用过滤器的属性（字段）。 |
| 条件 | 选择要应用于所选字段的比较标准。 |
| 搜索 | 输入用于条件的值。 |
| 重置 | 重置所有设置的过滤条件。 |
Warning
如果查询周期范围超过1个月，则无法查看数据。请缩短时间并再次检查。
[源创建] 选项卡¶
它会自动生成源代码以将事件发送到 Analytics。开发人员可以使用在此选项卡中创建的源传输数据，而无需编写单独的代码。 
| 选项卡 | 描述 |
|---|---|
| 客户端开发人员 | 提供游戏客户端发送事件的源码 |
| 服务器开发人员 | 提供从游戏服务器发送事件的源代码 |
| 文件 | 提供事件集合表架构的参考文档 |
[ETL 模拟] 选项卡¶
事件传输测试的模拟功能。
- 在每个事件收集表字段中输入适当的数据。
- 单击**发送**按钮。
- 在【数据预览】选项卡中，查看是否接收到事件以及属性解析结果。
Warning
在appId字段中，您必须输入在Hive控制台>应用中心注册的应用ID。输入不正确的值可能会导致数据无法收集。
控制事件显示¶
- 通过在事件列表中切换**启用/禁用**来设置是否公开每个事件。 - 如果设置为 OFF，则事件将从分析屏幕（例如图表/渠道/保留）的选择列表中隐藏。 - 数据将继续收集，但在分析UI中不可见。
复制并删除事件¶
- 复制：根据现有事件快速创建类似事件
- 删除：删除不再使用的事件
Warning
如果您的图表/指标正在使用已删除的事件，则它们的内容可能会受到影响。
注意事项 & Tips¶
- 如果发布后事件名称发生更改，可能会与之前的数据不一致。仔细选择您的活动名称。
- 如果属性类型设置错误，可能会出现数据聚合错误。
- 要利用 MMP 事件，您必须首先在 数据 > 链接 菜单中设置 MMP 链接。
- 使用显示OFF 处理未使用的事件，以整理分析UI。
- 随着事件数量的增加，编写名称和描述明显提高了整个团队的分析效率。