创建事件并准备触发入口
用有后台设置权限的账号进入瓜奇 → 事件 → 事件设置，核对当前前端网站，点击“添加事件”。事件用于在用户满足条件时生成待领取奖励记录。
创建事件后，还要把它接到打卡等实际入口。只有配置列表里存在一个事件，不会自动给用户发奖。
设置名称、时间和参与条件
| 设置项 | 用途与填写方法 |
|---|---|
| 事件 ID | 系统随机生成。复制到打卡等触发来源的设置中，用它指定要触发哪个事件。 |
| 启用事件 | 控制该事件是否开放。要暂停活动，应关闭这一项。 |
| 事件名称 | 填写用户能看懂的活动名称。该字段是单一文字，不按语言分别填写。 |
| 开始时间、截止时间 | 限定允许触发的活动时间。测试时也要确认当前时间处于有效范围内。 |
| 允许触发的用户组 | 选择可参与的等级或 VIP 用户组；留空表示不额外限制用户组。用户仍需登录。 |
| 触发概率 | 填写 0 到 100 的概率值。0 表示不触发；100 表示通过其他条件检查后必定通过概率判断。 |
| 触发频率 | 可选不限频率、每人每天一次、每人每周一次、每人每月一次或每人仅一次。不限频率也仍受其他条件限制。 |
设成 100% 后没有记录，应继续检查事件开关、活动时间、用户组、频率和触发入口，不能只检查概率。
填写奖励内容
积分奖励填写积分数量；等级或 VIP 奖励选择目标用户组。领取用户组奖励会改变用户当前的等级或 VIP，配置时应确认所选组的实际权益。
自定义奖励可以选择虚拟物品或实物商品，并填写奖励说明。需要自动交付时，还要接入对应的领取处理方法；方法存在时，系统会在领取后执行，并提供 WordPress 钩子供扩展。
填写“实物商品”或奖励名称，本身不会完成发货。活动上线前应准备好领取资料收集和后续发放流程。
设置弹窗和公开动态
“显示弹窗”只控制是否主动提示用户。关闭后，符合规则的事件仍可生成奖励记录，因此不能用关闭弹窗来暂停活动。
弹窗标题、说明和自定义 HTML 可按语言填写。当前语言有自定义 HTML 时，内容区优先显示这段 HTML；外层弹窗和领取按钮仍由系统管理。
需要把领取结果展示到信息流时，开启“生成事件文章”，并在信息流设置中安排展示范围、标题和内容。只有奖励领取成功后才会生成公开事件文章；历史领取不会补写，文章生成失败也不影响奖励领取。
前台事件模块的标题、展示范围和列表外观负责呈现活动，账户事件入口负责查看个人记录。这些展示设置不会代替触发条件和奖励设置。
连接入口并验证领取
- 保存事件，复制事件 ID。
- 以打卡为例，进入“瓜奇 → 任务”，把 ID 填入“打卡触发事件 ID”，再保存。
- 用符合用户组条件的账号登录，在有效时间内完成打卡。
- 到“事件记录管理”检查事件 ID、用户、触发来源和领取状态。未主动弹窗时，也要检查账户中的事件记录。
- 领取奖励后，核对积分或用户组变化；自定义奖励还要检查实际交付结果。
- 再次触发，验证所设频率是否限制重复获得记录。若开启生成事件文章，再检查信息流是否展示。
积分兑换和抽奖入口还需单独设置消耗、库存或保底等入口规则。事件的概率和频率不能代替这些设置。
继续阅读：配置事件触发和展示。