Destinations
Data sources
AI insights
About us
Careers
Security
Customer reviews
Contact us
Affiliate program
Solution partners
Template gallery
Looker Studio templates
Power BI templates
Excel templates
Google Sheets templates
Tableau templates
Facebook Ads templates
Google Ads templates
Data fields & Metrics
AI prompt library & Guides
Product documentation
API documentation
Case studies
Blog
Data models
Windsor vs Supermetrics
Windsor vs Funnel.io
Windsor vs Fivetran
Windsor vs Rivery
Windsor vs Portermetrics
Windsor vs Coupler.io
Send your Taboola data to
Taboola Connector Reference
32 metrics38 dimensions
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 | 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 | 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 |