添加事件

本节将详细介绍如何在灵镜引擎中添加和管理事件。事件是数据分析的基础，通过定义事件可以跟踪用户在应用中的各种行为和操作。

访问事件管理页面

1. 登录系统后，在左侧导航栏中找到"数据管理"选项
2. 点击"数据管理"，展开子菜单
3. 选择"事件管理"，进入事件管理页面
   • 直接访问：https://data.lingame.cn/project/{项目链接}/dataManage/eventEdit

在事件管理页面，您可以看到：

• 当前项目的所有事件列表
• 每个事件的基本信息（事件名称、事件代码、描述、创建时间等）
• 操作按钮（新增、编辑、删除等）

创建新事件

步骤1：打开新增事件对话框

1. 在事件管理页面，点击"新增事件"按钮（通常位于页面右上角）
2. 系统将弹出"新增事件"对话框

步骤2：填写事件基本信息

所属项目

• 系统会自动显示当前项目的名称和ID
• 这表明该事件将属于当前项目

事件名称（必填）

• 在"事件名称"输入框中输入事件的显示名称
• 使用易于理解的中文名称，例如：
  • 用户注册
  • 商品购买
  • 页面浏览
  • 按钮点击
• 这个名称将在分析报表中显示

事件代码（必填）

• 在"事件代码"输入框中输入事件的唯一标识符
• 使用 kebab-case 格式（小写字母，用连字符分隔）
• 例如：
  • user-registration
  • product-purchase
  • page-view
  • button-click
• 这个代码用于在应用中埋点时标识事件

事件描述（推荐填写）

• 在"事件描述"文本框中详细描述事件的用途和触发场景
• 例如：
  • 用户完成注册流程时触发，包含注册方式、来源渠道等信息
  • 用户成功购买商品时触发，记录商品信息、支付方式、金额等
  • 用户访问特定页面时触发，用于统计页面浏览量

步骤3：保存事件

1. 检查所有必填项是否已正确填写
2. 点击"确定"按钮保存事件
3. 系统显示"创建成功"提示信息
4. 对话框自动关闭，返回事件管理页面

事件创建后的效果

创建成功后，您可以看到：

• 事件列表中出现新创建的事件
• 事件状态为"已创建"，可以开始在应用中使用
• 可以在数据分析模块中选择该事件进行分析

编辑现有事件

1. 在事件管理页面的事件列表中，找到要编辑的事件
2. 点击该事件行的"编辑"按钮
3. 在弹出的"编辑事件"对话框中修改相关信息
4. **点击"确定"**保存修改

⚠️ 注意：

• 事件代码一旦创建后建议不要随意修改，因为可能影响已有的数据统计
• 如果必须修改事件代码，请确保同步更新应用中的埋点代码

删除事件

⚠️ 重要提醒：删除事件会影响相关的数据分析，请谨慎操作

1. 在事件列表中找到要删除的事件
2. 点击"删除"按钮
3. 系统会弹出确认对话框，提醒删除的影响
4. **点击"确认"**完成删除

事件使用建议

事件命名规范

• 事件名称：使用清晰的中文描述，便于团队理解
• 事件代码：使用统一的命名规范，建议格式：模块-动作
  • 用户模块：user-register、user-login、user-logout
  • 商品模块：product-view、product-purchase、product-favorite
  • 页面模块：page-enter、page-leave、page-scroll

事件分类建议

根据业务需求，可以创建以下类型的事件：

用户行为事件

• 注册、登录、登出
• 个人信息修改
• 密码重置

业务核心事件

• 商品浏览、购买、收藏
• 订单创建、支付、取消
• 内容发布、分享、评论

页面交互事件

• 页面访问、停留时长
• 按钮点击、表单提交
• 搜索、筛选操作

系统事件

• 错误发生、异常处理
• 性能监控、加载时间
• API调用成功/失败

常见问题

Q: 事件代码可以包含中文吗？ A: 不建议使用中文，推荐使用英文和连字符的组合，这样在技术实现时更加规范。

Q: 一个项目可以创建多少个事件？ A: 理论上没有限制，但建议根据实际业务需求合理规划，避免创建过多冗余事件。

Q: 如何知道事件是否被正确触发？ A: 可以在"事件日志"页面查看事件的触发记录，确认埋点是否正常工作。

Q: 事件创建后如何在应用中使用？ A: 需要开发人员在应用代码中添加相应的埋点代码，使用事件代码来标识和触发事件。