摇一摇赢奖励小程序 - 用户指南
摇一摇赢奖励（Shake For Rewards） 小程序让会员摇晃手机来赢取代币或礼券。每摇一次会消耗一次 抽奖机会（entry）。会员通过 每日登录 来获得抽奖机会。运营人员在 Ops 后台配置小程序的标题、抽奖机会规则、奖品和时间。
说明： 本小程序嵌入在 VIO 会员端中打开。会员必须先登录会员端。运营人员通过管理后台进行所有管理。
目录
- 如何进入
- 会员端 - 主页面
- 会员端 - 如何摇奖
- 会员端 - My Rewards
- 会员端 - My Entries
- Ops 后台 - Dashboard
- Ops 后台 - Reward Statistic
- Ops 后台 - Program Settings
- 使用须知
- 常见问题
1. 如何进入
会员
- 打开 VIO 会员端 并登录。
- 在 Home 页找到 Mini programme，点 See all。
- 点击 Shake For Rewards 图标（图标名称可能因品牌而异）。
- 第一次打开时会弹出 动作感应权限 弹窗 — 点击 Allow 允许。
提示： 一定从会员端进入摇一摇，登录信息才会被带过去。
运营
- 打开 管理后台 并登录。
- 进入 Mini Apps -> Shake For Rewards。
- Ops 后台会打开，共有三个页面：
- Dashboard（默认页）
- Reward Statistic
- Program Settings
2. 会员端 - 主页面
打开页面后，会员看到：
| 元素 | 作用 |
|---|---|
| 返回箭头（左上角） | 返回 Mini Apps 列表。 |
| 标题 | 显示小程序名称（默认：Shake For Rewards）。 |
| 帮助图标（右上角，?） | 打开 How to Play 玩法说明弹窗。 |
| 通知条幅 | 展示最近的中奖记录，例如 "Ko***eng shook and won 50 tokens!" |
| 礼物盒 | 页面中央的大礼物盒动画。摇晃手机时它也会跟着抖动。 |
| 状态文字 | 显示今天剩余的摇奖次数，例如 "You have 3 shakes left today." |
| Enable Shake Detection 按钮 | 仅当还未授权动作感应时显示。 |
| My Rewards 按钮 | 查看你赢得的代币和礼券列表。 |
| My Entries 按钮 | 查看你的抽奖机会记录（获得 + 使用）。 |
3. 会员端 - 如何摇奖
玩法步骤
- 先确认你 至少还有 1 次摇奖机会（看状态文字）。
- 握紧手机然后 摇晃。
- 礼物盒会播放摇动动画。
- 约 2 秒后，结果弹窗会出现。
结果弹窗展示
| 结果 | 你看到的内容 |
|---|---|
| 赢得代币 | 标题 Congratulations!、闪光图、提示 "Hooray! You got X TOKEN tokens!"、Done 按钮。 |
| 赢得礼券 | 标题 Congratulations!、礼券闪光图、提示 "Amazing! You won a [礼券名]!"、Done 按钮。 |
| 本次未中奖 | 标题 Keep Trying!、提示 "No reward this time, keep trying!"、Done 按钮。 |
| 项目未开始或已结束 | 标题 Keep Trying!、提示 "No active program found"、Done 按钮。当项目的开始时间还在未来、或结束时间已经过去时出现。 |
| 所有奖品已派完 | 页面顶部出现一个小的深色提示："No rewards are available right now. Please try shaking again later." |
| 摇奖失败 | 弹窗内显示错误信息。再试一次即可。 |
说明： 当 所有奖品都已派完 或 项目未启用（未开始 / 已结束）时，这次摇奖 不会扣 抽奖机会，剩余次数保持不变。运营人员需要补货、延长项目时间或开新项目，会员才能继续中奖。
如何获得更多抽奖机会
点右上角 ? 图标打开 How to Play 弹窗。会员可通过以下方式获得机会：
- Daily Log In — 每天打开 App 即可获得抽奖机会。
提示： 每次每日登录获得多少机会由运营人员设定，可以在 How to Play 里看到当前规则。
4. 会员端 - My Rewards
在主页面点 My Rewards。
页面包含
- 返回箭头。
- Token 和 Voucher 两个页签，切换不同类型的奖励。
- 排序图标（右上角）— 打开排序菜单：
- The Newest - oldest（最新到最旧）
- The Oldest - newest（最旧到最新）
- 奖励列表：
- 代币行：代币图标（圆形小标）、代币名称、日期 / 时间、数量（例如 +10 VIO）、来源。
- 礼券行：礼券图、品牌、礼券名称、Earned on...（获得日期）。
- 空状态：若还没赢得奖励，页面会显示：
- 一个大礼物盒插画
- 提示文字："No rewards at the moment."
- 紫色按钮 Join Shake For Rewards — 点击即可返回摇一摇主页面，开始第一次摇奖。
5. 会员端 - My Entries
在主页面点 My Entries。
页面包含
- 返回箭头。
- Total entries 卡片在顶部 — 你目前还剩多少次抽奖机会。
- 抽奖机会记录 — 每一次获得和使用的记录：
- + 抽奖机会获得 — 例如 Daily login + 3 entries。
- − 抽奖机会使用 — 例如 Shake for rewards − 1 entry。
- 获得与使用的文字都是同样的紫色，+ 或 − 号决定是增加还是扣减。
- 每条记录显示日期与时间。
提示： 抽奖机会按天计算。某些来源（如 Daily Log In）每天会重置，明天再来还能继续获得。
6. Ops 后台 - Dashboard
Dashboard 是打开 Ops 后台时默认进入的页面。
页面结构
| 区块 | 显示内容 |
|---|---|
| 顶部标题栏 | 左侧显示 Shake For Rewards 标题与 Online 状态徽章；右侧是 Program Settings 按钮（齿轮图标），点击进入项目设置。 |
| 统计卡片 | Total Participants（总参与人数）、Total Entries（总抽奖机会）、Total Rewards（拆分为代币次数 + 总数量，以及礼券次数）。 |
| View Reward Statistic 链接 | 位于 Program Summary 区块右上角，点击打开 Reward Statistic 页面。 |
| 搜索框 | 通过用户或奖励名查找记录。 |
| Entry Source 筛选 | 按 Daily login 筛选。 |
| Reward Type 筛选 | 按 Token 或 Voucher 筛选。 |
| 记录表格 | 一行一次摇奖记录 — 显示用户、日期、抽奖机会来源、奖励类型、奖励内容、状态。 |
| 分页 | 表格底部的 Previous / Next。 |
使用方式
- 打开 Ops 后台 — Dashboard 自动加载。
- 用 搜索框 查找某位会员或某个奖励。
- 用 Entry Source 和 Reward Type 筛选缩小范围。
- 页面 每 10 秒自动刷新，数据保持实时。
- 点菜单中的 Reward Statistic 查看每个奖品的表现。
- 点 Program Settings 调整项目配置。
7. Ops 后台 - Reward Statistic
Reward Statistic 页面展示每个奖品的表现情况。
页面结构
| 区块 | 显示内容 |
|---|---|
| 面包屑导航（左上） | Shake For Rewards › Reward Statistic。点击 Shake For Rewards 即可返回 Dashboard。 |
| Export Reward Statistic 按钮 | 页面标题右侧（紫色，带下载图标）。可下载当前的奖励统计数据。 |
| 时段筛选 | Today、This Week、This Month 或 All Time — 切换统计窗口。 |
| Reward Type 筛选 | 按 Token 或 Voucher 筛选。 |
| 奖励表格 | 一行一个奖品：奖品名、类型、Total Won（总中奖次数）、Total Prizes（总奖品数）、Won Rate %（中奖率）、Trend（趋势箭头，上升 / 下降）。 |
| 分页 | 在多页奖品间切换。 |
使用方式
- 顶部选择 时段（Today / This Week / This Month / All Time）。
- （可选）按 Token 或 Voucher 筛选。
- 查看 Won Rate % 了解每个奖品有多受欢迎。
- 通过 趋势箭头 看奖品被赢取的趋势是上升还是下降。
- 点击页面右上角的 Export Reward Statistic 把当前视图下载成文件。
8. Ops 后台 - Program Settings
打开 Program Settings 配置或修改摇奖项目。整个流程是 4 步表单，最后一步保存后修改才会生效。
提示： 页面左上角的 面包屑导航（
Shake For Rewards › Program Settings）可以让你随时返回 Dashboard — 点击 Shake For Rewards 即可。
步骤：
- Basic Settings（基本设置）
- Entry Configuration（抽奖机会配置）
- Reward Configuration（奖励配置）
- Confirmation of the program（确认）
8.1 Step 1 - Basic Settings
| 字段 | 作用 |
|---|---|
| Set Program Duration（开关） | 开 — 设置开始与结束日期；关 — 项目无结束日期。 |
| Start Date Time / End Date Time | （仅开关打开时显示。）选择开始与结束时间。开始必须早于结束。 |
| Title | 会员端 How to Play 弹窗显示的标题。最多 30 字符。 |
| Description | 会员端 How to Play 弹窗显示的规则文案。可使用格式化栏（粗体、斜体、列表、链接）。最多 2000 字符。 |
按钮： Cancel 或 Next。
说明： 标题和说明未填完，Next 按钮会禁用。若打开了日期范围，结束日期必须晚于开始日期。
8.2 Step 2 - Entry Configuration
设置会员获得抽奖机会的方式。
| 抽奖机会来源 | 设置方式 |
|---|---|
| Daily Log In | 打开开关，输入数字（1-99）— 每天打开 App 给会员多少次机会。 |
按钮： Back 或 Next。
8.3 Step 3 - Reward Configuration
添加会员可赢取的奖品。
如何添加一个奖品
- 点 Add New Reward。
- 填写：
- Reward Name（奖品名称）
- Reward Type（奖品类型）：Token 或 Voucher
- Quantity（总库存数量）
- Auto Restock（可选自动补货）：打开后设置 Restock Amount（补货量）+ Threshold（阈值，库存低于阈值时自动补货）
- Token 类型：设置代币类别和单人发放数量
- Voucher 类型：从礼券列表选择
- 点 Save。
添加奖品后
- 每一行奖品都有自己的 Winning Probability (%) 输入框。
- 所有概率之和必须正好等于 100%。
- 提示文字会显示当前总和 — 调到 100% 为止。
- 用 Actions 列里的 编辑 / 删除 图标修改或移除奖品。
- 奖品超过 5 个？用底部的分页箭头切页。
按钮： Back 或 Next。总和不等于 100% 时 Next 会禁用。
8.4 Step 4 - Confirmation
只读的全部信息复核：
- Basic Settings：时长、标题、说明。
- Entry Configuration：启用了哪些抽奖机会来源，以及对应数值。
- Reward Configuration：完整的奖品表 + 概率。
按钮：
- Back — 返回任意一步修改。
- Update Program Settings — 保存项目。保存成功会显示提示。
警告： 点击 Update Program Settings 后，修改 立即生效。如果项目正在被会员使用，修改时要特别小心。
9. 使用须知
| 主题 | 说明 |
|---|---|
| 抽奖机会每日重置 | Daily Log In 的抽奖机会每天会刷新。 |
| 一摇 = 一次机会 | 每次成功摇奖都会扣 1 次机会，无论是否中奖。 |
| 摇奖失败 | 如果摇奖未成功记录，则不扣机会。可再试。 |
| 中奖概率 | 在 Program Settings 设置。每个奖品有自己的 % — 总和必须正好 100%。 |
| 奖品库存 | 每个奖品有数量。库存为 0 时不能再被赢取，需补货（手动或自动）。 |
| 品牌命名 | 图标名称和页面标题可由品牌自定义，会员看到的名称可能不是 Shake For Rewards。 |
| 必须授权 | iOS 用户必须在动作感应权限弹窗点 Allow，否则摇一摇无法工作。 |
10. 常见问题
会员侧
| 问题 | 怎么办 |
|---|---|
| 页面空白或卡住 | 回到 Mini programmes 重新打开 Shake For Rewards。 |
| 摇手机没反应 | 确认动作感应权限弹窗点了 Allow。如果没有，点 Enable Shake Detection。 |
| 状态显示 0 shakes left today | 等明天 — 抽奖机会会在下次每日登录时刷新。 |
| 结果弹窗一直不出现 | 检查网络后再试。摇奖失败不会扣机会。 |
| 奖励在 My Rewards 里看不到 | 下拉刷新，或关掉重开 Shake For Rewards。代币也会出现在会员端 Home -> Balance 里。 |
| 动作感应权限弹窗一直没出现（iOS） | 打开 iOS 设置 -> Safari -> 动作与方向访问，开启后刷新页面。 |
运营侧
| 问题 | 怎么办 |
|---|---|
| Update Program Settings 保存失败 | 确认 step 3 的 Winning Probability 总和正好是 100%。 |
| step 1 的 Next 一直禁用 | 标题和说明必须填写。若打开了时长设置，结束日期必须晚于开始。 |
| step 2 的 Next 一直禁用 | 至少打开一种抽奖机会来源，并填好所需数值。 |
| Dashboard 数字看起来不对 | 页面每 10 秒自动刷新一次。仍异常可刷新浏览器标签页。 |
| 会员没收到抽奖机会 | 检查 Program Settings -> Entry Configuration 中该来源是否开启。 |
| 会员没赢到某个特定奖品 | 检查 Program Settings 里该奖品的 Quantity 与 Winning Probability %。 |