Reward Definitions

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

AttributeDescription
id
INTEGER
The unique Omneo ID of the definition
name
STRING
The display name of the definition
handle
STRING
The unique handle for the definition
period
INTEGER
Valid for (in Days)
description
STRING
The internal description for the definition
short_description
STRING
A publicly available short description for this definition
long_description
STRING
A publicly available full HTML description for this definition
terms_conditions
STRING
Terms and conditions attached to this condition
earn_instructions
STRING
Instructions to customers on how to earn this reward
icon
URL
A valid URL for the icon associated with this definition
image_url
URL
A valid URL for the cover image associated with this definition
issue_target_id
INTEGER
The target id used when an issued notification is triggered
expiry_target_id
INTEGER
the target id used when an expiry notification is triggered
notify_issue_offset
INTEGER
Issue notification offset in hours
notify_expiry_offset
INTEGER
Expiry notification offset in hours
internal_notes
STRING
Internal notes attached to this definition
type
STRING
ENUM
The type of the reward definition
available values are:
- activation
- anniversary
- birthday
- bonus
- campaign
- customer-service
- reactivation
- spend
- staff
- system-adjustment
- other
value
FLOAT
The value of the reward
is_extendable
BOOLEAN
Denotes if this definition can be extended past the expiry date
is_assignable
BOOLEAN
Denotes whether this definition can be allocated to a profile. Further information about assigning reward can be found here
is_reassignable
BOOLEAN
Denotes whether this definition can be allocated to a profile when already allocated
is_published
BOOLEAN
Denotes whether this definition is published and is visible to the customer
tags
ARRAY
An Array of tags attached to this definition
created_at
STRING
DATE-TIME
The UTC date & time the definition record was created in ISO 8601 format.
updated_at
STRING
DATE-TIME
The UTC date & time the benefit definition was last updated in ISO 8601 format.