Advertising → Pre-roll play frequency

Standalone SCP mock for plugins.sardiusAds.showAdAlways and how it relates to frequencyEach. No full asset picker — only the relevant settings.

Where this lives: top-level under the Advertising tab, with Amount of ads / Frequency of ad — below the Pre-roll and Post-roll URL lists. It does not go inside the Pre-roll or Post-roll “Edit advanced settings” modal (those control per-break amount, skip, countdown, break text). Global frequency only affects pre-roll localStorage history.

Sardius Ads

Simplified Advertising tab — asset lists are stubs.

Pre-roll ads

URLs / Add an asset / Edit advanced settings (unchanged)

stub — not part of this control

Post-roll ads

URLs / Add an asset / Edit advanced settings (unchanged)

stub — not part of this control

Amount of ads

Existing rule: Frequency options only apply when Amount of ads is 1 (smart single-ad rotation / history).

How often should the pre-roll play?

Radio maps cleanly to the three saved states. Choosing “Every visit” turns on showAdAlways and hides the schedule control (same as Stephen’s SCP note: if showAdAlways is on, hide frequencyEach).

Once per device

Default. Play the pre-roll the first time this player/asset loads for that browser. After that, suppress until localStorage is cleared. Saves neither showAdAlways nor frequencyEach.

Every visit

Play the pre-roll every time the player loads. Saves showAdAlways: true and omits frequencyEach.

On a schedule

Replay after the chosen window (existing Frequency of ad options). Saves frequencyEach in seconds; showAdAlways is not set. Runtime: frequencyEach wins if both were ever present.

Amount of ads is greater than 1 — frequency / showAdAlways controls stay hidden (matches current SCP canShowFrequencyField).

Viewer behavior

Saved shape (`plugins.sardiusAds`)

Answer for design:

Place this next to today’s global Frequency of ad, not inside Pre-roll / Post-roll advanced settings.
A 3-option radio is adequate and clearer than a separate toggle + select: Once per device · Every visit · On a schedule.
“Every visit” ≡ showAdAlways on + frequency hidden/cleared.

Sardius Ads

Pre-roll ads

Post-roll ads

How often should the pre-roll play?

Viewer behavior

Saved shape (plugins.sardiusAds)

Saved shape (`plugins.sardiusAds`)