Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

Criteo metrics and dimensions

  • Updated on Mar 5, 2026
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your Criteo data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

69 metrics62 dimensions

AD SET

adset_name
Field label Ad set name
Description The Ad set name, set by the advertiser
Field type dimension
Data type string.text.value
adset_id
Field label Ad set ID
Description ID of the ad set
Field type dimension
Data type string.text.value
adset_status
Field label Ad set status
Description Set by the advertiser, this represents the intent to deliver ads
Field type dimension
Data type string.text.value
account_currency
Field label Currency
Description Ad set bid currency code
Field type dimension
Data type string.currency.code
adset_bid_cpc
Field label Ad set bid value
Description Value of the cost per click
Field type metric
Data type float.currency.value

ADVERTISER

advertiser_name
Field label Advertiser name
Description Name of the advertiser
Field type dimension
Data type string.text.value
advertiser_id
Field label Advertiser ID
Description Id of the advertiser
Field type dimension
Data type string.text.value

BIDDING

adset_bid_strategy
Field label Ad set bid type
Description The intended optimization for the Ad Set
Field type dimension
Data type string.text.value

BUDGET

budget_strategy
Field label Budget strategy
Description Type of budget, e.g. Daily, Monthly, Capped
Field type dimension
Data type string.text.value
budget_renewal
Field label Budget renewal
Description The cadence of budget reneweal. Can be daily, monthly, lifetime, or undefined
Field type dimension
Data type string.text.value
budget_delivery_smoothing
Field label Budget delivery smoothing
Description The pace at which budget can be spent. Can be accelerated or standard
Field type dimension
Data type string.text.value
budget_delivery_week
Field label Budget delivery week
Description The seven day period for budget delivery. Can be mondayToSunday, tuesdayToMonday, wednesdayToTuesday, thursdayToWednesday, fridayToThursday, saturdayToFriday, or sundayToSaturday
Field type dimension
Data type string.text.value

BUDGET METRICS

budget_remaining
Field label Budget remaining
Description A decimal value showing the remaining budget value for Ad Sets with Capped budget strategies. For uncapped budgets, the value will be null
Field type metric
Data type int.currency.value

CAMPAIGN

campaign_name
Field label Campaign
Description Name of the campaign
Field type dimension
Data type string.text.value
campaign_id
Field label Campaign ID
Description ID of the campaign
Field type dimension
Data type string.text.value

CATEGORY

category_name
Field label Category
Description Name of the category from catalog feed
Field type dimension
Data type string.text.value
category_id
Field label Category ID
Description ID of the category
Field type dimension
Data type string.text.value

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEPRECATED

campaign_bid_strategy
Field label Campaign bid type
Description Type of the bid.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-27
audience_description
Field label Audience description
Description Description of the audience.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-07-16
audience_name
Field label Audience name
Description Name of the audience.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-07-16
audience_updated
Field label Audience update date
Description Date of the audience last update.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2024-07-16
audience_created
Field label Audience creation date
Description Date of the audience creation.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2024-07-16
budget_id
Field label Budget ID
Description ID of the budget the campaign is using.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-27
budget_name
Field label Budget
Description Name of the budget the campaign is using.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-27
budget_type
Field label Budget type
Description Type of budget, e.g. Daily, Monthly, Capped.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-27
budget_remaining_updated
Field label Budget remaining updated
Description Time at which remainingBudget was computed.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2021-02-27
campaign_remaining_days
Field label Campaign remaining days (deprecated)
Description Number of days this campaign can run with the existing budget. This value is estimated on the current spending trend.
Field type dimension
Data type int.number.value
🚫 Deprecated Deprecated on 2019-02-27
campaign_status
Field label Campaign status
Description Status of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-27
audience_id
Field label Audience ID
Description ID of the audience.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-07-16
e_cos_pv
Field label Effective cost of post-view sales
Description The ratio between the total cost of the campaign & the post-view sales amount that the campaign generated.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2021-02-27
e_cos_pc_pv
Field label Effective cost of post-click + post-view sales
Description The ratio between the total cost of the campaign and the post-click and post-view sales amount that the campaign generated.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2021-02-27
budget_total
Field label Total budget
Description Total amount added to this budget.
Field type metric
Data type int.currency.value
🚫 Deprecated Deprecated on 2021-02-27
nb_lines_email
Field label Audience email lines
Description The total number of email lines in the audience.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-07-16
revenue_generated_pv_nd
Field label Non-deduplicated post-view revenue generated
Description Total revenue of your campaigns generated from post-view sales non-deduplicated.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
category_products
Field label Category product amount
Description Number of products tagged with this category.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2021-02-27
sales_pc
Field label Post-click sales
Description Number of purchases made on the website by users who clicked an Ad. Sales are tracked within 30 days after a user clicked the Ad.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
revenue_generated_pc_pv
Field label Revenue generated post-click + post-view
Description Post-click + post-view revenue is the total revenue of your campaigns generated from post-click and post-view sales.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
cost_per_order_pc_pv
Field label Cost per order post-click + post-view
Description Cost per order post-click + post-view is the amount of money (cost) spent to generate post-click and post-view sales.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
impression_win
Field label Impression win (deprecated)
Description Deprecated field.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2019-02-27
cost_per_order_pv
Field label Cost per post-view order
Description Amount of money (cost) spent to generate post-view sales.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
conv_rate_post_view
Field label Post-view conversion rate
Description Number of post-view sales generated by users who viewed on the Ad divided by impressions.
Field type metric
Data type float.number.percentage
🚫 Deprecated Deprecated on 2021-02-27
nb_matches_email
Field label Audience email matches
Description The number of email matches in the audience.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-07-16
revenue_generated_pc
Field label Post-click revenue generated
Description Total revenue of your campaigns generated from post-click sales.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
campaign_bid_cpc
Field label Bid value
Description Value of the cost per click.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
revenue_generated_pv
Field label Post-view revenue generated
Description Total revenue of your campaigns generated from post-view sales.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
sales_pc_nd
Field label Non-deduplicated post-click sales
Description Post-click sales that are non-deduplicated.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
revenue_generated_pc_nd
Field label Non-deduplicated post-click revenue generated
Description Total revenue of your campaigns generated from post-click sales non-deduplicated.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
sales_pv
Field label Post-view sales
Description All sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
ecpc
Field label Effective cost per click (eCPC)
Description The price you pay each time a user clicks your Criteo ad.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
sales_pv_nd
Field label Non-deduplicated post-view sales
Description All non-deduplicated post-view sales that occurred on your website within 24 hours after a user sees a Criteo ad of your campaign.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
category_avg_price
Field label Category average price
Description Average price of the products of this category.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
sales_pc_pv
Field label Post-view sales
Description The total amount of sales generated both post-click and post-view.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
same_sales_pc
Field label Same device post-click sales
Description The total number of purchases completed via the same device your Criteo ads were clicked. Sales are attributed within 30 days after a user clicks on your Criteo ad.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2021-02-27
nb_lines
Field label Audience lines
Description The total number of lines in the audience.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-07-16

DEVICES

devices
Field label Devices
Description Devices of the ad set
Field type dimension
Data type string.text.value
os
Field label OS
Description OS of the ad set
Field type dimension
Data type string.text.value

PERFORMANCE

impressions
Field label Impressions
Description Number of times the Ad is displayed to a user on publishers' websites
Field type metric
Data type int.number.value
clicks
Field label Clicks
Description Number of times that your Criteo ads have been clicked
Field type metric
Data type int.number.value
ctr
Field label CTR
Description Number of times the Ads are clicked, divided by number of displays
Field type metric
Data type float.number.percentage
conversion_rate
Field label Conversion rate
Description Percentage of conversions or sales compared to the clicks that occurred
Field type metric
Data type float.number.percentage
cost_per_order
Field label CPO (cost per order)
Description The price you pay for each order. Calculated as total cost divided by the total number of orders
Field type metric
Data type float.currency.value
cost
Field label Cost
Description Total cost of the campaigns
Field type metric
Data type float.currency.value
sales
Field label Sales
Description The total number of purchases completed via the same device your Criteo ads were clicked, or a different one
Field type metric
Data type float.currency.value
cost_of_sale
Field label COS (Cost of sale)
Description Advertising cost per conversion or sale
Field type metric
Data type float.currency.value
revenue
Field label Revenue
Description The amount of money generated by online sales
Field type metric
Data type float.currency.value
exposed_users
Field label Exposed users
Description Number of distinct cookies that have seen at least one Criteo display
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
audience
Field label Audience
Description Number of distinct cookies to which Criteo had the opportunity to make a display
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
reach
Field label Reach
Description Share of the audience exposed to at least one Criteo display ad
Field type metric
Data type float.number.ratio
Aggregation Non-aggregatable metric
overall_competition_win
Field label Overall competition win
Description Percentage of impressions/ad placements won, out of all impressions/ad placements that were bid on
Field type metric
Data type float.number.ratio
ecpm
Field label Effective cost per mille (eCPM)
Description Effective cost per mille is the cost of your campaign for 1,000 impressions
Field type metric
Data type float.currency.value
revcpc
Field label Revenue CPC
Description The amount of revenue for each individual click on Ads
Field type metric
Data type float.currency.value
average_cart
Field label Average cart
Description Average revenue generated by a campaign's sales
Field type metric
Data type float.currency.value
return_on_spend
Field label Return on advertising spending (ROAS)
Description The ratio between the sales amount the campaign generated and the total cost of the campaign (ROAS = 1/COS)
Field type metric
Data type float.number.ratio
advertiser_value
Field label Advertiser value
Description The total value generated by the campaign
Field type metric
Data type float.currency.value
cost_of_advertiser_value
Field label Cost of advertiser value
Description The ratio between the total cost of the campaign and the Advertiser Value of the campaign
Field type metric
Data type float.number.ratio
viewable_displays
Field label Viewed displays
Description The number of ads that have been viewed. A display is considered viewed if at least 50% of the ad appears on the screen for at least one second
Field type metric
Data type int.number.value
non_viewable_displays
Field label Unviewed displays
Description The number of ads that have not been viewed. A display that doesn`t meet the viewed display`s criteria is considered unviewed
Field type metric
Data type int.number.value
untrackable_displays
Field label Untracked displays
Description This is the number of untracked displays. Some displays cannot be tracked because of the display environment (for instance, native banner)
Field type metric
Data type int.number.value
qualified_visits
Field label Qualified visits
Description The number of users on the target website or app for which at least two events or one sale event occurred within the hour following a click
Field type metric
Data type int.number.value
visits
Field label Visits
Description The number of users on the target website or app for which at least one event occurred within the hour following a click
Field type metric
Data type int.number.value
cost_per_visit
Field label Cost per visit
Description The amount of money spent per visit to your website or app
Field type metric
Data type float.number.value
bounce_rate
Field label Bounce rate
Description The proportion of website visitors leaving after only viewing one page
Field type metric
Data type int.number.value
potential_displays
Field label Potential displays
Description The number of display opportunities, or the number of bid requests received
Field type metric
Data type int.number.value
post_install_sales
Field label Post-install sales
Description The number of your completed events after an app install
Field type metric
Data type int.number.value
app_installs
Field label App installs
Description The number of installations of your app
Field type metric
Data type int.number.value
post_install_conversion_rate
Field label Post-install conversion rate
Description Percentage of post-install sales compared to the clicks that occurred
Field type metric
Data type float.number.ratio
post_install_cost_of_sale
Field label Post-install cost of sale
Description The cost of sale for app install campaigns
Field type metric
Data type float.number.value
post_install_order_value
Field label Post-install order value
Description The amount of money generated by sales after an app install
Field type metric
Data type float.number.value
cost_per_install
Field label Cost per install
Description The cost of sale for app install campaigns
Field type metric
Data type float.number.value
install_rate
Field label Install rate
Description The percentage of completed app installs compared to the number of clicks
Field type metric
Data type float.number.ratio
post_install_cost_per_order
Field label Post-install cost per order
Description The cost per order for sales after an app install
Field type metric
Data type float.number.value
post_install_roas
Field label Post-install ROAS
Description The return on ad spend for sales after an app install
Field type metric
Data type float.number.value
omnichannel_revenue
Field label Omnichannel revenue
Description The revenue generated by online and offline sales
Field type metric
Data type float.number.value
omnichannel_sales
Field label Omnichannel sales
Description The number of online and offline transactions or conversions resulting from Criteo ads
Field type metric
Data type float.number.value
store_roas
Field label Store ROAS
Description The number of online and offline transactions or conversions resulting from Criteo ads
Field type metric
Data type float.number.value
store_sales
Field label Store sales
Description The number of completed in-store transactions or purchases
Field type metric
Data type int.number.value
store_revenue
Field label Store revenue
Description The number of completed in-store transactions or purchases
Field type metric
Data type int.number.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json
system_metadata.query_excluded_accounts
Field label Excluded invalid accounts
Description A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
Field type dimension
Data type string.text.json

TARGETING

targeting_environments
Field label Targeted environments
Description List of display environments that the Ad Set should target. Can contain inApp and web
Field type dimension
Data type string.text.value
targeting_devices
Field label Targeted devices
Description List of device types that the Ad Set should target. Can contain desktop, tablet, mobile and other
Field type dimension
Data type string.text.value
targeting_operating_systems
Field label Targeted operating systems
Description List of operating systems that the Ad Set should target. Can contain android, ios, and other
Field type dimension
Data type string.text.value
targeting_countries
Field label Targeted countries
Description List of countries that the Ad Set should target
Field type dimension
Data type string.text.value
targeting_subdivisions
Field label Targeted subdivisions
Description List of subdivisions that the Ad Set should target
Field type dimension
Data type string.text.value
targeting_zip_codes
Field label Targeted zip codes
Description List of zip codes that the Ad Set should target
Field type dimension
Data type string.text.value
targeting_frequency
Field label Frequency
Description The period by which the maximum impression limit is calculated. Can be hourly, daily, lifetime, or advanced (for custom set-ups configured by Criteo)
Field type dimension
Data type string.text.value
targeting_maximum_impressions
Field label Maximum impressions
Description The maximum impressions allowed for the specified Frequency
Field type metric
Data type int.number.value

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
year
Field label Year
Description Year, e.g. 2017
Field type dimension
Data type string.time.year
yearOfWeek
Field label Year of week (Sun-Sat)
Description Year of week for US weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearOfWeekIso
Field label Year of week (Mon-Sun)
Description Year of week for ISO weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearMonth
Field label Year & month
Description Year and month, e.g. 2017|06
Field type dimension
Data type string.time.yearmonth
month
Field label Month
Description Month, e.g. 6
Field type dimension
Data type string.time.month
yearWeek
Field label Year & week (Sun-Sat)
Description Year and week for US weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweek
yearWeekIso
Field label Year & week (Mon-Sun)
Description Year and week for ISO weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Description US week number, e.g. 51
Field type dimension
Data type string.time.week
weekIso
Field label Week (Mon-Sun)
Description ISO week number, e.g. 51
Field type dimension
Data type string.time.weekiso
dayOfMonth
Field label Day of month
Description Day of month, e.g. 2
Field type dimension
Data type string.time.dayofmonth
dayOfWeekName
Field label Day of week (Sun-Sat)
Description Day of week name for US weeks, e.g. 0 Sunday
Field type dimension
Data type string.time.dayofweek
dayOfWeekNameIso
Field label Day of week (Mon-Sun)
Description Day of week name for ISO weeks, e.g. 1 Sunday
Field type dimension
Data type string.time.dayofweekiso
date
Field label Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date

© Supermetrics 2025