Taboola

The Switchboard Taboola Connector supports automated ingestion of both campaign and revenue summary reports.

Prerequisites

To configure access to the Taboola Connector, you need:

  • Client ID
  • Client Secret

To obtain the Client ID and Secret, contact your Taboola Account Manager. 

Scheduling

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

Campaign Summary Reports

Parameters

Parameter Description Required/Optional?
accounts An option string list of account names to include in the data pull. Optional
dimension   Required

Sample Switchboard Script

import taboola_campaign_summary from {
    type: "taboola:campaign-summary";
    key: "taboola_key";
    dimension: "campaign_breakdown";
    accounts: ["publisher-network"];
} using {
    "ad_cpc": float;
    "account_id": string;
    "ctr": float;
    "page_views_with_ads_pct": float;
    "timestamp": datetime;
    "ad_rpm": float;
    "ad_revenue": float;
    "currency": string;
    "country": string;
    "country_name": string;
    "timezone": string;
    "page_views": integer;
    "clicks": integer;
    "page_views_with_ads": integer;
};

Revenue Summary Reports

Parameters

Parameter Description Required/Optional?
accounts A string… Optional
dimension A string… Required

Sample Switchboard Script

import taboola_revenue_summary from {
    type: "taboola:revenue-summary";
    key: "taboola_key";
    dimension: "country_breakdown";
    accounts: ["publisher-network"];
} using {
    "ad_cpc": float;
    "account_id": string;
    "ctr": float;
    "page_views_with_ads_pct": float;
    "timestamp": datetime;
    "ad_rpm": float;
    "ad_revenue": float;
    "currency": string;
    "country": string;
    "country_name": string;
    "timezone": string;
    "page_views": integer;
    "clicks": integer;
    "page_views_with_ads": integer;
};