Taboola Connector Reference

32 metrics38 dimensions

Fields

https://connectors.windsor.ai/taboola?api_key=[your API key]&date_preset=last_7d&fields=campaign,campaign_name,campaigns_num,clicks,conversions_value,cpa,cpa_actions_num,cpa_actions_num_from_clicks,cpa_actions_num_from_views,cpa_clicks,cpa_conversion_rate,cpa_conversion_rate_clicks,cpa_conversion_rate_views,cpa_views,cpc,cpm,ctr,currency,date,impressions,roas,spend,spent,totalcost,vcpm,vctr,visible_impressions,&_renderer=csv

The Taboola connector exposes 70 fields (32 metrics, 38 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.

Taboola Fields

Taboola Campaign fields

The Campaign report of the Taboola connector includes 14 fields.

ID	Type	Name	Description
campaigns_num	NUMERIC	Campaigns Num	Number of campaigns (visible for relevant dimensions only e.g. day, week, month).
conversions_value	NUMERIC	Conversions Value	Total revenue from conversions
cpa_actions_num_from_clicks	NUMERIC	CPA Actions Num From Clicks	Total number of click through actions (conversions).
cpa_actions_num_from_views	NUMERIC	CPA Actions Num From Views	Total number of view through actions (conversions)
cpa_clicks	NUMERIC	CPA Clicks	Click Cost Per Action (Conversion) = Spent/Click Through Conversions (considers conversions attributed via click throughs only).
cpa_conversion_rate	PERCENT	CPA Conversion Rate	Conversion Rate (%) = Conversions/Clicks*100 (considers all conversions)
cpa_conversion_rate_clicks	PERCENT	CPA Conversion Rate Clicks	Click Conversion Rate (%) = Click Through Conversions/Clicks (considers conversions attributed via click throughs only)
cpa_conversion_rate_views	PERCENT	CPA Conversion Rate Views	View Conversion Rate (%) = View Through Conversions/Clicks (considers conversions attributed via view throughs only).
cpa_views	NUMERIC	CPA Views	View Cost Per Action (Conversion) = Spent/View Through Conversions (considers conversions attributed via view throughs only).
roas_clicks	PERCENT	ROAS Clicks	Return On Ad Spend for Click Through Conversions (%)
roas_views	PERCENT	ROAS Views	Return On Ad Spend for View Through Conversions (%)
site	TEXT	Site	Alphabetic Site ID (aka Account ID) e.g. "demo-site"
site_id	TEXT	Site ID	Numeric string of Site ID (aka Account ID) e.g. "1023"
site_name	TEXT	Site Name	Site Name e.g. "Demo Site"

Taboola Common fields

The Common report of the Taboola connector includes 22 fields.

ID	Type	Name	Description
account_id	TEXT	Account ID	The ID of the account.
account_name	TEXT	Account Name	The name of the account (same as account_id).
adnetwork_conversions	NUMERIC	CPA Actions Num (copy of `cpa_actions_num`)	Total number of actions (conversions)
adnetwork_revenue	NUMERIC	Conversions Value (copy of `conversions_value`)	Total revenue from conversions
campaign	TEXT	Campaign	Human-readable campaign name.
campaign_id	TEXT	Campaign	A numeric string. Represents the unique ID of a campaign.
clicks	NUMERIC	Clicks	Total clicks
cpa	NUMERIC	CPA	Cost Per Action (Conversion) = Spent/Conversions (considers all conversions)
cpa_actions_num	NUMERIC	CPA Actions Num	Total number of actions (conversions)
cpc	NUMERIC	CPC	(Actual) Cost Per Click= spent/clicks
cpm	NUMERIC	CPM	Cost Per 1000 Impressions= spent/impressions * 1000
ctr	PERCENT	CTR	Click Through Rate (%)= clicks/impressions * 100
currency	TEXT	Currency	The currency for columns of type Money
date	DATE	Date	The start date for the reporting period.
impressions	NUMERIC	Impressions	Total impressions, known as Served Ads. Total number of times your ad is loaded on a page
roas	PERCENT	ROAS	Return On Ad Spend (%)
spend	NUMERIC	Spend (duplicate of `spent`)	Total spent (on campaign bidding) (duplicate)
spent	NUMERIC	Spent	Total spent (on campaign bidding)
totalcost	NUMERIC	Total Cost	The Media Spend (Duplicate)
vcpm	NUMERIC	VCPM	Cost Per 1000 Viewable Impressions= spent/visible_impressions * 1000
vctr	PERCENT	VCTR	Viewable Click Through Rate (%)= clicks/visible_impressions
visible_impressions	NUMERIC	Visible Impressions	Total viewable impressions. How many times your ad is actually seen by a user

Taboola ConversionRules fields

The ConversionRules report of the Taboola connector includes 8 fields.

ID	Type	Name	Description
conversion_rule_category	TEXT	Conversion Rule Category	Taboola conversion category (e.g. LEAD, VIEW_CONTENT, MAKE_PURCHASE).
conversion_rule_conversions	NUMERIC	Conversion Rule Conversions	Number of conversions attributed to this rule.
conversion_rule_cpa	NUMERIC	Conversion Rule CPA	Cost per acquisition for this rule.
conversion_rule_cvr	PERCENT	Conversion Rule CVR	Conversion rate for this rule.
conversion_rule_id	TEXT	Conversion Rule ID	Unique numeric ID of the Taboola conversion rule.
conversion_rule_name	TEXT	Conversion Rule Name	Human-readable conversion rule name (display_name). Use as the join key across data sources.
conversion_rule_roas	PERCENT	Conversion Rule ROAS	Return on ad spend for this rule.
conversion_rule_value	NUMERIC	Conversion Rule Value	Conversion value (revenue) attributed to this rule.

Taboola Item fields

The Item report of the Taboola connector includes 8 fields.

ID	Type	Name	Description
item	TEXT	Item	The unique title (display name) of the Item.
item_custom_id	TEXT	Item Custom ID	The custom ID of the creative (ad), if you provided one.
item_custom_name	TEXT	Item Custom Name	The custom name of the creative (ad), if you provided one.
item_description	TEXT	Item Description	The description of the Item.
item_id	TEXT	Item ID	The unique id of the Item. (A numeric string)
item_learning_display_status	TEXT	Item Learning Display Status	The learning status of the Item. Possible values: EMPTY_DISPLAY (also known as NONE), EXPEDITED_LEARNING, LEARNING, LEARNING_COMPLETE, LEARNING_LIMITED (insufficient events for learning).
item_thumbnail_url	IMAGE_URL	Item Thumbnail URL	The thumbnail URL of the Item.
item_url	TEXT	Item URL	The url of the Item.

Taboola other fields

The Taboola connector has 18 fields that do not belong to a named report, or belong to a report with only one or two fields.

ID	Type	Name	Description
data_fetched_at	TIMESTAMP	Data fetched at	UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasource	TEXT	Data Source	The name of the Windsor connector returning the row
day_of_month	TEXT	Day of month	Day of the month
month	TEXT	Month	Number of the month
now	TIMESTAMP	Now	Current timestamp
source	TEXT	Source	The name of the Windsor connector returning the row
today	DATE	Today	Today's date
week	TEXT	Week	Week (Sun-Sat).
week_day	TEXT	Day of week and day number	Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_iso	TEXT	Day of week and day number, ISO	Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_iso	TEXT	Week ISO	Week, ISO format (Mon-Sun).
year	TEXT	Year	Year
year_month	TEXT	Yearmonth	Year and month, e.g. 2024\|3
year_month_name	TEXT	Year month name	Year and month with the month name written out, e.g. "Jan 2025".
year_of_week	TEXT	Year of week	The year that contains first day of the week (Sun-Sat).
year_of_week_iso	TEXT	Year of week, ISO	The year that contains first day of the ISO week (Mon-Sun).
year_week	TEXT	Year week	Year and week for US weeks (Sun-Sat), e.g. 2024\|15
year_week_iso	TEXT	Year week ISO	Year and week for ISO weeks (Mon-Sun), e.g. 2024\|20

API Connectors