Insticator

The Insticator Connector provides automated access to the Insticator Report API

Prerequisites

Your Insticator account manager will provide you with a secret API Key that will be required for the Insticator Key you create in Switchboard.

Scheduling

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

This connector allows repulls and lookbacks.

Parameters

The Insticators Connector provides the ability to specify dimensions and metrics as part of a data query, providing comparable functionality to the Triplelift Console functionality.

device_filters string list
optional
The following values are allowed: MOBILE, DESKTOP
dimensions string list
required
The following values are allowed: DATE, YEAR, WEEK, MONTH,QUARTER, PRODUCT_TYPE, SITE
geo_filters string list
optional
ANSI country code, e.g. US, CA, UK
metrics string list
required
The following values are allowed: NET_REVENUE, TOTAL_IMPRESSIONS, MONETIZABLE_PAGE_VIEW, AVG_RPM,VIEWABILITY, BID_RATE, WIN_RATE, AD_REQUEST
site_filters string list
optional
Unique identifier TODO: unclear what this corresponds to in the API

Sample Switchboard Script

idownload t from {
    type: "insticator";
    key: "insticator_key";
    dimensions: ["DATE","SITE"];
    metrics: ["NET_REVENUE","TOTAL_IMPRESSIONS"];

    geo_filters: ["US","CA","UK"];
    device_filters: ["DESKTOP","MOBILE"];
    site_filters: ["a88fc595-6a9f-4971-b375-127c83ad4fa4","3d87e3fa-245c-4672-b7a9-93b5b5f94386"];
} using { c1: integer; };