Treasure hunts
A treasure hunt is a multi-clue activity with a reward on completion. Menu: Engagement › Treasure Hunts.
Availability
Treasure Hunts permission · Only from a client account, not from the host.
Current scope
The screen only manages the hunt's record. Today there is no clue editor in the panel and no game screen in the member portal, so members cannot solve clues from the platform. Use it as the activity's record until both pieces exist.
How it works
The record defines the programme that receives the points, the dates, the number of clues and the reward for completing. The platform engine already knows how to validate clues of four types and hand out the prizes.
| Clue type | How it is validated |
|---|---|
| Question / Code | Free text, case-insensitive and ignoring leading and trailing spaces. |
| Location | GPS coordinates within the clue's radius (50 m if not specified). |
| QR scan | The scanned code matches exactly, case-sensitive. |
| Photo | No verifier yet: the clue is never passed. |
- Solving a clue gives its points only once per member.
- On solving all the clues, the final reward is granted only once: points and, if there is one, the badge.
- An incorrect attempt carries no penalty.
- Active campaign multipliers are applied to the clue points and to the final reward.
- Only hunts in Active status and within their date window accept attempts.
List
| Column | What it is |
|---|---|
| Name | Name of the hunt. |
| Programme | Programme that receives the points. |
| Hunt Type | Geolocated, Digital, QrCode or Mixed. |
| Status | Draft, Active, Completed or Cancelled. |
| Total Clues | Planned number of clues. |
| Completion Reward Points | Points on completion. |
| Start Date / End Date | Window of the hunt. |
The Actions menu on each row offers Edit and Delete. There is a search box (Search...) and Refresh.
Create / edit
Click Create New.
| Field | What it is | Notes |
|---|---|---|
| Name | Name of the hunt. | Required. |
| Description | Supporting text. | |
| Hunt Type | Geolocated, Digital, QrCode or Mixed. | It is a label on the record. |
| Status | Draft, Active, Completed or Cancelled. | Only Active accepts attempts. |
| Start Date / End Date | Window in which it can be played. | Optional. Read in your account's time zone. |
| Total Clues | Number of clues. | Minimum 1. |
| Completion Reward Points | Points on completion. | Requires choosing a Loyalty Programme. |
| Completion Badge ID | Badge delivered on completion. | Must exist. |
| Loyalty Programme | Programme that receives the points. | |
| Image URL | Image of the hunt. |
States and limits
- If you set completion points without a Loyalty Programme, IncentIA will not let you save.
- A Photo clue is never passed: do not use it.
- Indoor GPS can drift 30 m or more. Widen the radius for indoor clues.
- There are no branches: the hunt is a single path of clues.
Permissions
| Action | Permission (UI text) | Technical id |
|---|---|---|
| View the screen | Treasure Hunts | Pages.Gamification.TreasureHunts |
| Create | Creating Treasure Hunt | Pages.Gamification.TreasureHunts.Create |
| Edit | Editing Treasure Hunt | Pages.Gamification.TreasureHunts.Edit |
| Delete | Deleting Treasure Hunt | Pages.Gamification.TreasureHunts.Delete |