Sending Trigger Events
The window is one scrolling list of the ads the player has downloaded for the selected frame — a card per ad, its name above the preview.
Sending a trigger
Click the card. The click sends the trigger at once.
A spinner appears over the card while the request is in flight, and the card ignores further clicks until the player answers.
- Success
-
A Successful dialog appears and closes itself after a second and a half. The player interrupts what it is showing and plays your ad.
- Failure
-
An error dialog stays up until you dismiss it:
Error <code> <reason>.The code and the reason come from the player — see CS Player HTTP API. The common ones are a frame or trigger event the player does not know, and a request the player refuses.
CS Trigger sends the interrupt trigger type: the ad goes on screen at once, cutting the current one short.
The queueing types of the player API — queue, queue-or-interrupt, queue-or-discard — are available to your own integration.
The ad is identified to the player by its advertisement id, so picking the card picks the ad.
Ordering the list
Sort type and the box next to it re-request the list from the player in the order you asked for.
- Id
-
Advertisement id — the default, and the same order the player returns.
- Name
-
Advertisement name. The easiest way to find a specific creative in a long list.
- Last update
-
When the ad was last updated. Puts freshly delivered content at one end.
The second box is the direction: Asc or Desc.
Rendering the cards
Settings → Video decides how much of each video the window renders:
- Record
-
Videos play inside the card, muted. The heaviest mode — every visible card runs its own media player.
- First frame
-
A still is taken from each video and shown in the card. Stills are cached per frame under the user data directory (
~/.local/share/CSTrigger/files/on Linux,%LOCALAPPDATA%\CityScreen\CSTrigger\files\on Windows) and refreshed as content changes; switching to another mode deletes them. - Text only
-
Only the name is shown. This is the default and the fastest mode.
Interactive (HTML5) ads and web-page ads are shown for viewing and do not react to clicks.
If the media file is missing or cannot be decoded, the card shows File not found or File not found or cannot be loaded in red instead of the preview. Clicking such a card still fires the trigger; only the preview on this machine is affected.
Filtering by source
Settings → Campaign filter narrows the list by where the content came from:
- All
-
Everything the player has for the frame.
- Regular videos
-
Your own campaigns only.
- Programmatic videos
-
Content delivered through programmatic demand only.