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
Account ID	Account ID	Unique identifier for the advertiser’s account.	dimension
Category	Category	Represents the type of content or page, such as ‘Section Fronts’ (CATEGORY), ‘Story Pages’ (TEXT), ‘Video Pages’ (VIDEO), or ‘Homepage’ (HOMEPAGE).	dimension
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}: Events	Custom Conversions {PLACEHOLDER}: Events	The number of occurrences for a specific custom event that is tracked as a conversion. The placeholder indicates the name of the custom event.	metric
Custom Conversions {PLACEHOLDER}: Events (Clicks)	Custom Conversions {PLACEHOLDER}: Events (Clicks)	The number of occurrences for a specific custom event, attributed to clicks.	metric
Custom Conversions {PLACEHOLDER}: Events (Views)	Custom Conversions {PLACEHOLDER}: Events (Views)	The number of occurrences for a specific custom 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
Hour	hour	The specific hour of the day for which data is reported or an activity is scheduled.	dimension
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
budget	budget	The financial limit allocated for a campaign, which can be daily or a total spending limit.	metric
campaign	campaign	The unique identifier for a specific campaign.	metric
campaign_branding_text	campaign_branding_text	The text displayed to brand the campaign, often indicating the advertiser.	dimension
campaign_cpa_goal	campaign_cpa_goal	The target Cost Per Action (CPA) that the campaign aims to achieve.	metric
campaign_cpc	campaign_cpc	The Cost Per Click (CPC) set for the campaign.	metric
campaign_daily_ad_delivery_model	campaign_daily_ad_delivery_model	The strategy for how the campaign’s ads are delivered throughout the day (e.g., standard, accelerated).	dimension
campaign_daily_cap	campaign_daily_cap	The maximum amount of money a campaign is allowed to spend per day.	metric
campaign_id	campaign_id	The unique identifier for the campaign.	dimension
campaign_name	campaign_name	The name of the advertising campaign.	dimension
campaign_pricing_model	campaign_pricing_model	The billing model used for the campaign, such as CPC (Cost Per Click).	dimension
campaign_spending_limit	campaign_spending_limit	The total maximum budget allocated for the campaign.	metric
campaign_spending_limit_model	campaign_spending_limit_model	The model defining how the campaign’s spending limit is applied (e.g., daily, entire campaign).	dimension
campaign_status	campaign_status	The current operational state of the campaign (e.g., active, paused, pending approval).	dimension
campaign_tracking_code	campaign_tracking_code	A unique code used to track the performance and attribution of a campaign.	dimension
campaigns_num	campaigns_num	The total number of campaigns associated with a specific dimension, such as a content provider.	metric
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
country	country	The country where the campaign impressions or clicks originated.	dimension
country_code	country_code	The two-letter ISO 3166-1 alpha-2 code representing the country. Used for precise geographical targeting and reporting.	dimension
country_name	country_name	The geographical name of the country where the ad impressions or clicks occurred. This is a dimension used for country-level reporting.	dimension
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		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
cvr	cvr	Conversion Rate, representing the percentage of clicks or impressions that result in a conversion.	metric
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
end_date	end_date	The scheduled end date for the campaign.	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
platform	platform	The type of device or operating system on which the ad was displayed (e.g., desktop, mobile, tablet).	dimension
platform_name	platform_name	The name of the platform (e.g., Desktop, Mobile Phone, Tablet) where the ad was displayed. This dimension is used for platform-level reporting.	dimension
publisher	publisher	Identifier for the publisher displaying the ads. This field is used for targeting and reporting on performance by publisher.	dimension
roas	roas	Return on Ad Spend, a metric indicating the revenue generated for every dollar spent on advertising.	metric
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
start_date	start_date	The scheduled start date for the campaign.	dimension
thumbnail_url	thumbnail_url	The URL of the thumbnail image associated with the content item.	dimension
timezone	timezone	The timezone used for campaign scheduling and reporting.	dimension
url	url	The destination URL of the ad creative or the URL of the content item.	dimension
vcpm	vcpm	Video Cost Per Mille, representing the average cost per 1000 video impressions. This is analogous to CPM but specifically for video content.	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