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}: CPA Metric
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}: CVR Metric
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}: Conversions Metric
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}: ROAS Metric
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}: Value Metric
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 Date Dimension
The end date for the reporting period.
Report Start Date Dimension
The start date for the reporting period.
account_id Dimension
Unique identifier for the advertiser's account.
account_name Dimension
The name associated with the Taboola account. This identifies the entity managing campaigns or receiving revenue.
actions Metric
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.
campaign Dimension
The unique identifier for a specific campaign.
campaign_branding_text Dimension
The text displayed to brand the campaign, often indicating the advertiser.
campaign_cpa_goal Metric
The target Cost Per Action (CPA) that the campaign aims to achieve.
campaign_cpc Metric
The Cost Per Click (CPC) set for the campaign.
campaign_daily_ad_delivery_model Dimension
The strategy for how the campaign's ads are delivered throughout the day (e.g., standard, accelerated).
campaign_daily_cap Metric
The maximum amount of money a campaign is allowed to spend per day.
campaign_name Dimension
The name of the advertising campaign.
campaign_pricing_model Dimension
The billing model used for the campaign, such as CPC (Cost Per Click).
campaign_spending_limit Metric
The total maximum budget allocated for the campaign.
campaign_spending_limit_model Dimension
The model defining how the campaign's spending limit is applied (e.g., daily, entire campaign).
campaign_tracking_code Dimension
A unique code used to track the performance and attribution of a campaign.
campaigns_num Dimension
The total number of campaigns associated with a specific dimension, such as a content provider.
clicks Metric
The total number of clicks on the campaign's ads or items.
content_provider Dimension
The identifier for a content provider. This dimension is used to break down report data by the source of the content.
content_provider_name Dimension
The name of the content provider. This provides a descriptive name for the content provider identifier.
conversions_value Metric
The total monetary value generated from conversions.
country Dimension
The country where the campaign impressions or clicks originated.
country_name Dimension
The geographical name of the country where the ad impressions or clicks occurred. This is a dimension used for country-level reporting.
cpa Metric
Cost Per Action, representing the average cost for each conversion or desired action.
cpa_actions_num Metric
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_rate Metric
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.
cpc Metric
Cost Per Click, representing the average cost for each click on an ad.
cpm Metric
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_time Dimension
The date and time when the campaign or content item was created within the Taboola platform.
ctr Metric
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.
currency Dimension
The currency code (ISO 4217) used for financial metrics within the report, such as 'spent' or 'ad_revenue'.
cvr Metric
Conversion Rate, representing the percentage of clicks or impressions that result in a conversion.
date Dimension
The specific date for which the report data is provided.
description Dimension
A textual explanation or detail about the ad creative, conversion rule, or custom audience.
hour Dimension
The specific hour of the day for which data is reported or an activity is scheduled.
impressions Metric
The total number of times an ad was displayed to users.
item Dimension
The unique identifier for an individual ad creative or content item within a campaign.
item_name Dimension
The title or name of the ad creative or content item.
platform Dimension
The type of device or operating system on which the ad was displayed (e.g., desktop, mobile, tablet).
platform_name Dimension
The name of the platform (e.g., Desktop, Mobile Phone, Tablet) where the ad was displayed. This dimension is used for platform-level reporting.
roas Metric
Return on Ad Spend, a metric indicating the revenue generated for every dollar spent on advertising.
site Dimension
The publisher website or application where the ad was displayed.
site_id Dimension
The unique identifier for a specific website or placement where ads are displayed. Used for site-level breakdowns in reports.
site_name Dimension
The descriptive name of the website or placement where ads are displayed. This provides a human-readable name for the site ID.
spent Metric
The total amount of money spent on a campaign or ad.
thumbnail_url Dimension
The URL of the thumbnail image associated with the content item.
url Dimension
The destination URL of the ad creative or the URL of the content item.
vcpm Metric
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.
vctr Metric
Viewable Click-Through Rate. This metric measures the percentage of clicks on an ad based on viewable impressions, commonly used for video campaigns.
visible_impressions Metric
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.