Press CTRL+K to open search

Meta Ad Library metrics and dimensions

  • Updated on Nov 3, 2026
  • Published on Nov 3, 2026
Prev Next

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

11 metrics35 dimensions
ad_library_id
Field label Ad library ID
Description Unique Ad Library ID
Field type dimension
Data type string.text.value
ad_creation_date
Field label Ad creation date
Description Date when the ad was created
Field type dimension
Data type string.time.date
delivery_start_date
Field label Delivery start date
Description Date when ad delivery started
Field type dimension
Data type string.time.date
delivery_stop_date
Field label Delivery stop date
Description Date when ad delivery stopped. Empty if still running
Field type dimension
Data type string.time.date
ad_snapshot_url
Field label Ad snapshot URL
Description Link to the ad in Meta Ad Library
Field type dimension
Data type string.text.url
page_id
Field label Page ID
Description Facebook Page ID of the advertiser
Field type dimension
Data type string.text.value
page_name
Field label Page name
Description Facebook Page name of the advertiser
Field type dimension
Data type string.text.value
publisher_platforms
Field label Publisher platforms
Description Meta platforms where the ad appeared (e.g. facebook, instagram)
Field type dimension
Data type string.text.value
languages
Field label Languages
Description Languages of the ad creative (e.g. en, es)
Field type dimension
Data type string.text.value

CREATIVE

ad_creative_bodies
Field label Ad creative bodies
Description Main text content of the ad
Field type dimension
Data type string.text.value
ad_creative_link_captions
Field label Ad creative link captions
Description Call-to-action captions in the ad
Field type dimension
Data type string.text.value
ad_creative_link_descriptions
Field label Ad creative link descriptions
Description Link descriptions in the ad call-to-action
Field type dimension
Data type string.text.value
ad_creative_link_titles
Field label Ad creative link titles
Description Link titles in the ad call-to-action
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

DEMOGRAPHIC BREAKDOWN

country
Field label Country
Description Country where the ad was delivered
Field type dimension
Data type string.text.value
age_range
Field label Age range
Description Age range of the audience (e.g. 25-34)
Field type dimension
Data type string.text.value
male_reach
Field label Male reach
Description Number of male accounts reached in this age range and country
Field type metric
Data type int.number.value
female_reach
Field label Female reach
Description Number of female accounts reached in this age range and country
Field type metric
Data type int.number.value
unknown_reach
Field label Unknown reach
Description Number of accounts with unknown gender reached in this age range and country
Field type metric
Data type int.number.value

POLITICAL

bylines
Field label Bylines
Description Entity that funded the ad. Available for political/issue ads
Field type dimension
Data type string.text.value
currency
Field label Currency
Description Currency used for ad spend. Available for political/issue ads
Field type dimension
Data type string.text.value
spend_lower_bound
Field label Spend lower bound
Description Lower bound of ad spend range. Available for political/issue ads
Field type metric
Data type int.number.value
spend_upper_bound
Field label Spend upper bound
Description Upper bound of ad spend range. Available for political/issue ads
Field type metric
Data type int.number.value
impressions_lower_bound
Field label Impressions lower bound
Description Lower bound of impressions range. Available for political/issue ads
Field type metric
Data type int.number.value
impressions_upper_bound
Field label Impressions upper bound
Description Upper bound of impressions range. Available for political/issue ads
Field type metric
Data type int.number.value
estimated_audience_size_lower_bound
Field label Estimated audience size lower bound
Description Lower bound of estimated audience size. Available for political/issue ads
Field type metric
Data type int.number.value
estimated_audience_size_upper_bound
Field label Estimated audience size upper bound
Description Upper bound of estimated audience size. Available for political/issue ads
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

REACH

eu_total_reach
Field label EU total reach
Description Total reach across EU locations. Available for EU-delivered ads
Field type metric
Data type int.number.value
br_total_reach
Field label BR total reach
Description Total reach in Brazil. Available for Brazilian political ads
Field type metric
Data type int.number.value

TARGETING

target_ages
Field label Target ages
Description Age range targeted by the ad (e.g. 18-65). Available for UK/EU ads
Field type dimension
Data type string.text.value
target_gender
Field label Target gender
Description Gender targeted by the ad (Women, Men, or All). Available for UK/EU ads
Field type dimension
Data type string.text.value
target_locations
Field label Target locations
Description Countries targeted by the ad. Available for UK/EU ads
Field type dimension
Data type string.text.value
payer
Field label Payer
Description Entity that paid for the ad. Available for EU ads
Field type dimension
Data type string.text.value
beneficiary
Field label Beneficiary
Description Entity that benefits from the ad. Available for EU ads
Field type dimension
Data type string.text.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

© Supermetrics 2026