ClickPost provides APIs to enable brands to segment their customers based on their historical behavior & tailor its policies to different customer segments.
For running the segmentation simulation for the first time, brands need to set the threshold parameters for certain metrics. These metrics will be taken into consideration while running the simulation & customers will be distributed across different segments.
Brands need to define threshold values for 3 metrics to run any segmentation simulation job successfully.
These 3 metrics are:
- Return rate
- Average order frequency
- Average invoice value
Metric 1: Return rate
Return rate measures how many delivered orders are returned by customers. It's a key metric that affects profitability, customer experience, and operational efficiency.
To make this metric actionable, brands should define thresholds for what they consider low, moderate, and high return rates. These benchmarks will vary depending on the product category, customer expectations, and business goals.
These thresholds should align with the brand’s current focus—whether that's rapid growth, improving margins, or enhancing the customer experience.
The thresholds for return rate will work as below:
- Low: 0% - (moderate - 1)%
- Moderate: (Low+1)% - (High-1)%
- High: (Moderate +1)% - 100%
Metric 2: Average order frequency
Average order frequency tells you how often customers place repeat orders over a given time period. It’s a useful metric for understanding customer engagement and loyalty.
To make this actionable, brands should define what counts as low and high frequency based on their own historical customer data.
These thresholds should be tailored to your product category and buying cycles—and should also reflect your goals around retention, repeat purchases, and customer lifetime value.
Once these brackets are defined, they can be directly mapped to segmentation strategies. Customers with low order frequency can be targeted with win-back or engagement campaigns, while high-frequency customers might be ideal for loyalty programs, exclusive drops, or early access offers.
- Low: 0 - (threshold-1)
- High: >=(threshold)
Metric 3: Average invoice value
Average invoice value (AIV) reflects how much customers typically spend per order. It’s a core metric that helps brands track revenue quality, customer purchasing power, and overall business health.
To use this effectively, brands should define low and high value thresholds based on their historical order data.
- Low: 0 - (threshold -1)
- High >= (threshold)
APIs
Following APIs are available for setting & retrieving threshold values, fetching segmented customer data at both customer & segment levels:
Configure Threshold Values: This API allows you to configure or update the segmentation thresholds for return rate, order frequency, and invoice value. These thresholds determine how customers are classified in segmentation analysis.
Retrieve current threshold values: This API allows the brands to retrieve the current segmentation threshold settings defined for your enterprise account.
The customer segmentation APIs work asynchronously. The first API call allows the brand to run the segmentation simulation job. The second API can be used to subsequently poll the status of the previous API, & if the job status is completed, the segmentation data can be retrieved over a file.
Trigger customer segmentation: This API allows the brands to trigger the customer segmentation simulation based on the thresholds configured. This API will asynchronously initiate a job to generate & export the customer segmentation data file for your brand. To download the generated file, you need to call another API.
Fetch customer segmentation file: This API allows the brands to check the status of a previously initiated file generation job. If the job is complete, the API returns a downloadable link to the generated file.
Fetch segment data by customer: Brands can also fetch the customer segment data at a customer level, using the email address as the customer’s primary key.
