Smart Ad Server

The Switchboard Smart Ad connector provides automated access for direct and programmatic campaigns reports.

The Switchboard Smart Ad connector integrates with the Smart Ad Server Reporting API

Prerequisites

To configure access to the Smart Ad connector you will need the following properties:

API Key
Your API Key can be obtained from your service contact at Smart
API Secret
Your API Secret can be obtained from your service contact at Smart

Scheduling

The Smart Ads connector can be scheduled to run at regular intervals, or at specific hours of the day. By default, the connector will run once a day at 6am PT. See Hourly Scheduling for more information.

Sample Switchboard Script

import footballco_smart_ad_server_reports_raw from {
    type: "smart_ad_server:reports";
    key: "smart_ad_server_key";
    network_id: 1234; 
    fields: [
        "Day",
        "SiteId",
        "SiteName",
        "PageId",
        "Domain",
        "CreativeSize",
        "CountryName",
        "DealName",
        "InventoryName",
        "ImpressionTypeName",
        "ServerSideBiddingCallerName",
        "EstimatedNetworkNetRevenueNetworkCurrencyTrueCount",
        "ImpressionsTrueCount"
    ]; 
} using {
    Day: datetime;
    SiteId: integer;
    SiteName: string;
    PageId: integer;
    Domain: string;
    CreativeWidth: string;
    CreativeHeight: string; 
    CountryName: string;
    DealName: string;
    InventoryName: string;
    ImpressionTypeName: string;
    ServerSideBiddingCallerName: string;
    EstimatedNetworkNetRevenueNetworkCurrencyTrueCount: float;
    ImpressionsTrueCount: integer;
};

Parameters

fields list of strings
required
At least one value must be specified to the fields parameter. It should include aggregations and metrics that wanted to be used on the report.

The allowed values are specified in the Smart Ads documentation on Aggregation Criteria and Metric Criteria

Note that only fields with an ‘Availability’ of ‘Rtb’ are allowed

network_id integer
required
Identifier of the network to perform api requests. Each Smart customer receives this identifier for a dedicated network (work space) for inventory setup, campaign management, reporting etc.

See how to determine your network id.