Colossus

The Colossus connector provides automated access to the Colossusssp inventory management API

Prerequisites

The Colossus connector requires you create a Colossus Key in the Key Editor with the following properties:

Email
The email address you use to authenticate your Colossus account
Password
The password you use to authenticate your Colossus account

Scheduling

The Colossus connector can be scheduled to ingest data once per day at a user-defined hour and timezone.

By default, the connector will run once at 6am PT.

See Daily Scheduling for more information.

General Report

Parameters

attribute string list
optional
Allowed values include:
  • country
  • traffic
  • inventory
  • placement
  • address
address_filter string list
optional
Domain for site or Bundle for app (e.g. “supply.colossusssp.com”)
country_filter string list
optional
Allowed values include any country specified in an ISO 3166-1 alpha-3 country code.
inventory_filter integer list
optional
A list containing the unique identifiers of Inventory instances belonging to an account. For more info see the Inventory Report below.
placement_filter integer list
optional
A list containing the unique identifiers of Placement instances belonging to an account. For more info see the Placement Report below.
traffic_filter string list
optional
allowed values are:
  • banner
  • video
  • native
time_zone string list
optional
A timezone abbreviation. The default value is UTC.

Sample SBS Script

download t from {
                type: "colossus:report";
                key: "colossus_key";
                timezone: "UTC";
                country_filter: ["USA", "URY"]; 
                traffic_filter: ["banner"];
                placement_filter: [56437, 62645];
                inventory_filter: [64767. 42674];
                address_filter: ["something.com"];
            } 
using { * };

Inventory Report

Data about website or mobile apps registered on the SSP

Sample SBS Script

download t from {
    type: "colossus:inventory";
    key: "colossus_key";
} using { * };

Placement Report

Data about the particular places in your inventory which is able to display banner or video advertising

Sample SBS Script

download t from {
    type: "colossus:placement";
    key: "colossus_key";
} using { * };