Module · Promotion
Promotion: campaigns
A campaign is one paid (or free manual) display of one specialist profile, service, product or board listing for a number of days. This page explains how places and seats work, how a specialist buys and cancels promotion, what happens when the promoted item is hidden, and what the team can do with campaigns. Auction-specific rules are on Auctions; every option mentioned here is described in Settings.
Places, seats and the queue
- Each place (for example Specialists directory · block above the list) shows up to N cards. Up to Paid slots of them can be paid cards; the rest are free cards chosen by rating, by completed bookings, newcomers and ordinary catalog cards.
- Max concurrent paid (M) is how many campaigns can run at the same time on a place.
- In Fixed price mode a campaign is not bought for one block but for its type. A profile campaign shows in every fixed-price place that shows specialists (the home block and the directory block); a service campaign in every fixed-price place that shows services. The number of campaigns of a type that can run at once is the smallest M among those places.
- When all seats are taken, a new purchase is queued: it starts on the nearest date when a seat frees for the whole bought period. The specialist sees the expected start ("nearest free slot: …") before paying.
- Buying again for the same profile or service extends the display: the new campaign starts when the current one ends, without a break.
- In Auction mode each place sells its own seats by periods; see Auctions. In Off mode the place shows no paid cards.
The clock of a campaign counts only the time it is actually shown. A pause moves its end date.
Campaign statuses
| Status | Ukrainian label | Meaning |
|---|---|---|
| Awaiting payment | Очікує оплати | The specialist started a purchase but the payment has not arrived. |
| Scheduled | Заплановано | Paid (or manual) and waiting for its start date in the queue. |
| Active | Активне | Showing now. |
| Paused | На паузі | Not showing because the promoted item is not public; the clock is stopped. |
| Ended | Завершено | The paid period has been fully shown. |
| Canceled | Скасовано | Cancelled by the specialist, or an unpaid purchase that expired. |
| Terminated | Припинено | Ended early by the team or by a pause decision. |
Buying promotion (specialist)
- The specialist opens Promotion in the cabinet (
/specialist/promotion/). - Under Buy promotion (or Extend or add when something already runs), they choose What to show: My profile or one of their published services.
- Under Duration they pick one of the active plans for that type. Each option shows the days, the price and the date the display would end ("Display until …"). If the site shows prices in another currency for the visitor, the cabinet notes that "The amount in your currency is approximate; you pay the exact price shown first."
- They pay with Pay by card (the payment module's checkout opens) or Pay from balance (…) if balance payment is allowed in Rules.
- The campaign appears in Current promotion as Awaiting payment, then Scheduled or Active when the payment is confirmed. The specialist receives "Promotion paid" and, at the start, "Promotion started". The team receives "New promotion purchase".
Before the purchase, the cabinet lists the conditions and whether they are met: Profile (approved and listed in the catalog), Payment details (verified details if the site requires them), Reliability (no restriction in effect, if the site checks it). If something is missing, the page says "Purchase is unavailable right now:" followed by the reason, for example:
| Message | Cause |
|---|---|
| You need a published profile, at least one published service, and a profile that has not been removed from search. | Profile must be in the catalog is on and the profile does not qualify. |
| Verified payout details are required (Finances section). | Verified payout details required is on. |
| While a reliability yellow card is in effect, you cannot buy new promotion. | Block when a yellow card is active is on. |
| There are no paid slots in the blocks right now. Contact the site team. | No enabled place of this type has paid seats and M. |
| No plans or paid placements are available. Contact the site team. | No active plan and no auction is offered. |
| Payment is off: the payment provider is not set up. | The payment module has no working provider. |
| The campaign queue limit for this subject has been reached. | Queued campaigns per item limit reached. |
| Promotion sales are temporarily paused. Paid promotion keeps running. Try again later. | The team pressed Pause sales. |
A purchase is also refused if the place has no public display, if the nearest start is beyond Queue horizon (days), or if the account is closed or closing.
An unpaid purchase stays Awaiting payment until it is paid, cancelled by the specialist (Cancel), or cancelled automatically after Unpaid request lifetime (hours) if that option is set.
What the specialist sees for each campaign
For each campaign the cabinet shows the item, the status, the period (or "Dates appear after payment"), Impressions and clicks with the click rate, Requests ("Requests 3, paid 1": booking requests after a click on the paid card, and how many of them were paid), a day-by-day list, the Receipt and any Refund receipt, and the Cancel promotion button when cancellation is possible. Earlier campaigns are under History.
The cabinet overview also shows a short line such as "Active promotion: … until …".
Cancellation by the specialist
The specialist can cancel from the cabinet. What is refunded depends on the moment:
| When | Confirmation shown | Money |
|---|---|---|
| Awaiting payment | "Cancel the promotion request? There was no payment yet." | Nothing was paid; the purchase is cancelled. |
| Paid, not shown yet | "Cancel the promotion before it starts? The full amount will be refunded." | Full refund. |
| Already shown | "Cancel the promotion? The unused part will be refunded in proportion to the time left." (or "…minus the refusal fee…" when a fee is set) | Unused part, minus Withdrawal fee, %. |
- After the first display, cancellation is possible only if Allow the specialist to withdraw from an active campaign is on.
- The unused part is the unshown time divided by the bought time, measured in the Calculation step and rounded by Rounding.
- The refund goes back through the payment module. If the provider confirms refunds later, the campaign is cancelled once the refund is confirmed. If the provider refuses the refund, the display is restored for the remaining time.
- An auction seat is settled by the auction rules; see Auctions.
Pauses
A campaign pauses when the promoted item can no longer be shown, for example:
- the profile or service is unpublished or removed from search, or the account is closed;
- the item is deleted or changes owner;
- for products: out of stock, or the shop cannot confirm the product.
How it works:
- With Grace period before pause (minutes) above 0, the campaign keeps its seat for that time; if the item is public again before the end of the delay, nothing happens. Deletion, an owner change and an unavailable shop pause at once.
- The campaign becomes Paused; the clock stops. The specialist sees the reason in the cabinet, for example "Reason: removed from search". The team gets "A promotion campaign is paused and needs a decision", and the campaign appears in Needs a decision.
- If the item becomes public again, the campaign resumes on its own and its end date moves by the paused time, unless a decision has already ended it. A deleted item or one whose owner changed never resumes ("The subject is deleted or its owner changed. Display is blocked; the unused part follows the refund procedure.").
- Otherwise the team chooses one of the pause actions allowed in Rules (see Needs a decision), or the Automatic action runs after Automatic action after N days of pause.
While a campaign is paused, its seat stays occupied, so queued campaigns do not start in its place.
Working with campaigns in the admin
Where: ExpertPress → Promotion → Campaigns (Кампанії).
Campaign list
The list shows ID, Type, Subject, Status, Source (Purchase or Manual), Days, Price and To (end date). Filter by status with All, Active, Queued, Paused, Ended and Filter; Refresh reloads. Click a row to open the campaign.
Needs a decision
The Needs a decision (Потребує рішення) block lists paused campaigns waiting for the team, oldest first. The count of these campaigns also appears next to Promotion in the admin menu and in the core overview as "Campaigns needing a decision".
For each campaign choose an action, enter a Decision reason (at least 3 characters) and click Apply (Застосувати):
| Action | Result | Permission |
|---|---|---|
| Pause display | The campaign stays paused and resumes when the item is public again; the end date moves. | Pause actions (non-monetary) |
| Refund money | The unused part is refunded and the campaign is terminated. | Refunds |
| Place funds on hold | The campaign is terminated without a refund; the platform keeps the money and the unused amount is recorded. Not available for auction seats. | Pause actions (non-monetary) |
| Apply to debt | The unused part pays off the specialist's debt and the campaign is terminated. | Refunds |
Only the actions turned on under Rules → Pause and balance payment are offered. A decision can be taken once per pause.
Campaign details
The campaign page shows:
- the main data: Status, Type, subject, Source, plan, days and price at purchase, To, Price, Unused part, pause state, Reason / comment, and Requests ("Requests 3, paid 1");
- Display intervals and pauses (Інтервали показу та паузи): every interval the campaign was shown and every pause;
- Impressions / clicks by day (Покази / кліки по днях);
- Payment, receipts, refunds (Оплата, чеки, повернення): the sale, method (balance or card / bank), amount, paid amount, receipts and refunds; "There is no platform sale (manual campaign or not paid yet)." for free campaigns;
- Action log (Журнал дій): every event, such as purchase, start, pause, decision, refund and emails sent;
- the Refund and Terminate campaign forms, depending on permissions.
Refund
- Who: the Refunds permission.
- What it does: Refunds any amount up to what remains of the sale, with a required Reason. Leave Refund amount empty to refund the unused part calculated from the display intervals.
- Also stop the display (Також припинити показ): ends the campaign as well. It is checked when the amount covers the whole unused part. A partial refund returns money only; the display continues.
- The confirmation says "Refund this campaign? Money moves immediately and cannot be undone." With providers that confirm refunds later, the refund is recorded after the confirmation.
Terminate campaign
- Who: the End campaign permission; a refund amount above zero also needs the Refunds permission. Without it you can terminate only with a zero amount (a manual campaign or one already refunded).
- What it does: Ends the campaign now, with a Termination reason. The Refund amount defaults to the Suggested amount (the unused part); a different amount needs a Reason for the amount change and cannot exceed the paid balance.
- The specialist receives "The site team terminated the promotion". The confirmation says "Terminate this campaign? This cannot be undone."
Manual campaigns
New manual campaign (Нова ручна кампанія) creates a free campaign, for example as a bonus, a compensation, or to test a place. It uses the same seat limit and queue as a purchase; there is no payment.
| Field | What to enter |
|---|---|
| Type | Profile, service, product or board listing. |
| Subject ID | The specialist ID for a profile, otherwise the service, product or listing ID. |
| Days | 1–3660. |
| Start (site local time) | Optional, YYYY-MM-DD or YYYY-MM-DD HH:MM. If there is no free seat for the whole period from that moment, the nearest free start is used instead. Empty starts as soon as possible. |
| Reason | Required. |
Click Create manual campaign (Створити ручну кампанію). If no place of the type sells seats, you get "No paid promotion seats are available for this type."
Placement schedule
Where: ExpertPress → Promotion → Placement schedule (Розклад місць).
For each place, a table for the next 90 days shows per day: M (concurrent), Taken, Free, and the campaigns. Days where more campaigns overlap than seats are marked overbooked; days with a free seat show "available slot". A place without paid seats says "There are no paid slots in this block."
For auction places, "Taken" counts everything that holds a seat (showing, scheduled and paused campaigns, checkouts awaiting payment and won seats); unpaid holders are counted separately ("2 unpaid that day").
Use it to answer specialists who ask when a seat will be free, and before you lower paid seats or M.