SpringServe

The Switchboard Connector for SpringServe provides automated daily reporting of programmatic advertising campaigns.

Prerequisites

To configure access to the SpringServe Connector, you need:

  • Username
  • Password

Scheduling

The SpringServe 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.

Supported Dimensions

Dimension/Metric Description
app_bundle Bundle identifier of the mobile app.
app_name Name of the mobile app where the ad is displayed.
buying_demand_tag_id Identifier for the demand tag associated with buying ad inventory.
campaign_code Code identifying the specific advertising campaign.
country Country of the user requesting the ad.
declared_domain Domain declared by the publisher for the ad placement.
declared_player_size Player size declared by the publisher for the video ad.
demand_code Code identifying the specific demand source serving the ad.
demand_partner_id Identifier for the demand partner serving the ad.
demand_tag_id Identifier for the demand tag associated with an ad request.
demand_tag_label Label assigned to the demand tag.
demand_type Type of demand source (e.g., direct, programmatic).
detected_domain Domain detected by SpringServe for the ad placement.
detected_player_size Player size detected by SpringServe for the video ad.
device_id Identifier for the device requesting the ad.
environment Environment in which the ad is served (e.g., web, in-app).
key_values (key:my_value) Additional key-value pairs passed in the ad request, providing targeting or contextual information.
marketplace_type Type of marketplace (e.g., open exchange, private marketplace).
os_id Identifier for the operating system of the device.
selling_supply_tag_id Identifier for the supply tag associated with selling ad inventory.
supply_partner_id Identifier for the supply partner providing the ad inventory.
supply_tag_id Identifier for the supply tag used to serve ads.
supply_tag_label Label assigned to the supply tag.
supply_type Type of supply source (e.g., website, app).
vpaid_type Type of VPAID (Video Player-Ad Interface Definition) implementation.

Sample Switchboard Script


import springserve from {
    type: "spring_serve:report";
    key: "springserve_credential";

    dimensions: [
        "supply_tag_id",
        "environment",
        "demand_tag_id",
        "device_id",
        "country"];
    
    //Interval may be "hour" or "day".
    interval: "day";

    report_timezone: "UTC";
    timezone: 'UTC';
} using {
    date: datetime;
    demand_tag_id: string;
    demand_tag_name: string;
    country_code: string;
    device_id: string;
    environment: string;
    supply_tag_id: integer;
    supply_tag_name: string;
    total_impressions: integer;
};