What is a reward definition?
A reward definition is a configurable template, containing core information used when assigning a reward. To redeem a reward against a profile, you first need to specify the definition of the reward you are assigning.
For example, you may have a "Birthday" reward definition, and a "Christmas" reward definition.
When attributing the reward to a profile, you can specify your desired definition at the time of redemption.
Reward definition properties
Attribute | Description |
---|---|
id
| The unique Omneo ID of the definition |
name | The display name of the definition |
handle | The unique handle for the definition |
period | Valid for (in Days) |
description | The internal description for the definition |
short_description | A publicly available short description for this definition |
long_description | A publicly available full HTML description for this definition |
terms_conditions | Terms and conditions attached to this condition |
earn_instructions | Instructions to customers on how to earn this reward |
icon | A valid URL for the icon associated with this definition |
image_url | A valid URL for the cover image associated with this definition |
issue_target_id | The target id used when an issued notification is triggered |
expiry_target_id | the target id used when an expiry notification is triggered |
notify_issue_offset | Issue notification offset in hours |
notify_expiry_offset | Expiry notification offset in hours |
internal_notes | Internal notes attached to this definition |
type | The type of the reward definition |
value | The value of the reward |
is_extendable | Denotes if this definition can be extended past the expiry date |
is_assignable | Denotes whether this definition can be allocated to a profile. Further information about assigning reward can be found here |
is_reassignable | Denotes whether this definition can be allocated to a profile when already allocated |
is_published | Denotes whether this definition is published and is visible to the customer |
tags | An Array of tags attached to this definition |
created_at | The UTC date & time the definition record was created in ISO 8601 format. |
updated_at | The UTC date & time the benefit definition was last updated in ISO 8601 format. |