Taboola: Most-used fields

The table below gives information about most-used fields that you can import from Taboola. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Custom Conversions {PLACEHOLDER}: CPA	Custom Conversions {PLACEHOLDER}: CPA	Cost Per Action for a specific custom conversion event. The placeholder indicates the name of the custom conversion.	metric
Custom Conversions {PLACEHOLDER}: CPA (Clicks)	Custom Conversions {PLACEHOLDER}: CPA (Clicks)	Cost Per Action specifically calculated based on clicks for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: CPA (Views)	Custom Conversions {PLACEHOLDER}: CPA (Views)	Cost Per Action specifically calculated based on views (impressions) for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: CVR	Custom Conversions {PLACEHOLDER}: CVR	Conversion Rate for a specific custom conversion event. The placeholder indicates the name of the custom conversion.	metric
Custom Conversions {PLACEHOLDER}: CVR (Clicks)	Custom Conversions {PLACEHOLDER}: CVR (Clicks)	Conversion Rate specifically calculated based on clicks for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: CVR (Views)	Custom Conversions {PLACEHOLDER}: CVR (Views)	Conversion Rate specifically calculated based on views (impressions) for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: Conversions	Custom Conversions {PLACEHOLDER}: Conversions	The total number of occurrences for a specific custom conversion event. The placeholder indicates the name of the custom conversion.	metric
Custom Conversions {PLACEHOLDER}: Conversions (Clicks)	Custom Conversions {PLACEHOLDER}: Conversions (Clicks)	The number of occurrences for a specific custom conversion event, attributed to clicks.	metric
Custom Conversions {PLACEHOLDER}: Conversions (Views)	Custom Conversions {PLACEHOLDER}: Conversions (Views)	The number of occurrences for a specific custom conversion event, attributed to views (impressions).	metric
Custom Conversions {PLACEHOLDER}: ROAS	Custom Conversions {PLACEHOLDER}: ROAS	Return on Ad Spend for a specific custom conversion event. The placeholder indicates the name of the custom conversion.	metric
Custom Conversions {PLACEHOLDER}: ROAS (Clicks)	Custom Conversions {PLACEHOLDER}: ROAS (Clicks)	Return on Ad Spend specifically calculated based on clicks for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: ROAS (Views)	Custom Conversions {PLACEHOLDER}: ROAS (Views)	Return on Ad Spend specifically calculated based on views (impressions) for a given custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: Value	Custom Conversions {PLACEHOLDER}: Value	The monetary value associated with a specific custom conversion event. The placeholder indicates the name of the custom conversion.	metric
Custom Conversions {PLACEHOLDER}: Value (Clicks)	Custom Conversions {PLACEHOLDER}: Value (Clicks)	The monetary value attributed to clicks for a specific custom conversion event.	metric
Custom Conversions {PLACEHOLDER}: Value (Views)	Custom Conversions {PLACEHOLDER}: Value (Views)	The monetary value attributed to views (impressions) for a specific custom conversion event.	metric
Report End Date	Report End Date	The end date for the reporting period.	dimension
Report Start Date	Report Start Date	The start date for the reporting period.	dimension
account_id	account_id	Unique identifier for the advertiser’s account.	dimension
account_name	account_name	The name associated with the Taboola account. This identifies the entity managing campaigns or receiving revenue.	dimension
actions	actions	The total number of user actions or conversions recorded, based on defined conversion rules. This is a general measure of user engagement with desired outcomes.	metric
campaign	campaign	The unique identifier for a specific campaign.	metric
campaign_cpa_goal	campaign_cpa_goal	The target Cost Per Action (CPA) that the campaign aims to achieve.	metric
campaign_name	campaign_name	The name of the advertising campaign.	dimension
clicks	clicks	The total number of clicks on the campaign’s ads or items.	metric
content_provider	content_provider	The identifier for a content provider. This dimension is used to break down report data by the source of the content.	metric
content_provider_name	content_provider_name	The name of the content provider. This provides a descriptive name for the content provider identifier.	dimension
conversions_value	conversions_value	The total monetary value generated from conversions.	metric
cpa	cpa	Cost Per Action, representing the average cost for each conversion or desired action.	metric
cpa_actions_num	cpa_actions_num	The number of actions or conversions achieved that are associated with a Cost Per Action (CPA) campaign goal. These actions are defined by conversion rules.	metric
cpa_conversion_rate	cpa_conversion_rate	The rate at which users complete a desired action after engaging with an ad, calculated as the number of CPA actions divided by relevant impressions or clicks.	metric
cpc	cpc	Cost Per Click, representing the average cost for each click on an ad.	metric
cpm	cpm	Cost Per Mille (thousand impressions). This metric represents the cost an advertiser pays for one thousand ad impressions. It is a standard performance metric available in Campaign Summary reports.	metric
create_time	create_time	The date and time when the campaign or content item was created within the Taboola platform.	dimension
ctr	ctr	Click-Through Rate. This metric measures the percentage of people who click on an ad after seeing it. It is a standard performance metric available in Campaign Summary reports.	metric
currency	currency	The currency code (ISO 4217) used for financial metrics within the report, such as ‘spent’ or ‘ad_revenue’.	dimension
date	date	The specific date for which the report data is provided.	dimension
description	description	A textual explanation or detail about the ad creative, conversion rule, or custom audience.	dimension
impressions	impressions	The total number of times an ad was displayed to users.	metric
item	item	The unique identifier for an individual ad creative or content item within a campaign.	metric
item_name	item_name	The title or name of the ad creative or content item.	dimension
roas	roas	Return on Ad Spend, a metric indicating the revenue generated for every dollar spent on advertising.	dimension
site	site	The publisher website or application where the ad was displayed.	dimension
site_id	site_id	The unique identifier for a specific website or placement where ads are displayed. Used for site-level breakdowns in reports.	dimension
site_name	site_name	The descriptive name of the website or placement where ads are displayed. This provides a human-readable name for the site ID.	dimension
spent	spent	The total amount of money spent on a campaign or ad.	metric
thumbnail_url	thumbnail_url	The URL of the thumbnail image associated with the content item.	dimension
url	url	The destination URL of the ad creative or the URL of the content item.	dimension
vcpm	vcpm	Average viewable Cost Per 1000 Viewable Impressions, calculated as total spend divided by viewable impressions multiplied by 1,000. This is the recommended metric for CPM.	metric
vctr	vctr	Viewable Click-Through Rate. This metric measures the percentage of clicks on an ad based on viewable impressions, commonly used for video campaigns.	metric
visible_impressions	visible_impressions	The number of impressions that were deemed viewable according to industry standards. This is a key metric for video campaigns to ensure ads were actually seen.	metric