Configuration

This page lists the settings that change how CityScreen Context behaves, in one place.

It is for whoever administers an organization — its owner or admin. Each entry says what the setting does, which screen it lives on, which role may change it, and the value it starts with. Where another page explains a setting, the entry here is one line and a link.

Two conventions apply throughout.

Roles named in the Who column are employee roles unless the entry says platform administrator, which is a separate role belonging to the operator of the installation and not to any organization. Screens are named by their route — /settings/common, for example — where the setting lives on a screen inside the client cabinet.

Organization settings

Client cabinet, /settings/common. Six settings, all of them owner or admin, all of them audited with their before and after values.

Setting Default Notes

Tax rate

20

Applied to the organization’s amounts. Accepted range is 0 to 100.

Strict resolution matching

off

Changes which creative is chosen when several could play on a face.

Days of inactivity before a campaign is paused

30

Cannot be set below 7. See Campaign states.

Days paused before a campaign is stopped

180

Cannot be set below 180.

HTML creatives

off

Offered where the installation enables HTML creatives.

Auto-moderation

empty

The demand partners whose creatives are confirmed on arrival with no human review. See Automatic approval.

Organization setup explains what each one does.

The connection to the content management system

Client cabinet, /settings/inventory-sync. Owner or admin.

Setting Default Notes

Address of the content management system

none

The base address the platform pulls the catalog, pushes creatives and pulls playout from.

Token

none

The credential the platform presents to the content management system. It is not the same credential as the access token, and the two point in opposite directions.

Operator identifier

none

Identifies the operator to the content management system, and is also checked against the identifier sent with every ad request.

Additional parameters

none

Which extra fields exist depends on the integration type, which the platform administrator fixes on the organization.

Saving these settings puts the organization into the scheduled catalog pull and playout pull. Connect your CMS walks the whole procedure; Synchronization describes what the pull does.

Demand partners

Client cabinet, /settings/agencies. Owner, admin or manager, and the platform administrator on behalf of an organization.

A demand partner has to exist on the instance before an organization can enable it. Registering one is platform administrator work.

Setting Default Notes

Enabled, per partner

off

Nothing is offered to a partner an organization has not enabled.

Per-partner credentials and address fields

none

Which fields appear depends on the partner’s integration type.

Access token

generated with the organization

The credential the operator’s own systems use to send ad requests. Reissuing it is owner or admin and re-asks for your own password.

Prices

Client cabinet. Owner, admin or manager may create and change; a viewer may read.

Setting Where Notes

Real-time-bidding price lists, with their floor prices

/prices

One is the organization’s default. See Price lists and Floor prices.

Automated guaranteed price lists, with their price grids

/policies

Carry a maximum allowed overbooking, which cannot be set below 100 percent. See Automated guaranteed prices.

Programmatic guaranteed price lists

/rtb-prices

See Programmatic guaranteed.

Target audiences

Client cabinet, on the face

Used by audience-based floor prices.

Per-face bid settings

On the face, bids tab

Which price list a face sells under.

Price lists describes the three price list screens.

Commission and tariffs

Platform administrator only, at every level. None of these has a screen inside the client cabinet.

Setting Default

Organization commission and minimum floor price

A commission of 0 and a minimum floor of 0.01 per second on the creation form. The commission must be raised above zero before the organization sells — see Set the organization tariff.

Flat price for COT ad plays

0.05

Inventory tariffs, one commission over a named set of faces

none created

Commission per deal type — platform-wide, per organization, per organization and partner

unset at every level, which means the level above answers

Fees and commission describes the order the four levels are consulted in.

Technical requirements

Client cabinet, under Technical requirements for the organization note and on the face itself for a face note. The Edit button is offered to owner, admin and manager; every other role reads.

Setting Default Notes

Organization requirements text

empty

Rich text. Returned to demand partners that ask.

Attached PDF documents

none

Quotas apply — see Limits.

Face requirements text

empty

Per face, and separate from the organization note.

People and access

Setting Where Who Default

Employees and their roles

/employees

Owner, admin

The owner created with the organization

Positions, and which review step each covers

/positions

Owner, admin

none created

The organization profile — one legal identity for the whole organization

/settings/profile

Owner, admin

empty until filled in

Legal entities — several identities, each with its own faces

Client cabinet, Legal entities

Owner, admin

none created

How many legal entities may be active at once

—

Platform administrator

1

Whether the organization is enabled at all

—

Platform administrator

enabled

Notification subscriptions

Client cabinet, /account/notifications. Each employee changes their own, and nobody in the organization changes a colleague’s.

Setting Default Notes

A new moderation request arrived

on, over electronic mail

Offered to owner, admin, manager and moderator, and switched on for those four roles when the employee is created.

A moderation request changed state

on, over electronic mail

Same four roles, same treatment.

The delivery channels are fixed for the installation. See Notifications.

  • Limits — quotas, timing budgets and page sizes.

  • Data retention — how long each kind of record survives.

  • Audit — where a change to any of these settings is recorded.