Development alpha.3 — local testing
Read campaign reports
Working version: 0.1.0-alpha.3. This guide describes the current local implementation and is staged for the coordinated website update.
Choose the orders to review
Open HookSpark → Pricing & Discounts → Campaign reports. Your account needs permission to manage WooCommerce.
- Enter From and To to review a period, then select Apply dates.
- Both dates are included, using the store timezone and the order's creation date. Enter both dates; the end cannot precede the start.
- With dates, the summary covers all matching orders in the period. Without dates, each page covers up to 50 orders: use Older orders and Newer orders. An unfiltered page is not an all-time total. Clear both dates and select Apply dates to return to this view.
Processing, completed and refunded orders are included. Pending, failed and cancelled orders do not contribute. Creating a promotion does not create report data: a qualifying order needs a saved promotion snapshot.
For example, choose September 1–30 to review orders created in September. A later refund of one of those orders is included when the report is run, even if the refund itself occurred in October. This is an order-period report, not a refund-date report.
Understand Campaign discounts
| Column | Meaning |
|---|---|
| Campaign | Saved campaign identity and historical names. Renaming or deleting a current promotion does not rewrite an earlier order. |
| Orders reviewed | Orders with a usable snapshot for this campaign. An order using two campaigns appears in both campaign counts. |
| Original discount | The promotion reduction originally granted, before native WooCommerce coupons. Refunds are not subtracted. |
| Recorded discounted units | Units attributed to the campaign when the order was recorded. This is not necessarily the quantity of all products in the order. |
Do not add campaign order counts to estimate unique orders. Stacked campaigns can also count the same units more than once across rows. Currencies and stored monetary precision are kept separate; the report does not convert currencies or provide a combined exchange-rate total.
A Partial count means some historical lines lack reliable unit data. The displayed number covers the known units only; missing data is not interpreted as zero. Older order snapshots may support monetary reporting without supporting unit attribution.
Understand Promoted product lines
This section counts each promoted product line once, even when several campaigns apply to it.
- Product line totals include native coupon reductions and exclude taxes and shipping.
- Linked refunds include refund amounts associated with those product lines.
- Refunds entered only as an order-level amount cannot be assigned reliably to individual promoted lines. The report shows a warning when such refunds are present.
Example: a non-taxable product costs €100. A 20% promotion lowers it to €80; a 10% coupon lowers it to €72. Original discount is €20, while Product line totals is €72. A €36 refund explicitly linked to this line appears under Linked refunds. It does not change Original discount to a net figure.
Example: an automatic gift shows zero product revenue
A customer buys two gift boxes at €20 each and receives a €5 ribbon for free. The completed order totals €40. The campaign report shows:
| Figure | Result | Why |
|---|---|---|
| Orders reviewed | 1 | One qualifying order used the campaign. |
| Original discount | €5 | The ribbon received a full reduction from its original price. |
| Recorded discounted units | 1 | Only the ribbon was discounted; the boxes triggered the offer. |
| Product line totals | €0 | The promoted ribbon was free. The two full-price boxes are not promoted lines. |
The €0 figure does not mean that the order generated no revenue. Open the order to see its complete total. The report separates the discounted products from the products that qualified the customer for the gift.
These figures are not profit: product costs, payment fees, shipping costs and other expenses are not included. Unallocated refunds also prevent treating the displayed line amounts as a complete net-sales result.
Discounted units are not remaining quota
Units describe the original promotion allocation. For a buy-two/get-one-free offer, the rewarded unit is attributed to the campaign; the two triggering units are not reward units. For a progressive offer, only the discounted part of the quantity is attributed.
Returns are not subtracted from this historical unit count. The campaign quota also has pending checkout reservations that are not completed report orders. Do not calculate remaining campaign availability by subtracting this report from the configured quota. Use the campaign allowance checks and review the separate quota guide.
Investigate missing or surprising data
- Confirm the date range and the store timezone.
- Open the order and check its status and promoted product lines.
- Check whether the order has historical promotion data. The plugin does not recreate old discounts using today's rules.
- Read warnings about incomplete snapshots, partial unit counts and unallocated refunds.
- Compare orders in the same currency; do not add EUR and JPY rows.
- If reporting a problem, share a synthetic example and the local diagnostic summary after reviewing it. Do not send customer details or credentials.
The current verification covers historical snapshots, currency separation, linked refunds and period aggregation across multiple batches. High-volume performance and complete browser accessibility review remain open; this guide does not claim those checks are complete.
Example: one order, two promotions
An order contains four gift boxes (€80), two automatic ribbons (€0 instead of €10), one discounted Small hoodie (€40 instead of €50), and one full-price Large hoodie (€50). The order total is €170.
- The ribbon campaign records one order, €10 original discount and two discounted units.
- The Small campaign records the same order, €10 original discount and one discounted unit.
- Promoted product line totals are €40: the Small hoodie plus the free ribbons. The full-price boxes and Large hoodie do not belong to this total.
Do not add the two campaign order counts to report two purchases: there was one purchase using two promotions. Refunds and native coupons follow the separate definitions above.