Primis

The Primis connector supports automated ingestion of Primis reports.

⚠ ️Support for v.2.12 has been deprecated. Switchboard requires v2.16 or v2.19

Prerequisites

Primis require you create a Key in the Key Editor with the Username and Password credentials credentials for the Primis Platform API (contact your assigned Primis account manager).

Scheduling

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

Parameters

api_version string

optional

Switchboard requires v2.16 or v2.19

dimensions string list

required

The dimensions filter determines the desirable objects in your report response, i.e. what objects are needed to be “grouped by”. Placement, Campaign, Browser and Country are dimension examples. See the Media Report Type Values in the Reference section of the Primis API documentation for the full set of possible values.

metrics string list

required

Metrics are different types of quantitative measurement parameters, by which Primis collects statistics, e.g. Attempts, Impressions or Revenue. See the Metric Definitions for the Primis Media Report for the full set of supported metrics.

time_interval string

optional

Allowed values include: cumulative, hour, date, month

time_zone string

required for version 2.19

Allowed values include: us_pacific, us_eastern,us_mountain,eu_moscow, eu_london, eu_central, au_sydney, asia_tokyo, asia_israel, utc+0, utc-5

Sample SBS

download t from {
    type: "primis:ad_server";
    key: "primis_key";
    dimensions: ["browser"];
    metrics: ["id","name","ad_imps","ad_cpm","ad_revenue"];
    time_interval: "cumulative";
    api_version: "2.19";
    time_zone: "utc+0";
} using { * };