Read Aggregations

A GET to the /profiles/{profileId}/aggregations endpoint allows your application to retrieve a Profiles Aggregations.

{
  "profile_id": "922fafaf-1115-2221-a33-fed3333397",
  "shop_days": null,
  "spend_12m": 2000,
  "spend_all": 2000,
  "spend_atv_12m": 2000,
  "spend_atv_all": 2000,
  "spend_first_date": "2020-12-07 13:04:30",
  "spend_last_date": "2020-12-07 13:04:30",
  "dimension_frequency": "F1",
  "dimension_recency": "RC",
  "dimension_join": "JN",
  "channel": null,
  "shop_count": 1,
  "store_join": {
      "id": 1,
      "type": null,
      "name": "Omneo Store",
      "description": null,
      "phone": "1131131",
      "email": null,
      "timezone": null,
      "external_id": "M10",
      "external_code": "10",
      "is_published": true,
      "is_permanently_closed": false,
      "address": null,
      "normal_hours": [],
      "special_hours": [],
      "tags": [],
      "custom_fields": [],
      "created_at": "2020-05-18 08:52:49",
      "updated_at": "2020-08-25 08:59:51"
  },
  "likely_country": null,
  "likely_country_score": null,
  "purchased_brands": [
      "transaction-created"
  ],
  "most_transacted_location": {
      "id": 1,
      "type": null,
      "name": "Omneo Store",
      "description": null,
      "phone": "1131131",
      "email": null,
      "timezone": null,
      "external_id": "M10",
      "external_code": "10",
      "is_published": true,
      "is_permanently_closed": false,
      "address": null,
      "normal_hours": [],
      "special_hours": [],
      "tags": [],
      "custom_fields": [],
      "created_at": "2020-05-18 08:52:49",
      "updated_at": "2020-08-25 08:59:51"
  }
}

📘

Refreshing calculations

Aggregations are automatically recalculated with every transaction made against the profile.
All calculations against a profile are refreshed at once.

Aggregation Properties

AttributeDescription
profile_id
READ_ONLY
The profile_id of the profile the aggregation belongs to
shop_days
INTEGER
Average days between shops
this represents the average of days between the customers purchases.
spend_12m
FLOAT
The total dollar value spent over 12 months from the last recalculation date.
spend_all
FLOAT
The total dollar value spent since the profile was created
spend_atv_12m
FLOAT
The average transaction value over 12 months from the last recalculation date
spend_atv_all
FLOAT
The average transaction value since the profile was created
spend_first_date
DATE-TIME
Records the date of the Profiles first transaction converted to UTC timezone.
spend_last_date
DATE-TIME
Records the last date of the Profiles transacted converted to UTC timezone.
dimension_frequency
STRING
A two character code that denotes the frequency the customer shops.

F0 = Never shopped
F1 = Shopped once
F2 = Shopped twice
FL = Shopped +3 times & frequency between shops is greater than 30 days
FH = Shopped +3 times & frequency between shops is less than 30 days
dimension_recency
STRING
A two character code that denotes how recent the customer has shopped

R0 - Never shopped
RC - Shopped within the last 3 months
RS - Shopped within the last 6 months
RA - Shopped within the last 12 months
RI - Shopped over 12 months ago.
dimension_join
STRING
A two character code that denotes the profiles join lifecycle stage.

JN = New, where join date is less than or equal to 90 days ago
JC = Current, where join date is greater than 90 days but less than or equal to 365 days ago
J1 = represents 1 year, where join date is greater than 365 days but less or equal to 730 days
J2 = represents 2 years, where join date is greater than 730 days but less or equal to 1095 days
J3, J4, etc
channel
STRING
A two character code that denotes the channels the customer has used to shop

CM - Point of Sale, and Website
CF - Point of Sale only
CO- Website Only
shop_count
INTEGER
The count of total profile transactions, with transactions greater than $0
store_join
STRING
the store of the profiles first transaction.
This is the first store the profile shopped at
likely_country
STRING
The likely country of this profile.
This is the result of an internal calculation of recent transactions, joined location, preferred location and stored addresses
likely_country_score
INTEGER
This is a numerical score given to the strength of the prediction. with 1 being the highest
purchased_brands
ARRAY
An array representing all brands of all products the customer has purchased.
most_transacted_location
STRING
The store with the most transactions in the last 2 years.
If no transactions have been placed in the last 2 years, this is instead a calculation of transactions for all time
Language
Credentials
Header
URL