Teads

The Switchboard Teads connector provides automated ingestion of outstream video and native video advertising metrics.

Prerequisites

To configure access to the Teads Connector, you need:

  • Email 
  • Access Token

To obtain the Email or Access Token, contact your Teads Account Manager.

Scheduling

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

Switchboard Script Syntax

import teads_api_raw from {
   type: "teads_ng";
   key: "teads_api_token";
   dimensions: [
       "day",
       "placement",
       "advertiser",
       "ad_type",
       "adsource",
       "page",
       "country_code",
       "country",
       "website",
       "website_domain",
       "device",
       "connection_type",
       "demand_source"
   ];
   metrics: [
       "start",
       "complete",
       "click",
       "impression",
       "firstQuartile",
       "midpoint",
       "thirdQuartile",
       "teads_billing"
   ];
   } using {
       date: datetime("YYYY/MM/dd");
       placement: string;
       advertiser: string;
       ad_type: string;
       adsource: string;
       page: string;
       country_code: string;
       country: string;
       website: string;
       website_domain: string;
       device: string;
       connection_type: string;
       demand_source: string;
       start: string;
       complete: string;
       click: string;
       impressions: string;
       firstQuartile: string;
       midpoint: string;
       thirdQuartile: string;
       teads_billing: string;
   };

Parameters

Parameter

Description

Required/Optional?

metrics

A list of requested metrics.

For the Metrics description, see the Teads API documentation.

Required

dimensions

A list of requested dimensions.

For the dimensions description, see the Teads API documentation.

At least one value is required.

filters

A list of dimensions to filter results: 

filters: {"buyer_type":["office"];};

Optional