Most Frequent Order

Most Frequent Order returns the products that each of your customers ordered most frequently during your chosen date range and at the frequency you have defined. For example, return a list of customers whose most frequent purchase within the last 30 days was tacos:

Important

You must choose at least one product attribute – category, subcategory, description, or gender – and/or a store ID.

After you choose at least one product and specify a date range you may apply filters to associate your customers orders with specific products, brands, channels, and stores. For example, return a list of customers who most frequently ordered deluxe tacos in Goleta, CA.

How this attribute works

Most Frequent Order represents a common approach people use when they build segments: figure out what your customers purchased most often within a certain time window, and then associate that list of customers to your marketing campaigns.

Most Frequent Order is a compound attribute, which means that it’s built from a combination of attributes that already exist in your data, and then appears as a single attribute that you can choose from the Segment Editor.

With this attribute, you can focus less on SQL and more on finding answers that align to your marketing goals and strategies. Purchase behavior attributes simplify the number of steps that are required to associate a list of customers to your products, stores, channels, and brands.

How does the SQL for Most Frequent Order work?

Most Frequent Order is built from standard columns that are output by Amperity. The following example returns a list of customers whose most frequent purchase within the last 30 days was tacos:

The SQL for Most Frequent Order works like this. It uses a count of distinct order IDs from the Unified_Itemized_Transactions table as its starting point, and requires at least one product category, product subcategory, product gender, or store ID to be selected:

SELECT
  amperity_id
  ,product_category
  ,product_subcategory
  ,store_id
  ,RANK() OVER (PARTITION BY amperity_id ORDER BY COUNT(DISTINCT order_id) DESC) AS frequency_rank
FROM Unified_Itemized_Transactions

then uses the RANK() function to determine order frequency, then ranks them in descending order, and then returns all items that match the date range:

WHERE order_datetime < DATE_TRUNC('day', CURRENT_TIMESTAMP - interval '30' day)

Returns and cancellations are filtered out automatically, like this:

AND (is_return IS NULL OR (NOT is_return))
AND (is_cancellation IS NULL OR (NOT is_cancellation))

and then results are grouped by Amperity ID and any selected filter attributes:

GROUP BY amperity_id, product_category, product_subcategory, store_id

From that list of customers, Most Frequent Order uses another SELECT statement to return only customers who purchased most frequently the combination of filter attributes you provided. For example, more than 2 purchases:

SELECT DISTINCT
  amperity_id
FROM list_of_most_frequent_orders
WHERE frequency_rank = 1
AND product_category IN 'tacos'
AND product_subcategory LIKE 'deluxe'
AND store_id = '0007 (Goleta, CA)'

This creates a list of customers who most frequently ordered deluxe tacos from your restaurant in Goleta, CA.

The SQL for Most Frequent Order is more complex than what is described in the previous section. This is due to the way this attribute returns only a list of Amperity IDs, uses a series of common table expressions (CTEs), and takes advantage of workflows that Amperity does behind the scenes to pre-filter the product, purchase, and store attributes.

You can view the full SQL for Most Frequent Order from the Segment Editor. Start a new segment and add only this attribute (along with any required conditions and filter attributes), and then click the View SQL link at the top of the page.

Add to segments

To find all customers who made their first order within a specified date range, start with the Most Frequent Order attribute located under Transactional Behaviors:

After the attribute appears in your segment, select at least one of product category, product subcategory, product gender, or store ID, and then choose a date range:

After you specify a date range you may apply filters to associate these customers to specific products, brands, channels, and stores.

About relative dates

A relative date is determined at the time a segment is run, where “today” is the day on which the segment is run, and “now” is the date and time on which the segment is run. For example: “today - 2 weeks” or “today - 14 days”.

Available conditions

The following table lists the conditions that are available to this attribute.

Note

Recommended conditions for this attribute are identified with “ Recommended” and conditions with more limited use cases are identified with “ Not recommended”.

Condition	Description
was after	Recommended was after returns a list of customers whose most frequent order was after the specified time window.
was before	Recommended was before returns a list of customers whose most frequent order was before the specified time window.
was between	Recommended was between returns a list of customers whose most frequent order was between two specified time windows.
was not between	was not between returns a list of customers whose most frequent order was not between two specified time windows.
was not on	was not on returns a list of customers whose most frequent order was not on the specified time.
was on	was on returns a list of customers whose most frequent order was on the specified time.

Filter attributes

A filter attribute is a standard column that is output by Amperity. When a filter attribute is associated with a compound attribute, you may use each filter attribute to filter the results of the compound attribute on specific items in your product catalog, brands, channels, and stores.

The following filter attributes may be made available to this attribute, when the underlying data in your tenant is available from the Unified_Itemized_Transactions table:

• Product category

• Product description

• Product subcategory

• Product gender

• Purchase brand

• Purchase channel

• Store ID

Important

The following table lists the semantic tag that generates the column that is the pre-requisite for each attribute filter. If the column is missing from the Unified_Itemized_Transactions table (or if it has a non-standard name) it will not be available to the attribute filter group:

Semantic tag	Column name	Filter name
pc/product-category	product_category	Product category
pc/product-description	product_description	Product description
pc/product-subcategory	product_subcategory	Product subcategory
pc/product-gender	product_gender	Product gender
txn-item/purchase-brand	purchase_brand	Purchase brand
txn-item/purchase-channel	purchase_channel	Purchase channel
txn-item/store-id	store_id	Store ID