Vouchers
Analyse voucher codes and campaigns: redemptions, revenue, discount cost, return rate, budget and anomalies, with CSV and PDF export.
Vouchers shows what the voucher codes of the shop deliver and what they cost. For every code and every campaign you see redemptions, revenue, discount cost and return rate. plinth flags anomalies such as an exceeded budget or an unusual number of redemptions on one day. Codes are created in Shopware; here you analyse them.
Where to find it
Open Reports > Vouchers. From the overview you reach:
- the report of a single code (click a row in the table),
- Campaigns: the list of campaigns, a single campaign and the comparison,
- the settings (gear button at the top), with the permission Edit campaigns and notes.
What you need
- The permission View vouchers for key metrics per code and campaign, without order numbers.
- See order numbers per voucher for the list of the orders behind a code or campaign.
- Edit campaigns and notes to create and change campaigns, to store partner and budget per code and to change the settings.
- Export voucher reports for CSV and PDF.
- A connected shop, see Onboarding wizard.
- A finished statistics import: the figures come from the nightly statistics and the order sync, see Statistics.
- For return rates: return data that plinth can read from the shop.
Permissions are assigned in Access.
How do I read the voucher report?
- Open Reports > Vouchers.
- Choose the Period: This month, Last 30 days, Last month, Last 90 days or This year. For Custom period, fill in From and To and click Show.
- Read the key metrics for the period:
| Tile | Meaning |
|---|---|
| Orders with a voucher | Orders in the period with at least one voucher. The change compares with the previous period of the same length. |
| Share of orders | How many of all orders in the period had a voucher. |
| Discount cost | Sum of all voucher discounts, below it their share of revenue. |
| Revenue | Sum of the order amounts with a voucher (gross, with shipping). Canceled orders do not count. |
| Return rate (value) | Share of the goods value that was returned for voucher orders. |
- The chart Redemptions per week shows the course over time.
- The table Voucher codes in the period lists every code with Status, Redemptions, Share of orders, Revenue, Discount cost, Avg. discount, Return rate, value, Trend and Budget used. Click a column header to sort.
- Use the search field (Code, campaign, partner) to find a code.
As of ... shows when the data was fetched. Reload fetches fresh data from the shop instead of the cache; this can take a moment.
Status of a code
| Status | Meaning |
|---|---|
| active | The code is valid in the shop and can be redeemed. |
| expired | The end date has passed or the redemption limit is reached. |
| inactive | The voucher is switched off in the shop. |
| undefined | The shop has no promotion for this code any more (deleted or from migrated orders). |
How do I find anomalies?
- Open Reports > Vouchers.
- Read the block Anomalies. Each line names the code or campaign and the reason. A click opens the affected code or campaign.
- Use the Quick filters to show only certain codes in the table. Click a tile again to show all:
| Quick filter | Shows |
|---|---|
| Critical | Codes whose budget or redemption limit is exceeded. |
| Flagged | Codes with at least one hint. Critical codes are included. |
| Budget nearly used | Codes whose budget has reached the warning threshold or is exceeded. |
| High returns | Codes with a return rate (value) above the threshold. |
| New in the period | Codes that were not redeemed in the previous period. |
| Active | Codes that are valid in the shop. |
- In the table, coloured hints next to a code show the same anomalies: Budget nearly used, Budget exceeded, Budget well exceeded, Well above expectation, Limit exceeded, High returns, Daily spike.
The thresholds are in the settings.
How do I look at a single code?
- Click the code in the overview. The Voucher report opens for the same period.
- Read the key metrics, the chart Redemptions per week and Definition and validity (type, value, validity, redemption limit as stored in the shop).
- With the permission See order numbers per voucher, the block Orders lists Order number, Date, Order status, Order amount, Discount cost and Return.
How do I add notes, partner and budget to a code?
- Open the report of the code.
- Go to Partner and budget.
- Fill in Partner, Channel (Newsletter, Social media, Partner, Influencer or Shop), Owner, Budget (EUR) and Notes.
- Click Save.
This needs the permission Edit campaigns and notes. The notes are stored in plinth only; nothing changes in the shop. With a budget, plinth warns when the discount cost of the code comes close to it.
How do I create a campaign?
A campaign groups codes with partner, period, budget and expectation.
- Open Reports > Vouchers and click Campaigns.
- Click New campaign.
- Fill in the fields:
| Field | What to enter |
|---|---|
| Campaign | The name of the campaign. |
| Partner, Channel, Owner | Who the campaign runs with, through which channel and who is responsible. |
| From, To | The period. Leave To empty for a campaign without an end. |
| Budget (EUR) | For example 1,500.00. Empty = no budget. |
| Expected redemptions, Expected revenue (EUR) | What you expect; plinth compares the result with it. |
| Codes | One code or prefix with * per line (for example summer*). Not case-sensitive. |
| Notes | Anything worth remembering. |
- Click Save.
The campaign page shows the key metrics against budget and expectation and the codes of the campaign. The state is planned, running, ended or archived. Campaigns also appear as bands in the time charts of Statistics.
To change a campaign, open it and click Edit campaign. Archive campaign removes it from overviews and charts; Restore campaign brings it back.
How do I compare campaigns?
- Open Reports > Vouchers and click Campaigns.
- Tick 2 to 6 campaigns.
- Click Compare campaigns. The campaigns are shown side by side; the best result per row is marked.
How do I export a report as CSV or PDF?
- Open the overview, a code or a campaign and choose the period.
- Click Export at the top.
- Choose CSV (table for Excel) or PDF (report to pass on).
The export uses the chosen period and is logged. The PDF contains no customer data, only order numbers, amounts and dates. Long lists are shortened in the PDF; the full list is in the CSV. The campaign comparison can be exported as CSV.
Voucher figures can also be part of a scheduled report: see the sections Vouchers: key figures, Vouchers: codes and Vouchers: campaigns in Reports.
How do I change the thresholds?
- Open Reports > Vouchers and click the gear button (Voucher settings).
- Under Thresholds, set for example Budget: warn from (%), Budget: exceeded from (%), Budget: well exceeded from (%), High return rate (value) from (%) and the values for the Daily spike.
- Click Save. The settings apply to this shop only.
The blocks Returns and Voucher texts of migrated orders tell plinth where the shop stores returns and which credit lines of migrated orders count as vouchers. Change them only together with your administrator.
Common errors and fixes
| Message | Cause | Fix |
|---|---|---|
| No vouchers redeemed / "No voucher was used in this period." | No code was redeemed in the period. | Choose a longer period, for example with Show this year. |
| "No code matches the filters." | Search or quick filter hides all codes. | Clear the search field or click the active quick filter again. |
| "Return data can't be read for this shop, so return rates are unavailable." | plinth cannot read the returns of the shop. | Ask your administrator to check the block Returns in the settings. |
| Order sync is stuck | The nightly order sync has not run successfully. Until it runs again, the page reads newer figures directly from Shopware. | Check the job Sync orders on the Jobs page. |
| An asterisk (*) next to a budget | The statistics do not cover every day, so only the period is counted. | Wait until the statistics import is complete, see Statistics. |
| "Entry not found (was the code redeemed in this period?)." | The code was not redeemed in the chosen period. | Choose a period in which the code was used. |
| "Thresholds must be in ascending order: warning, exceeded, well exceeded." | The budget thresholds are not ascending. | Correct the three values. |
| "Export isn't enabled for your account." | The permission Export voucher reports is missing. | Ask an administrator, see Access. |
| "Couldn't load the voucher data." | The data could not be read. | Click Reload. If it stays, check the shop connection, see Onboarding wizard. |
| "Sign in to Shopware again." | The sign-in to the shop has expired. | Sign in again, see Signing in. |
Note: Returns are only recorded from the time the shop starts storing them. For older orders the return rates are too low.
See also
- Statistics: voucher share, Promotions and vouchers in the sales analysis
- Reports: voucher sections in scheduled reports
- Markers: mark events in the charts
- Returns
- Bulk editing: sale promotions