Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

Incentive notifications are the comms that close the loop between earning and action. A customer who earns a reward but never hears about it won’t come back to spend it — the notification is part of the incentive.

​
Common incentive notification types

NotificationTriggerTiming
Welcome reward issuedProfile createdImmediately on join
Reward earnedTransaction completedWithin minutes of purchase
Tier upgradeTier attainedImmediately on attain
Tier at riskAnniversary approaching with insufficient spend30-60 days before anniversary
Reward expiry reminderX days before expiryConfigurable (typically 14 days)
Benefit issuedBenefit created on profileImmediately on issue
Birthday rewardBirthday approachingTypically 3-7 days before birthday
Balance summaryScheduled campaignMonthly or quarterly

​
How notifications are triggered

Incentive notifications are sent via Reactions. Each reaction can include a target.send action that fires a notification payload to your connected comms platform (Klaviyo, Salesforce Marketing Cloud, Braze, etc.). The typical flow:
  1. Event fires (e.g., transaction.completed, tier.achieved, reward.expiring)
  2. Reaction evaluates any conditions
  3. target.send action fires with the relevant event context
  4. Comms platform receives the payload and sends the email/SMS/push notification

​
Reward earned notification

The most common incentive notification. Configure this as a reaction on transaction.completed: 
{
  "event": "transaction.completed",
  "actions": [
    {
      "type": "target.send",
      "target_handle": "klaviyo-reward-earned",
      "sort_order": 1
    }
  ]
}
The target payload should include:
  • Customer first name
  • Reward amount earned this transaction
  • Total reward balance
  • Balance expiry date (if applicable)
  • CTA linking to Profile Portal or your eCommerce account page

​
Tier change notification

Configure on tier.achieved to celebrate upgrades: 
{
  "event": "tier.achieved",
  "actions": [
    {
      "type": "target.send",
      "target_handle": "klaviyo-tier-upgrade",
      "sort_order": 1
    }
  ]
}
The event context for tier.achieved includes the tier handle and name, which lets you personalise the message to match the tier (Gold, Platinum, etc.).

​
Expiry reminder notification

Omneo can fire a reaction on a scheduled basis to find customers with rewards expiring soon. Use an Automation (scheduled reaction) that runs daily and filters for profiles with a reward expiry within the next 14 days: 
{
  "type": "automation",
  "schedule": "0 8 * * *",
  "filters": [
    {
      "attribute": "reward_expires_in_days",
      "operator": "<=",
      "value": 14
    }
  ],
  "actions": [
    {
      "type": "target.send",
      "target_handle": "klaviyo-expiry-reminder"
    }
  ]
}
The exact filter attribute names for reward expiry reminders depend on your Omneo configuration. Confirm with your Omneo team which aggregation fields are available for expiry-based scheduling.

​
Tier at risk

Notifying customers when they are at risk of losing a tier is one of the highest-impact retention tactics available. The message should be specific: “You need to spend $X more before [date] to keep your Gold status.” The data required comes from the profile’s aggregations (spend_12m, tier attain threshold, anniversary date). This data is available in the event context for automations targeting tier-holding profiles.

​
Notification content best practices

Be specific. “You earned a $12.50 reward” beats “You’ve been rewarded.” Specificity makes the value feel real. Show the running balance. Customers who can see their accumulating balance are more motivated to continue. Give the expiry date. Always show when rewards expire. Urgency drives redemption. Redemption drives return visits. Make the CTA frictionless. Link directly to the checkout page or the Profile Portal balance view. Don’t make the customer hunt.