Supported Partners

The integrations described here are of different kinds. Some are buyers, some are the systems that drive an operator’s screens, and the traffic runs a different way for each.

This page is for anyone reading a system type or server type in the interface and wondering what sits behind it.

The three kinds

Kind Configured as What it is

Demand partner

A system type on a row in the platform-wide registry

A buyer. It acquires airtime on this platform’s faces, by bidding or by its own reserved path. Turned on per organization.

Content management system

A server type on an organization

The system that actually drives an operator’s screens. It supplies the face catalog and, usually, asks what to play. One per organization, fixed at creation.

Exchange

A row of its own, registered by the operator

Another marketplace, connected as a supply relationship.

The first two axes are set out in Integrations. The distinction that matters on this page is direction: a demand partner is something the platform sells to, a content management system is something the platform sells for, and an exchange is something the platform sells through.

Demand partners

A demand partner is registered once, platform-wide, and each organization then enables it with its own credentials. See Managing demand partners.

Three of the partners below buy through the private-deal path, and one buys through its own booking protocol.

HiveStack

Kind

Demand partner (DSP)

Registered as

A system type in the demand-partner registry, one row platform-wide

Direction

Outbound. The platform calls HiveStack.

Buys through

Private deals.

When a slot on an enabled organization’s face comes up under a private deal, the platform asks HiveStack what to play for that screen and maps the creative it names to a campaign, creating one the first time it sees it. The platform also keeps a list of the creatives HiveStack has available for the relevant screens, so that the live answer resolves to something already known. Delivery outcomes are reported back to HiveStack over its own callbacks.

A face is addressed by its screen ID on these calls — HiveStack’s own identifier, stored on the face solely so that HiveStack can be asked about it in its own terms. A face without one cannot be offered. See Inventory for the screen ID.

Vistar

Kind

Demand partner (DSP)

Registered as

A system type in the demand-partner registry, one row platform-wide

Direction

Outbound. The platform calls Vistar.

Buys through

Private deals.

The shape is the same as HiveStack’s: a live ad-decision call per opportunity, a list of available assets kept ahead of time, and outcome reporting over Vistar’s own proof-of-play callback. The platform records the price Vistar reports on its proof-of-play response.

Vistar requires an additional per-organization setting — the network identifier it authenticates against — entered alongside the URL and token on the organization’s connection settings.

VIOOH

Kind

Demand partner (DSP)

Registered as

A system type in the demand-partner registry, one row platform-wide

Direction

Outbound. The platform calls VIOOH.

Buys through

Private deals.

The shape is the same again: a live creative request per opportunity, a regular sync of the creatives VIOOH holds for each face, and play confirmations sent back to VIOOH. A face is addressed by its VIOOH asset ID, stored on the face; a face without one is not offered.

VIOOH requires two additional per-organization settings — the VIOOH market and a separate key for play confirmations — entered alongside the URL and token on the organization’s connection settings.

COT

Kind

Demand partner, with a booking protocol of its own

Registered as

A system type in the demand-partner registry, one row platform-wide

Direction

Both ways.

Buys through

Its own scheduling protocol.

COT is the one demand partner that talks in both directions.

Inbound, COT calls the platform, authenticating with the organization’s access token exactly as any other partner would. Over that surface it reads the organization’s players and their reported issues, submits creatives for review, sets and clears a long-running schedule, and reads back billing proofs and photo captures.

Outbound, the platform calls COT for a short playlist covering the immediate future, and pushes the review verdict on each creative COT submitted.

COT serves organizations whose server type is CityScreen.

Content management systems

A content management system is not registered anywhere. It is a property of the organization — its server type — chosen when the organization is created and fixed thereafter. The consequences are set out in Integrations; what follows is what each one does.

KIS

Kind

Content management system (server type)

Direction

Outbound. The platform pushes to KIS; KIS does not call the platform.

Catalog

File import. The face catalog is loaded from a file.

Ad plays

Cannot be pulled back. The report sent at playout time is the only confirmation.

Once a creative is approved, the platform creates the corresponding advertisement in KIS, amends it when it changes, and deletes it when the campaign stops. Every call is scoped by identifiers agreed with KIS.

The operator loads the catalog by import, and the faces in the file are the faces the platform knows. Creatives submitted without a face list have faces chosen for them by matching the aspect ratio of the media.

SpinetiX

Kind

Content management system (server type)

Direction

Both ways.

Catalog

Pulled from SpinetiX’s own interface.

Ad plays

Cannot be pulled back. The report sent at playout time is the only confirmation.

The platform pulls the face catalog from SpinetiX, and pushes each approved creative to SpinetiX for its own review, then polls for the verdicts. There are two reviews in the chain: a creative confirmed on this platform can still be refused by SpinetiX.

In the other direction, SpinetiX players ask the platform what to play, the same way any player does, and the request goes through the same auction — see Auction.

As with KIS, creatives submitted without a face list have faces chosen for them by aspect ratio.

CubicVision

Kind

Content management system (server type)

Direction

Both ways.

Catalog

Pulled from CubicVision’s own interface, with saturation and availability parameters.

Ad plays

Pulled back on a schedule and reconciled.

The platform pulls the catalog, creates campaigns in CubicVision when creatives are approved, pauses and resumes them as their state changes, amends the faces they run on, pulls their moderation status back, and pulls confirmed ad plays for reconciliation.

Two behaviors are unique to it among the server types described here.

Creative approval waits on CubicVision

A moderation request does not settle inside the platform. Its state moves when CubicVision accepts or refuses the content.

Faces are switched on by hand

On every other server type, whether a face is active follows the synchronization run. On CubicVision an employee activates and deactivates faces themselves, and a synchronization run does not overrule them. See Activation.

In the other direction, CubicVision asks the platform what to play, the same way any player does.

Exchanges

An exchange is a third kind. It is registered at the installation level by the platform operator, and connecting one either draws inventory into this deployment or exposes this deployment’s inventory to it.

Where the counterparty is another CityScreen Context deployment, the two speak the platform’s own SSP protocol to each other, with the consuming side acting as a client of it.

At a glance

Partner Kind Set up as Which way it talks

HiveStack

Demand partner

System type

The platform calls it

Vistar

Demand partner

System type

The platform calls it

VIOOH

Demand partner

System type

The platform calls it

COT

Demand partner

System type

Both ways

KIS

Content management system

Server type

The platform calls it

SpinetiX

Content management system

Server type

Both ways

CubicVision

Content management system

Server type

Both ways

A buyer that speaks the platform’s own SSP protocol needs no bespoke integration — it is registered under the generic SSP system type, of which any number may exist, and that is the route most new demand partners take.