Terminology
CityScreen Deals uses some terms in more than one sense, or in a sense that differs from the standard out-of-home advertising vocabulary. This page lists those terms and explains which meaning applies where.
For general OOH/DOOH industry definitions, see the industry glossary. For the core vocabulary of CityScreen Deals explained in narrative form, see key concepts.
Administrator
The word "administrator" appears in three distinct contexts:
| Context | Meaning |
|---|---|
Platform administrator |
A CityScreen staff member who creates organizations and sets up their profile. This person operates outside any single organization. |
Organization owner (main admin) |
The employee whose account is marked as the organization’s main administrator. This employee has unconditional access to everything in the organization that the license includes — the system bypasses all permission checks for this account. The license is not bypassed: a function that your organization does not have is refused for everyone, the main administrator included. |
Admin role holder |
An employee whose role is marked as an admin role. This grants broad administrative permissions within the organization, and the permission model still applies to the account. |
When this documentation says "administrator" without qualification, it means the organization owner or an employee with an admin role — the person who configures the organization.
Criteria / tag
The interface labels this concept "Criteria".
The API calls the same concept Tag.
Criteria are classification labels scoped to customers, deals, or inventory items. There is one shared set of criteria per organization; each criterion declares which scopes it applies to.
See criteria.
Data type / variable
The interface labels a field on an entity type "Data Type" (the section in the admin UI is called "Data Types").
The API calls the same concept Variable.
A variable defines a field’s name, its value type (string, number, date, link, set, collection, map, or expression), and its behavior (required, unique, filterable).
See data types.
Display side / face
The interface sometimes shows "Side" as a field label on a display. The canonical term in the industry glossary is face — one advertising surface on a physical structure.
This documentation uses "face" throughout.
See inventory.
Format
The industry glossary defines format using the US OOH taxonomy (bulletin, poster, junior poster, and so on). In CityScreen Deals, format is a free-text, per-organization field — administrators enter whatever names their market uses.
The default values that new organizations start with (Billboard, Supersite, Cityboard, Cityformat, Mediafacade) reflect Russian/CIS market nomenclature and differ from the US taxonomy. Digital display format is auto-derived from aspect ratio and placement type.
See formats.
Funnel
The interface shows a label "Funnel name" next to the current deal stage. This is a static label for the single implicit deal pipeline that every organization has.
The word refers to the fixed seven-stage deal pipeline.
See deal stages.
Group name / machine name
An employee group has a Name, which people read, and a Machine name, which other systems read.
The machine name is generated from the name when the field is left empty, and it cannot be changed after the group is created.
LDAP and the OpenID Connect groups claim identify a group by its machine name; the claim group_names carries the names.
See employee groups.
Instance / execution
In the process automation module, the top-level navigation shows "Instances" and a per-process tab shows "Executions". Both refer to the same concept: a single run of a business process definition.
This documentation uses "process instance" as the canonical term.
Proposal type / item type
The phrase "proposal type" can refer to two independent attributes:
| Attribute | Meaning |
|---|---|
Pricing model |
Determines how the proposal is priced.
Values: |
Inventory binding |
Determines what inventory the proposal can sell against.
A directory proposal can have an item type of |
The pricing model and the inventory binding are independent. A custom proposal type can sell against digital displays while using directory-style pricing.
See proposals.
Report
The interface has a "Reports" section. In CityScreen Deals, a report is a batch document mail-merge — the system generates one document per record from a template and a data set.
Reports are not analytics dashboards. The dashboards section is a separate feature.
See batch reports and dashboards.
Rotary
In CS Deals, Rotary is a value of a printed display’s mechanism type: a structure that shows several posters in turn on one face. It covers 2 kinds of structure that media owners sell as different inventory: scrolling panels (scrollers) and tri-vision units (rotating prisms). The value does not tell them apart. To tell them apart, use the display name or a custom field.
In US out-of-home usage, "rotary" means something else: a rotary bulletin is a painted bulletin that moves between pre-approved locations from time to time. To avoid that reading, this documentation says "scrolling panels and tri-vision units" wherever both are meant and keeps Rotary for the field value only.
See printed displays.
Schedule
The industry glossary defines a schedule as a playback schedule with time slots and rotation order. In CityScreen Deals, a display schedule is narrower: it defines the weekly operating hours (on/off times) for a display.
CityScreen Play manages content scheduling and playback rotation.
See digital displays.
Second factor / two-step verification
The interface and this documentation say two-step verification for the code that sign-in asks for after the password. Second factor is the same thing in security vocabulary, and it is the term a security questionnaire is likely to use.
Sign out / log out
The icon in the header has the tooltip Log out, and the page an application opens to end your session says Sign out. Both end the current session. Neither revokes the access you gave to applications, which lasts until you revoke it. This documentation says "sign out" in prose and quotes each label where it appears.
See signing in and out.
Static
The word "static" appears in two unrelated contexts:
| Context | Meaning |
|---|---|
Installation kind |
A display whose installation kind is static is physically stationary (as opposed to mobile or route-based). This says nothing about the display technology. |
Display type (mechanism) |
A printed display with the mechanism type Static shows 1 poster on each face. The other value, Rotary, is a scrolling panel or a tri-vision unit, which shows several posters in turn on one face. This says nothing about whether the display is stationary. |
A display can be static in one sense without being static in the other.
Token
The word "token" appears in three distinct contexts:
| Context | Meaning |
|---|---|
Session token |
The credential that keeps an employee signed in after sign-in. Expires after the organization’s session duration. |
Password-reset token |
A one-time link sent by e-mail when a password reset is requested. |
Booking widget token |
The public token in the booking widget’s embed snippet, which starts a widget session. |
See your account for session tokens, signing in and out for the password-reset link and booking widget for the widget token.
Widget
The word "widget" appears in two unrelated contexts:
| Context | Meaning |
|---|---|
Dashboard widget |
A visual component on the dashboard — a chart, counter, or table showing sales or saturation data. |
Booking widget |
An embeddable public page that lets external users browse inventory and submit booking requests without signing in. |
See widget reference for dashboard widgets and booking widget for the public embeddable page.
Candidate group
In BPMN process definitions, a user task can be assigned to a candidate group. In CityScreen Deals, a candidate group resolves to an employee group — the task is offered to all members of that employee group.
Candidate groups are not related to roles. A candidate group is the BPMN term for an employee group.
See user tasks and forms and employee groups.
Document template / document type
These are two distinct concepts:
| Term | Meaning |
|---|---|
Document type |
An entity type belonging to the Document super type. The administrator defines document types (invoice, contract, booking order) as entity types with custom fields. |
Document template |
A file (typically XLSX with placeholders) that defines the layout of a generated document. A document type can have one or more templates. |
See document records and templates.
CityScreen Context / SSP integration
The interface labels this integration "SSP integration" in some places. The product name is CityScreen Context — it is the component that exposes available inventory to programmatic demand-side platforms.
This documentation uses "CityScreen Context" as the canonical name.
See CityScreen Context.
Overbooking
The industry glossary defines overbooking as selling more inventory than physically available.
CityScreen Deals refuses overbooking at three points: the inventory picker hides fully booked displays, saving a proposal re-checks every display in every period, and moving a deal to Reserved or Booked checks them once more. The last two reject outright, and no permission overrides that rejection.
One limit is worth stating plainly:
-
Only Booked capacity counts. A display held by a Reserved proposal is offered as free to everyone else. The saturation timeline draws the reservation; the availability checks do not read it.