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

Attribute

Description

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.