Skip to main content
Aggregations are calculated facts derived from a profile’s transaction history and activity. They are computed by Omneo on a regular schedule and available as read-only fields on the profile. Use them for segmentation, personalisation, and real-time display in front-end experiences.

​
Available aggregations

​
Reading aggregations for a profile

Aggregations are returned as part of the standard profile response:
Look for the aggregations key in the response body. If aggregations have not yet been calculated for a profile (e.g., a newly created profile with no transactions), the values will be null.

​
Browsing all aggregations

​
Using aggregations in reactions

Aggregation values are available as variables in reaction conditions and Twig templates. For example, you can trigger a reaction when spend_12m crosses a threshold, or include a customer’s lifetime spend in a notification payload.

​
Notes

  • Aggregations are recalculated on a schedule: they are not real-time. Allow for a short delay after a transaction is recorded before aggregation values update.
  • Aggregations are read-only. You cannot write to them directly via the API.
  • For real-time incentive balances (points, rewards), use the dedicated incentive endpoints rather than aggregations.