Taboola Field Reference

Sample

 

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


Fields

IDTypeNameDescription
adnetwork_conversionsNUMERICCPA Actions Num (copy of `cpa_actions_num`)Total number of actions (conversions)
adnetwork_revenueNUMERICConversions Value (copy of `conversions_value`)Total revenue from conversions
campaignTEXTCampaign NameHuman-readable campaign name.
campaign_idTEXTCampaignA numeric string. Represents the unique ID of a campaign.
campaigns_numNUMERICCampaigns NumNumber of campaigns (visible for relevant dimensions only e.g. day, week, month)
clicksNUMERICClicksTotal clicks
conversions_valueNUMERICConversions ValueTotal revenue from conversions
cpaNUMERICCPACost Per Action (Conversion) = Spent/Conversions (considers all conversions)
cpa_actions_numNUMERICCPA Actions NumTotal number of actions (conversions)
cpa_actions_num_from_clicksNUMERICCPA Actions Num From ClicksTotal number of click through actions (conversions) --Look-back window is configurable per conversion rule (default = 30 days)
cpa_actions_num_from_viewsNUMERICCPA Actions Num From ViewsTotal number of view through actions (conversions) --Look-back window is 24 hours (fixed)
cpa_clicksNUMERICCPA ClicksClick Cost Per Action (Conversion) = Spent/Click Through Conversions (considers conversions attributed via click throughs only)
cpa_conversion_rateNUMERICCPA Conversion RateConversion Rate (%) = Conversions/Clicks*100 (considers all conversions)
cpa_conversion_rate_clicksNUMERICCPA Conversion Rate ClicksClick Conversion Rate (%) = Click Through Conversions/Clicks (considers conversions attributed via click throughs only)
cpa_conversion_rate_viewsNUMERICCPA Conversion Rate ViewsView Conversion Rate (%) = View Through Conversions/Clicks (considers conversions attributed via view throughs only)
cpa_viewsNUMERICCPA ViewsView Cost Per Action (Conversion) = Spent/View Through Conversions (considers conversions attributed via view throughs only)
cpcNUMERICCPC(Actual) Cost Per Click= spent/clicks
cpmNUMERICCPMCost Per 1000 Impressions= spent/impressions * 1000
ctrPERCENTCTRClick Through Rate (%)= clicks/impressions * 100
currencyTEXTCurrencyThe currency for columns of type Money
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateThe start date for the reporting period.
day_of_monthTEXTDay of monthDay of the month
impressionsNUMERICImpressionsTotal impressions
monthTEXTMonthNumber of the month
roasPERCENTROASReturn On Ad Spend (%)
sourceTEXTSourceThe name of the Windsor connector returning the row
spendNUMERICSpend (duplicate of `spent`)Total spent (on campaign bidding) (duplicate)
spentNUMERICSpentTotal spent (on campaign bidding)
todayDATETodayToday's date
totalcostNUMERICTotal CostThe Media Spend (Duplicate)
vcpmNUMERICVCPMCost Per 1000 Viewable Impressions= spent/visible_impressions * 1000
vctrPERCENTVCTRViewable Click Through Rate (%)= clicks/visible_impressions
visible_impressionsNUMERICVisible ImpressionsTotal viewable impressions
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20