Clear Channel Outdoor · Schema

DOOH Display

A digital out-of-home display, billboard, or screen in the Clear Channel Outdoor network that can be addressed by programmatic and direct buyers. Modeled to align with OpenRTB 2.6 DOOH and OpenDirect OOH product semantics.

AdvertisingOut Of HomeOOHProgrammaticDigital Out Of HomeDOOHpDOOHOpenRTBOpenDirectBillboardsTransit AdvertisingAirport AdvertisingAudience MeasurementLocation Data

Properties

Name	Type	Description
id	string	Stable display identifier within the CCO inventory system.
name	string	Human-readable display name (e.g., 'Times Square Spectacular #4').
inventoryCategory	string	Inventory category classification.
format	string	Whether the display is digital or static.
venueType	string	OpenOOH Venue Taxonomy code (e.g., 'roadside_billboard', 'transit_airports').
venueTypeTax	integer	OpenRTB venuetypetax: source taxonomy version. 1 = OpenOOH Venue Taxonomy 1.x.
screen	object	Physical screen properties as modeled by OpenRTB DOOH.
geo	object	Geographic location of the display.
operatingHours	string	Operating hours in ISO 8601 time-interval notation or 'AlwaysOn'.
audienceImpression	object	Audience and impression metrics for this display.
supportedAdFormats	array
transactionTypes	array

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/clear-channel-outdoor/main/json-schema/clear-channel-outdoor-display-schema.json",
  "title": "DOOH Display",
  "description": "A digital out-of-home display, billboard, or screen in the Clear Channel Outdoor network that can be addressed by programmatic and direct buyers. Modeled to align with OpenRTB 2.6 DOOH and OpenDirect OOH product semantics.",
  "type": "object",
  "additionalProperties": false,
  "required": ["id", "venueType", "geo"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable display identifier within the CCO inventory system."
    },
    "name": {
      "type": "string",
      "description": "Human-readable display name (e.g., 'Times Square Spectacular #4')."
    },
    "inventoryCategory": {
      "type": "string",
      "enum": ["Billboard", "StreetFurniture", "Transit", "Airport", "Mall", "Spectacular"],
      "description": "Inventory category classification."
    },
    "format": {
      "type": "string",
      "enum": ["Digital", "Static"],
      "description": "Whether the display is digital or static."
    },
    "venueType": {
      "type": "string",
      "description": "OpenOOH Venue Taxonomy code (e.g., 'roadside_billboard', 'transit_airports')."
    },
    "venueTypeTax": {
      "type": "integer",
      "description": "OpenRTB venuetypetax: source taxonomy version. 1 = OpenOOH Venue Taxonomy 1.x.",
      "minimum": 0
    },
    "screen": {
      "type": "object",
      "description": "Physical screen properties as modeled by OpenRTB DOOH.",
      "properties": {
        "id": { "type": "string" },
        "name": { "type": "string" },
        "fixedScreenSize": { "type": "boolean" },
        "physicalWidth": { "type": "number", "description": "Physical width of the screen surface, in centimeters." },
        "physicalHeight": { "type": "number", "description": "Physical height of the screen surface, in centimeters." },
        "pxRatio": { "type": "number" },
        "resolutionWidth": { "type": "integer" },
        "resolutionHeight": { "type": "integer" }
      },
      "additionalProperties": false
    },
    "geo": {
      "type": "object",
      "description": "Geographic location of the display.",
      "required": ["lat", "lon"],
      "properties": {
        "lat": { "type": "number" },
        "lon": { "type": "number" },
        "country": { "type": "string", "description": "ISO 3166-1 alpha-3 country code." },
        "region": { "type": "string" },
        "city": { "type": "string" },
        "zip": { "type": "string" },
        "dma": { "type": "string", "description": "Designated Market Area code." }
      },
      "additionalProperties": false
    },
    "operatingHours": {
      "type": "string",
      "description": "Operating hours in ISO 8601 time-interval notation or 'AlwaysOn'."
    },
    "audienceImpression": {
      "type": "object",
      "description": "Audience and impression metrics for this display.",
      "properties": {
        "averageDailyImpressions": { "type": "integer", "minimum": 0 },
        "audienceSource": {
          "type": "string",
          "description": "Source of audience measurement (e.g., 'Geopath', 'RADAR')."
        },
        "panelLength": { "type": "integer", "description": "Slot length in seconds." },
        "loopLength": { "type": "integer", "description": "Loop length in seconds." }
      },
      "additionalProperties": false
    },
    "supportedAdFormats": {
      "type": "array",
      "items": { "type": "string", "enum": ["Image", "Video", "HTML5", "Static"] },
      "uniqueItems": true
    },
    "transactionTypes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["Guaranteed", "Non-Guaranteed", "Programmatic Guaranteed", "Private Marketplace", "Open Exchange"]
      },
      "uniqueItems": true
    }
  }
}