The report is located in the Reports → Promotion Report section.
On this page, you’ll find two powerful reports designed to help you optimize your promotion strategy:
"Promotion dynamics"
Use this report to:
Track how your promotion performs over time and measure progress against your key business KPIs.
Spot trends by viewing metric changes daily, weekly, monthly, or yearly.
Quickly identify underperforming channels or touchpoints and take action to boost results.
"Promotion comparison"
This report helps you:
Pinpoint your top-performing promotions within any selected timeframe.
Understand how your promotions influence core KPIs compared to previous periods.
Determine which promotions work best for each location by comparing performance across all touchpoints.
All report data is updated nightly and reflects metrics as of the previous day.
Promotion dynamics
This report shows performance metrics for the discount promotion you’ve chosen.
Report setup
By default, the report is generated using the most recently launched promotion, and its active period is applied as the reporting timeframe. If the promotion is still running, the date selector on the right will display yesterday’s date.
Steps to View Promotion Data:
Select a promotion.
Start typing part of the promotion name in the search field (as shown in the screenshot), or pick a promotion from the dropdown. Promotions not applied to any orders won’t appear in the list.
Set the reporting period
Enter a custom period or choose a preset range (Last Week, Last Month, or Promotion Period). The start date is inclusive, and the current day cannot be selected, as all data is updated nightly and reflects metrics as of yesterday.
Choose locations
Only touchpoints with promotion orders appear in the list.
All locations are selected by default — adjust the selection if needed.
Filter Orders & Configure Metrics
Click “More conditions” to specify which orders should be included.
You can filter by order status categories and include/exclude anonymous orders.
You can also choose which metrics to display in the report. To remove a metric, simply uncheck it. This is helpful if you frequently use a specific set of data. Drag metrics to reorder them, move the most important to the top, and hide the ones you don’t need.
These display settings are saved for all users in the project.
Metric selection and order filters affect exports. The resulting file will include only the metrics you’ve chosen in this menu.
5. Add a comparison period (optional)
Add a custom comparison period or use preset dates to analyze your promotion’s performance over time.
Metric Description
Metric Description
Revenue
By promotion — the total value of all units that had a promotion applied during the selected period.
Total — the total value of all units sold during the selected period in locations where promotional sales took place.
Order Revenue
By promotion — the total value of all orders where a promotion was applied during the selected period. This includes both promotional and non-promotional units within those orders.
Total — the total value of all orders during the selected period in locations where promotional sales occurred.
Units
By promotion — the number of units sold with a promotion applied during the selected period.
Total — the total number of units sold during the selected period in locations where promotional sales occurred.
Orders
By promotion — the number of orders where a promotion was applied during the selected period.
Total — the total number of orders during the selected period in locations where promotional sales occurred.
Average Order value
By promotion — the average order value for orders where a promotion was applied during the selected period.
Calculated as: Order Revenue / Orders by promotion.Total — the average order value for all orders during the selected period.
Calculated as: Total Order Revenue / Total Orders.
Total discount amount — the total discount amount for the selected promotion within the chosen period.
Average percentage of discount calculated as:
Total discount amount/ Pre-discount value of orders with the promotion applied × 100%.
Average discount amount calculated as:
Total discount amount / Orders by Promotion.
Metric Performance Charts
Bar charts are available for each metric, with breakdowns by calendar days, weeks, months, or years. To adjust the chart:
Click the desired metric in the report header.
Choose how to group the data — by day, week, month, or year.
The list of available groupings may vary depending on the selected date range.Hover over any segment of the chart to view the data for that specific period.
If a comparison period is selected in the report settings, you will see two bars showing performance for both the current period and the comparison period.
General metrics (revenue, order revenue, units, orders, average order value) help you evaluate your promotion’s performance relative to the comparison period.
When you hover over the comparison period’s bar, the general metrics will display performance for the locations selected in the report header.
If the promotion was not running during the comparison period, only the values for the general metrics will be displayed in the bars.
Report table
Below the chart, you’ll find a table that breaks down your promotion performance by touchpoint. This view makes it easy to spot touchpoints with low promotional efficiency so you can dig deeper and optimize. Clicking on any channel will reveal its associated touchpoints.
Right below the date range, the table shows your metric value for the selected period. Underneath, you’ll see how that number changed from the previous period — both in absolute terms and as a percentage.
Promotion comparison.
This feature helps you compare the effectiveness of the selected discount promotions.
Report setup
By default, the report is built using the five most recently launched promotions from the past month. To configure this report, follow the same steps as in the Promotion Dynamics report setup.
Promotions that weren’t applied to any orders won’t be available for selection and will not appear in the drop-down menu.
Metric description
Metric description
Avg Daily Revenue for Promotion-Applied Units — calculated as:
"Total Revenue from Promoted Units" / "Active Promo Days".
Only the promotion’s active days that fall within the selected period are included.
Avg Daily Promotion-Applied Orders — calculated as:
"Promo-Applied Orders"/"Active Promo Days".
Avg Daily Promoted Units Sold — calculated as:
"Promo-Applied Units"/"Active Promo Days".
For promotions that were active for different numbers of days within the selected reporting period, we recommend comparing them using average daily performance metrics.
Total Revenue from Promoted Units — the final cost of all the units the promotion was applied to within the selected period.
Promo-Applied Units — the number of Units sold with the promotion applied during the selected period.
Promo-Applied Orders — the number of orders the promotion was applied to within the selected period.
Avg Order Value — the average order value for orders with the promotion applied during the selected period.
Calculated as: "Total Revenue from Promotion-Applied Orders"/"Promo-Applied Orders".
Units per Promo Order — the number of units sold in orders that include at least one promoted item during the selected period.
Total Revenue from Promotion-Applied Orders — the total value of all orders to which the promotion was applied during the selected period.
Both promoted and non-promoted units are included.
Revenue from Promo Units % — calculated as:
Total Revenue from Promoted Units/Total revenue for the selected period during the Active Promo Days.
Promo Order % — calculated as:
Promo-Applied Orders/Total amount of orders for the selected period during the Active Promo Days.
Revenue from Promo Orders % — calculated as:
Total Revenue from Promotion-Applied Orders/Total revenue for the selected period during the Active Promo Days.
Promo Units % — calculated as:
Promo-Applied Units/ total number of Units sold during the Active Promo Days.
Total Promo Discount — the total discount amount from the promotion during the selected period.
Avg Promo Discount % — calculated as: Total Promo Discount/The value of promotion-applied orders during the Active Promo Days before discounts × 100%.
Avg Discount per Order — calculated as:
Total Promo Discount/Promo-Applied Orders.
If a comparison period is selected, growth metrics become available in the report:
Revenue growth — this metric shows how your revenue has changed over a selected period compared to the selected comparison period. It includes only touchpoints where promo-related sales occurred.
Calculated as: “Total Revenue from Promoted Units” – “Total Revenue from Promoted Units within the comparison period)”.Order Count Growth — this metric shows how the number of orders changed during the selected period related to the comparison period. It includes only touchpoints where promo-related orders occurred.
Calculated as: “Promo-Applied Orders” – “Promo-Applied Orders within the comparison period)”.Average Order Value Growth — this metric shows how the average order value changed during the selected period related to the comparison period. It includes only touchpoints where promo-related orders occurred.
Calculated as: "Avg Order Value" − "Avg Order Value within the comparison period".Promo Units Sold Growth — this metric shows how the number of promo units sold changed during the selected period in relation to the comparison period. Data is calculated only for touchpoints that had promo orders.
Calculated as: "Average order value by promotion" − "Average order value by promotion within the comparison period".
Report table
Below the report settings, you'll find a table where all metrics are grouped by the selected promotions. The table also displays promotion statuses, the number of Active Promo Days, and each promotion’s period.
Active Promo Days — the number of days the promotion held the “Launched” status within the selected report period.
Promotion Period — the span between the promotion’s first launch date and the last date it held the “Launched” status before being finished or paused. The end date is not shown if the promotion is currently active.
Filters
Using these filters, you can identify the orders used to calculate the metric values. You can also export these orders to validate the results of other metrics.
"Total amount of orders":
Select the date that corresponds to the period chosen in the report.
Under Order Item - Line Status, choose the order categories that are included in the report’s More conditions filter.
Select the touchpoints chosen in the report.
"Promo-Applied Orders":
Use the same conditions as in the Total Orders filter, and additionally require that the promotion selected in the report is applied to the orders.
If the numbers don’t match, make sure that:
The filter uses the same date range as the report.
Note that report data is updated through the previous day, and the current day cannot be selected.The same order status categories are selected in both the filter and the report.
In the report settings, anonymous orders are excluded.
If anonymous orders are included, discrepancies are expected, since anonymous orders are not added to the project.No orders or customers with orders were deleted on that day. After deletions, the report is not updated immediately and is refreshed during the overnight recalculation.
How data deletion affects reports
Changes to or deletions of orders from the past three months, as well as deletions of customers with orders during that period, affect the report and reduce metric values accordingly. These changes will be reflected in the report the day after the overnight recalculation.
Deleting or modifying orders older than three months does not affect the report data.
Report export
Select the report type and configure the required settings. The file content and structure depend on the selected report settings. If certain metrics are not needed in the export, disable their checkboxes in the report settings.
Click Export:
Exporting the promotion report via the API is not supported.
"Promotion Dynamics" Report Export
If no comparison period is specified in the report settings, metric values in the file are displayed with a daily breakdown.
When a comparison period is selected, metric values are grouped by the selected touchpoints, and metrics for the comparison period are also included.
Column Description
Column Description
If all metrics are selected in the report settings, the following fields are included in the CSV file:
promotionName — promotion name.
promotionId — promotion ID.
channelName — channel.
pointOfContactName — touchpoint name.
pointOfContactID — touchpoint external ID.
startReportDate — the start date of the report period.
endReportDate — the end date of the report period.
date — date. This column is included if no comparison period is selected.
promoItemsRevenue — Total Revenue from Promoted Units.
promoReceiptsRevenue — Total Revenue from Promotion-Applied Orders.
totalRevenueForSelectedPeriod — total revenue for selected period.
promoItemsSold — Promo-Applied Units.
totalItemsSoldForSelectedPeriod — total number of units sold for the selected period.
promoReceipts — Promo-Applied Orders.
totalReceiptsForSelectedPeriod — total orders for the selected period.
averagePromoReceipt — Avg Promo Order Value.
averageReceipt — Avg Order Value.
promotionDiscountAmount — Total Promo Discount.
averagePromoDiscountPercentage — Avg Discount per Order %.
averagePromoDiscountAmount — Avg Discount per Order $.
promoRevenueCoverage — Revenue from Promo Units %.
Calculated as: "Total Revenue from Promoted Units"/"Total revenue" * 100%.promoReceiptsCoverage — Promo Order %. Calculated as: "Promo-Applied Orders"/"Total orders" * 100%.
promoReceiptsRevenueCoverage — Revenue from Promo Orders %. Calculated as: "Total Revenue from Promotion-Applied Orders"/"Total revenue" * 100%.
promoItemsCoverage — Promo Units %. Calculated as: "Total Revenue from Promoted Units"/"Total number of units" * 100%.
totalRevenueOnPromotionActiveDays — total revenue on promotion days.
totalItemsSoldOnPromotionActiveDays — total number of units sold on promotion days.
totalReceiptsOnPromotionActiveDays — total orders on promotion days.
averagePromoItemsPerPromoReceipt — average number of Promo-Applied Units in promo orders. Calculated as: "Promo-Applied Units"/ "Promo-Applied Orders".
averageItemsPerReceipt—average number of units in order. Calculated as: "Total units"/"Total orders".
The following fields will be included in your CSV file automatically if a comparison period is selected:
startComparisonDate — the start of the comparison period.
endComparisonDate — the end of the comparison period.
promoItemsRevenueForComparisonPeriod — Total Revenue from Promoted Units for the comparison period.
promoReceiptsRevenueForComparisonPeriod — Total Revenue from Promotion-Applied Orders for the comparison period.
totalRevenueForComparisonPeriod — total revenue for the comparison period.
promoItemsSoldForComparisonPeriod — products by promotion for the comparison period.
totalItemsSoldForComparisonPeriod — Promo-Applied Units for the comparison period.
promoReceiptsForComparisonPeriod— Promo-Applied Orders for the comparison period.
totalReceiptsForComparisonPeriod — total orders for the comparison period.
averagePromoReceiptForComparisonPeriod — Avg promo Order Value for the comparison period.
averageReceiptForComparisonPeriod — Avg total order value for the comparison period.
promotionDiscountAmountForComparisonPeriod —Total Promo Discount for the comparison period.
averagePromoDiscountPercentageForComparisonPeriod — average percentage of promotion discount for the comparison period (Avg Discount per Order %).
averagePromoDiscountAmountForComparisonPeriod — average promotion discount for the comparison period (Avg Discount per Order $).
promoRevenueCoverageForComparisonPeriod — Revenue from Promo Units %. Calculated as: "Total Revenue from Promoted Units for the comparison period"/"Total revenue for the comparison period" * 100%.
promoReceiptsCoverageForComparisonPeriod — Promo Order % for the comparison period. Calculated as: "Promo-Applied Orders for the comparison period"/"Total orders for the comparison period" * 100%.
promoReceiptsRevenueCoverageForComparisonPeriod — Revenue from Promo Units % for the comparison period. Calculated as: "Total Revenue from Promotion-Applied Orders for the comparison period"/"Total revenue for the comparison period" * 100%.
promoItemsCoverageForComparisonPeriod — Promo Units % for the comparison period. Calculated as: "Promo-Applied Units"/"Total units sold for the comparison period" * 100%.
totalRevenueOnPromotionActiveDaysForComparisonPeriod — total revenue on Active Promo Days for the comparison period.
totalItemsSoldOnPromotionActiveDaysForComparisonPeriod—total number of units sold on Active Promo Days for the comparison period.
totalReceiptsOnPromotionActiveDaysForComparisonPeriod — total orders on Active Promo Days for the comparison period.
averagePromoItemsPerPromoReceiptForComparisonPeriod — average number of Promo-Applied Units in Promo-Applied Orders for the comparison period.
Calculated as: "Promo-Applied Units for the comparison period"/"Promo-Applied Orders for the comparison period".averageItemsPerReceiptForComparisonPeriod — average number of units in order for the comparison period. Calculated as: "Average number of units"/"Total orders".
"Promotion Comparison" Report Export
Column Description
Column Description
The following fields are included in the CSV file if all metrics are selected and no comparison period is specified in the report settings:
promotionName — promotion name.
promotionId — promotion ID.
channelName — channel.
pointOfContactId — touchpoint external ID.
pointOfContactName — touchpoint name.
promotionState — promotion status:
execution—launched.
paused — on pause.
ended — ended.
archived — in an archive.
startReportDate—starting date of the reporting period.
endReportDate—ending date of the reporting period.
activeDays — the number of days the promotion was active within the selected period (Active Promo Days).
averageDailyPromoItemsRevenue — Avg Daily Revenue for Promotion-Applied Units.
averageDailyPromoReceiptsCount — Avg Daily Promotion-Applied Orders.
averageDailyPromoItemsSoldQuantity — Avg Daily Promoted Units Sold.
promoItemsRevenue — Total Revenue from Promoted Units.
promoItemsSold — Promo-Applied Units.
promoReceipts — Promo-Applied Orders.
averagePromoReceipt — Avg Promo Order Value.
totalItemsInPromoReceipts — the number of units in orders containing at least one promotional unit.
promoReceiptsRevenue — Total Revenue from Promotion-Applied Orders.
promoRevenueCoverage — Revenue from Promo Units %.
promoReceiptsCoverage — Revenue from promo orders %.
promoItemsSoldCoverage — Promo Units %.
promoReceiptsRevenueCoverage — Revenue from Promo Orders %.
promotionDiscountAmount —Total Promo Discount.
averagePromoDiscountPercentage — average percentage of promotion discount.
averagePromoDiscountAmount — average promotion discount ($).
totalRevenueForSelectedPeriod — total revenue.
totalSoldItemsQuantityForSelectedPeriod — total quantity of units sold.
totalReceiptsCountForSelectedPeriod — total number of orders for selected period.
averageReceipt — total average order value.
The following fields will be uploaded into your CSV file automatically if a comparison period is selected:
startComparisonDate — the start of the comparison period.
endComparisonDate — the end of the comparison period.
averageDailyPromoItemsRevenueForComparisonPeriod — Avg Daily Revenue for Promotion-Applied Units for the comparison period.
averageDailyPromoReceiptsCountForComparisonPeriod — Avg Daily Promotion-Applied Orders for the comparison period.
averageDailyPromoItemsSoldQuantityForComparisonPeriod — Avg Daily Promoted Units Sold for the comparison period.
promoItemsRevenueForComparisonPeriod — Revenue from Promoted Units for the comparison period.
promoItemsSoldForComparisonPeriod — Promo-Applied Units
sold for the comparison period.
promoReceiptsForComparisonPeriod — Promo-Applied Orders for the comparison period.
averagePromoReceiptForComparisonPeriod — Avg Promo Order Value for the comparison period.
totalItemsInPromoReceiptsForComparisonPeriod — the number of units in orders containing at least one promotional unit for the comparison period.
promoReceiptsRevenueForComparisonPeriod — Total Revenue from Promotion-Applied Orders for the comparison period.
promoRevenueCoverageForComparisonPeriod — Revenue from Promo Units % for the comparison period.
promoReceiptsCoverageForComparisonPeriod — Revenue from promo orders % for the comparison period.
promoItemsSoldCoverageForComparisonPeriod — Promo Units % for the comparison period.
promoReceiptsRevenueCoverageForComparisonPeriod — Revenue from Promo Orders % for the comparison period.
promotionDiscountAmountForComparisonPeriod — Total Promo Discount for the comparison period.
averagePromoDiscountPercentageForComparisonPeriod — average percentage of promotion discount for the comparison period.
averagePromoDiscountAmountForComparisonPeriod — average promotion discount ($) for the comparison period.
totalRevenueForComparisonPeriod — revenue for the comparison period.
totalItemsSoldForComparisonPeriod — number of units sold for the comparison period.
totalReceiptsForComparisonPeriod — number of orders for the comparison period.
averageReceiptForComparisonPeriod — average order value for the comparison period.
Growth metrics are not included in the export. If needed, you can view their values in the report interface or calculate them independently.