Shake For Rewards Mini App - User Guide
The Shake For Rewards Mini App lets members shake their phone to win tokens or vouchers. Each shake uses one entry. Members earn entries by logging in daily. Operators set up the program (title, entries, prizes, dates) in the Ops Portal.
Note: This Mini App opens inside the VIO Member App. Members must sign in to the Member App first. Operators manage everything from the Admin Portal.
Table of Contents
- How to Access
- Member - Main Screen
- Member - How to Shake
- Member - My Rewards
- Member - My Entries
- Ops Portal - Dashboard
- Ops Portal - Reward Statistic
- Ops Portal - Program Settings
- Things to Know
- Troubleshooting
1. How to Access
For members
- Open the VIO Member App and sign in.
- From Home, tap Mini programme -> See all.
- Tap the Shake For Rewards tile (the name may be different for your brand).
- The first time you open it, a popup asks for motion permission — tap Allow.
Tip: Always open Shake For Rewards from the Member App so your login is carried over.
For operators
- Open the Admin Portal and sign in.
- Go to Mini Apps -> Shake For Rewards.
- The Ops Portal opens with three pages:
- Dashboard (default)
- Reward Statistic
- Program Settings
2. Member - Main Screen
When the page opens, the member sees:
| Element | What it does |
|---|---|
| Back arrow (top left) | Returns to the Mini Apps grid. |
| Title | Shows the Mini App name (default: Shake For Rewards). |
| Help icon (top right, ?) | Opens the How to Play popup with rules. |
| Notification banner | Shows a recent winner, e.g. "Ko***eng shook and won 50 tokens!" |
| Gift box | A big animated gift box in the centre. It shakes when you shake your phone. |
| Status text | Shows shakes left today, e.g. "You have 3 shakes left today." |
| Enable Shake Detection button | Only shows if motion permission was not granted yet. |
| My Rewards button | Opens your list of won tokens and vouchers. |
| My Entries button | Opens your entry history (gained + used). |
3. Member - How to Shake
How to play
- Make sure you have at least 1 shake left (check the status text).
- Hold your phone firmly and shake it.
- The gift box plays a shake animation.
- After about 2 seconds, a result popup appears.
What the popup shows
| Result | What you see |
|---|---|
| Won a token | Title Congratulations!, sparkle image, message "Hooray! You got X TOKEN tokens!", Done button. |
| Won a voucher | Title Congratulations!, voucher sparkle image, message "Amazing! You won a [voucher name]!", Done button. |
| No reward this time | Title Keep Trying!, message "No reward this time, keep trying!", Done button. |
| Program not started or already ended | Title Keep Trying!, message "No active program found", Done button. Happens when the program's start date is still in the future, or its end date has already passed. |
| All prizes out of stock | A small dark toast at the top: "No rewards are available right now. Please try shaking again later." |
| Shake failed | Error message shown inside the popup. Try again. |
Note: When all prizes are out of stock or the program is not active, the shake does not use an entry — your shake count stays the same. Operators need to restock, extend the program, or start a new one before members can win again.
Where to earn more entries
Tap the ? icon (top right) to see the How to Play popup. Members can earn entries through:
- Daily Log In — open the app each day to receive entries.
Tip: The number of entries given per daily login is set by the operator. Check How to Play for your current rules.
4. Member - My Rewards
Tap My Rewards on the main page.
What you see
- Back arrow to return.
- Token and Voucher tabs to switch the list.
- Sort icon (top right) — opens a sort menu:
- The Newest - oldest
- The Oldest - newest
- Reward list:
- Token row: token icon (round badge), token name, date/time, amount (e.g. +10 VIO), source.
- Voucher row: voucher image, brand, voucher name, Earned on... date.
- Empty state: if you haven't won anything yet, the page shows:
- A big gift box illustration
- Message: "No rewards at the moment."
- A purple Join Shake For Rewards button — tap it to go back to the main shake page and try your first shake.
5. Member - My Entries
Tap My Entries on the main page.
What you see
- Back arrow to return.
- Total entries card at the top — the entries you still have.
- Entry history list — every gain and use of entries:
- + Entry gained — e.g. Daily login + 3 entries.
- − Entry used — e.g. Shake for rewards − 1 entry.
- Both gain and use rows show in the same purple text. The + or − sign in front tells you whether entries were added or used.
- Each row shows the date and time.
Tip: Entries are tracked per day. Some bonuses (like Daily Log In) reset every day, so come back tomorrow for more.
6. Ops Portal - Dashboard
The Dashboard is the home page when you open the Ops Portal.
Page layout
| Section | What it shows |
|---|---|
| Top header | Shake For Rewards title on the left with an Online status badge. Top right has the Program Settings button (gear icon) to open Program Settings. |
| Stats cards | Total Participants, Total Entries, Total Rewards (split into Tokens count + total amount, and Vouchers count). |
| View Reward Statistic link | Top right of the Program Summary section. Opens the Reward Statistic page. |
| Search box | Find an entry by user or reward name. |
| Entry Source filter | Filter by Daily login. |
| Reward Type filter | Filter by Token or Voucher. |
| Entries table | One row per shake — shows user, date, entry source, reward type, reward, status. |
| Pagination | Previous / Next at the bottom of the table. |
How to use
- Open the Ops Portal — Dashboard loads first.
- Use the search box to look up a member or a reward.
- Use the Entry Source and Reward Type filters to narrow the list.
- The page auto-refreshes every 10 seconds so the numbers stay live.
- Click Reward Statistic in the menu for prize-level insights.
- Click Program Settings to change how the program runs.
7. Ops Portal - Reward Statistic
The Reward Statistic page shows how each prize is performing.
Page layout
| Section | What it shows |
|---|---|
| Breadcrumb (top left) | Shake For Rewards › Reward Statistic. Click Shake For Rewards to return to the Dashboard. |
| Export Reward Statistic button | Top-right of the page header (purple, with a download icon). Downloads the current reward statistics. |
| Period filter | Today, This Week, This Month, or All Time — change the time window. |
| Reward Type filter | Filter by Token or Voucher. |
| Reward table | One row per prize: prize name, type, Total Won, Total Prizes, Won Rate %, and a Trend arrow (up/down). |
| Pagination | Move between pages of prizes. |
How to use
- Pick a Period at the top (Today / This Week / This Month / All Time).
- (Optional) Filter by Token or Voucher.
- Check the Won Rate % to see how popular each prize is.
- Use the Trend arrow to see if a prize is being won more or less than before.
- Click Export Reward Statistic (top right) to download the current view as a file.
8. Ops Portal - Program Settings
Open Program Settings to set up or update the Shake program. It uses a 4-step form. You must save at the end for changes to apply.
Tip: A breadcrumb at the top left (
Shake For Rewards › Program Settings) lets you return to the Dashboard at any time by clicking Shake For Rewards.
Steps:
- Basic Settings
- Entry Configuration
- Reward Configuration
- Confirmation of the program
8.1 Step 1 - Basic Settings
| Field | What it does |
|---|---|
| Set Program Duration (toggle) | On — set a start and end date. Off — the program runs without an end date. |
| Start Date Time / End Date Time | (Only when toggle is on.) Pick when the program starts and ends. Start must be before end. |
| Title | Title shown on the member's How to Play popup. Up to 30 characters. |
| Description | Rules shown on the How to Play popup. Use the formatting bar (bold, italic, bullets, link). Up to 2,000 characters. |
Buttons: Cancel or Next.
Note: Next stays disabled until the title and description are filled. If date range is set, end must be after start.
8.2 Step 2 - Entry Configuration
Set how members earn entries.
| Entry method | What to set |
|---|---|
| Daily Log In | Toggle on. Type a number (1-99) — how many entries the member gets each day they open the app. |
Buttons: Back or Next.
8.3 Step 3 - Reward Configuration
Add the prizes that members can win.
How to add a prize
- Click Add New Reward.
- Fill in:
- Reward Name
- Reward Type: Token or Voucher
- Quantity (total stock)
- Auto Restock (optional): turn on and set Restock Amount + Threshold (refills when stock drops below the threshold)
- For Token: set token type and amount per user
- For Voucher: pick the voucher from the list
- Click Save.
After adding prizes
- Each prize row has its own Winning Probability (%) input.
- The total of all probabilities must be exactly 100%.
- A warning shows the current total — adjust until it reads 100%.
- Use the edit / delete icons in the Actions column to change or remove a prize.
- More than 5 prizes? Use the page arrows at the bottom.
Buttons: Back or Next. Next is disabled until total = 100%.
8.4 Step 4 - Confirmation
A read-only summary of everything:
- Basic Settings: duration, title, description.
- Entry Configuration: which entry methods are on and their values.
- Reward Configuration: full prize table with probability.
Buttons:
- Back — go back to change anything.
- Update Program Settings — saves the program. A success message confirms when it's done.
Warning: Changes apply immediately after you click Update Program Settings. Be careful when changing live programs that members are using right now.
9. Things to Know
| Topic | Note |
|---|---|
| Entries reset daily | Daily Log In entries refresh each calendar day. |
| One shake = one entry | Each successful shake uses one entry, even if no prize is won. |
| Failed shake | If a shake fails to record, no entry is used. Try again. |
| Winning chance | Set in Program Settings. Each prize has its own % — total must be exactly 100%. |
| Prize stock | Each prize has a quantity. When stock is empty, that prize cannot be won until restocked (manually or by Auto Restock). |
| Brand naming | The tile and screen title can be renamed by your brand, so members may see a different name than Shake For Rewards. |
| Permission required | iOS users must tap Allow when the motion permission popup appears, or shake won't work. |
10. Troubleshooting
For members
| Problem | What to do |
|---|---|
| Page is blank or stuck | Go back to Mini programmes and reopen Shake For Rewards. |
| Shake does nothing | Make sure you tapped Allow on the motion permission popup. If not, tap Enable Shake Detection. |
| Status says 0 shakes left today | Wait until tomorrow — entries refresh on next daily login. |
| Result popup never shows | Check your network and try again. A failed shake does not use your entry. |
| Reward not showing in My Rewards | Pull down to refresh, or close and reopen Shake For Rewards. Tokens also show in Home -> Balance of the Member App. |
| Motion permission popup never appears (iOS) | Open iOS Settings -> Safari -> Motion & Orientation Access and turn it on, then reload the page. |
For operators
| Problem | What to do |
|---|---|
| Update Program Settings doesn't save | Make sure the Winning Probability total in step 3 is exactly 100%. |
| Next button stays disabled in step 1 | Title and description must be filled. If duration is on, end date must be after start date. |
| Next button stays disabled in step 2 | At least one entry method must be turned on, and its required values filled. |
| Dashboard numbers look wrong | Page auto-refreshes every 10 seconds. Reload the browser tab if it still looks off. |
| Members not earning entries | Check that the entry method is on in Program Settings -> Entry Configuration. |
| Members not winning a specific prize | Check the Quantity and Winning Probability % for that prize in Program Settings. |
See also Mini Apps overview, Lucky Draw Mini App, and Daily Check-In Mini App.