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.
Custom Conversions {PLACEHOLDER}: CPAMetric
Cost Per Action for a specific custom conversion event. The placeholder indicates the name of the custom conversion.
Custom Conversions {PLACEHOLDER}: CPA (Clicks)Metric
Cost Per Action specifically calculated based on clicks for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: CPA (Views)Metric
Cost Per Action specifically calculated based on views (impressions) for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: CVRMetric
Conversion Rate for a specific custom conversion event. The placeholder indicates the name of the custom conversion.
Custom Conversions {PLACEHOLDER}: CVR (Clicks)Metric
Conversion Rate specifically calculated based on clicks for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: CVR (Views)Metric
Conversion Rate specifically calculated based on views (impressions) for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: ConversionsMetric
The total number of occurrences for a specific custom conversion event. The placeholder indicates the name of the custom conversion.
Custom Conversions {PLACEHOLDER}: Conversions (Clicks)Metric
The number of occurrences for a specific custom conversion event, attributed to clicks.
Custom Conversions {PLACEHOLDER}: Conversions (Views)Metric
The number of occurrences for a specific custom conversion event, attributed to views (impressions).
Custom Conversions {PLACEHOLDER}: ROASMetric
Return on Ad Spend for a specific custom conversion event. The placeholder indicates the name of the custom conversion.
Custom Conversions {PLACEHOLDER}: ROAS (Clicks)Metric
Return on Ad Spend specifically calculated based on clicks for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: ROAS (Views)Metric
Return on Ad Spend specifically calculated based on views (impressions) for a given custom conversion event.
Custom Conversions {PLACEHOLDER}: ValueMetric
The monetary value associated with a specific custom conversion event. The placeholder indicates the name of the custom conversion.
Custom Conversions {PLACEHOLDER}: Value (Clicks)Metric
The monetary value attributed to clicks for a specific custom conversion event.
Custom Conversions {PLACEHOLDER}: Value (Views)Metric
The monetary value attributed to views (impressions) for a specific custom conversion event.
Report End DateDimension
The end date for the reporting period.
Report Start DateDimension
The start date for the reporting period.
account_idDimension
Unique identifier for the advertiser's account.
account_nameDimension
The name associated with the Taboola account. This identifies the entity managing campaigns or receiving revenue.
actionsMetric
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.
campaignDimension
The unique identifier for a specific campaign.
campaign_branding_textDimension
The text displayed to brand the campaign, often indicating the advertiser.
campaign_cpa_goalMetric
The target Cost Per Action (CPA) that the campaign aims to achieve.
campaign_cpcMetric
The Cost Per Click (CPC) set for the campaign.
campaign_daily_ad_delivery_modelDimension
The strategy for how the campaign's ads are delivered throughout the day (e.g., standard, accelerated).
campaign_daily_capMetric
The maximum amount of money a campaign is allowed to spend per day.
campaign_nameDimension
The name of the advertising campaign.
campaign_pricing_modelDimension
The billing model used for the campaign, such as CPC (Cost Per Click).
campaign_spending_limitMetric
The total maximum budget allocated for the campaign.
campaign_spending_limit_modelDimension
The model defining how the campaign's spending limit is applied (e.g., daily, entire campaign).
campaign_tracking_codeDimension
A unique code used to track the performance and attribution of a campaign.
campaigns_numDimension
The total number of campaigns associated with a specific dimension, such as a content provider.
clicksMetric
The total number of clicks on the campaign's ads or items.
content_providerDimension
The identifier for a content provider. This dimension is used to break down report data by the source of the content.
content_provider_nameDimension
The name of the content provider. This provides a descriptive name for the content provider identifier.
conversions_valueMetric
The total monetary value generated from conversions.
countryDimension
The country where the campaign impressions or clicks originated.
country_nameDimension
The geographical name of the country where the ad impressions or clicks occurred. This is a dimension used for country-level reporting.
cpaMetric
Cost Per Action, representing the average cost for each conversion or desired action.
cpa_actions_numMetric
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.
cpa_conversion_rateMetric
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.
cpcMetric
Cost Per Click, representing the average cost for each click on an ad.
cpmMetric
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.
create_timeDimension
The date and time when the campaign or content item was created within the Taboola platform.
ctrMetric
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.
currencyDimension
The currency code (ISO 4217) used for financial metrics within the report, such as 'spent' or 'ad_revenue'.
cvrMetric
Conversion Rate, representing the percentage of clicks or impressions that result in a conversion.
dateDimension
The specific date for which the report data is provided.
descriptionDimension
A textual explanation or detail about the ad creative, conversion rule, or custom audience.
hourDimension
The specific hour of the day for which data is reported or an activity is scheduled.
impressionsMetric
The total number of times an ad was displayed to users.
itemDimension
The unique identifier for an individual ad creative or content item within a campaign.
item_nameDimension
The title or name of the ad creative or content item.
platformDimension
The type of device or operating system on which the ad was displayed (e.g., desktop, mobile, tablet).
platform_nameDimension
The name of the platform (e.g., Desktop, Mobile Phone, Tablet) where the ad was displayed. This dimension is used for platform-level reporting.
roasMetric
Return on Ad Spend, a metric indicating the revenue generated for every dollar spent on advertising.
siteDimension
The publisher website or application where the ad was displayed.
site_idDimension
The unique identifier for a specific website or placement where ads are displayed. Used for site-level breakdowns in reports.
site_nameDimension
The descriptive name of the website or placement where ads are displayed. This provides a human-readable name for the site ID.
spentMetric
The total amount of money spent on a campaign or ad.
thumbnail_urlDimension
The URL of the thumbnail image associated with the content item.
urlDimension
The destination URL of the ad creative or the URL of the content item.
vcpmMetric
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.
vctrMetric
Viewable Click-Through Rate. This metric measures the percentage of clicks on an ad based on viewable impressions, commonly used for video campaigns.
visible_impressionsMetric
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.