Timers and promos overview
Timers are not just visual countdown widgets. In Plandalf, a promo is campaign state: deadline, active tier, CTA target, redirect behavior, buyer reference, and checkout pricing context.
Promo campaign path
A promo ties the campaign link, countdown, and checkout price together so the customer sees one consistent offer.
-
Email or ad click — The visitor arrives with pf_ref so campaign and participant context can follow them.
-
Countdown renders — The page or email shows the current deadline state from the promo.
-
Checkout uses active tier — The checkout button passes the promo slug so the active tier can affect pricing or redirects.
What promos control
- launch windows and deadline funnels
- active tier names, times, and prices
- countdown displays on pages
- email countdown image URLs
- CTA links and redirects
- checkout pricing when an offer is opened with a promo
- reporting for participants and campaign outcomes
Page widget
<div data-plandalf-promo="early-bird"></div>Checkout pricing context
<button
data-plandalf-present="summit-ticket"
data-plandalf-apply-promo="early-bird"
>
Buy ticket
</button>Programmatic equivalent:
await plandalf.present("summit-ticket", {
promo: "early-bird"
});Related docs
-
Create a promo — Set up the campaign record that drives tiers, widgets, and checkout pricing.
-
Countdown timers — Add visual countdown surfaces to pages and email.
-
CTA links — Keep campaign links and redirects aligned with active tiers.
-
Embedded promos — Pair a promo with an embedded offer.