Facebook Ads metrics and dimensions

537 metrics243 dimensionsCustom fields

Search fields

ACCOUNT DETAILS

profile

Field label	Account name
Description	The name of your ad account, which groups your advertising activity
Field type	dimension
Data type	string.text.value

profileID

Field label	Account ID
Description	The ID number of your ad account, which groups your advertising activity
Field type	dimension
Data type	string.text.value

business_name

Field label	Business name
Field type	dimension
Data type	string.text.value

business_country_code

Field label	Business country
Field type	dimension
Data type	string.geo.country.twolettercode

business_city

Field label	Business city
Field type	dimension
Data type	string.geo.city

account_status

Field label	Account status
Field type	dimension
Data type	string.text.value

account_edit_link

Field label	Account edit link
Description	Link to edit the Facebook Ads account
Field type	dimension
Data type	string.text.url

currency

Field label	Account currency
Field type	dimension
Data type	string.text.value

timezone_name

Field label	Account timezone
Field type	dimension
Data type	string.text.value

timezone_id

Field label	Account timezone ID
Field type	dimension
Data type	string.text.value

timezone_offset_hours_utc

Field label	Account timezone offset from UTC
Field type	dimension
Data type	int.number.value

users

Field label	Account users
Field type	dimension
Data type	string.text.value

spend_cap

Field label	Account spend cap
Field type	dimension
Data type	float.currency.value

amount_spent

Field label	Account amount spent
Field type	dimension
Data type	float.currency.value

balance

Field label	Account balance
Field type	dimension
Data type	float.currency.value

funding_source_details

Field label	Account funding source
Field type	dimension
Data type	string.text.value

ACTION/CONVERSION

ActionTypeWithCustomLabels

Field label	Action type
Description	The kind of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn't click on it. Action types include Page likes, app installs, conversions, event responses and more. Custom conversion types will be listed by their label
Field type	dimension
Data type	string.text.value

ActionType

Field label	Action type (with custom conv. IDs)
Description	The kind of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn't click on it. Action types include Page likes, app installs, conversions, event responses and more. Custom conversion types will be listed by their ID number
Field type	dimension
Data type	string.text.value

ActionTargetID

Field label	Action target ID
Field type	dimension
Data type	string.text.value

ActionDevice

Field label	Action device
Field type	dimension
Data type	string.text.value

ActionCanvasComponentName

Field label	Canvas component name
Field type	dimension
Data type	string.text.value

AD DETAILS

ad_name

Field label	Ad name
Description	The name of the ad that you're viewing in the report
Field type	dimension
Data type	string.text.value

ad_id

Field label	Ad ID
Description	The unique ID of the ad that you're viewing in reporting
Field type	dimension
Data type	string.text.value

adstatus

Field label	Ad status (effective status)
Field type	dimension
Data type	string.text.value

ad_tags

Field label	Ad tags
Description	List of tags assigned to your ad
Field type	dimension
Data type	string.text.value

desktop_feed_preview_url

Field label	Ad preview URL: desktop feed
Description	URL to a preview of the ad, as seen in the desktop feed standard placement
Field type	dimension
Data type	string.text.value

facebook_story_preview_url

Field label	Ad preview URL: Facebook story
Description	URL to a preview of the ad, as seen in the Facebook story mobile placement
Field type	dimension
Data type	string.text.value

right_column_preview_url

Field label	Ad preview URL: right column
Description	URL to a preview of the ad, as seen in the right column standard placement
Field type	dimension
Data type	string.text.value

mobile_feed_preview_url

Field label	Ad preview URL: mobile feed
Description	URL to a preview of the ad, as seen in the mobile feed standard placement
Field type	dimension
Data type	string.text.value

instagram_preview_url

Field label	Ad preview URL: Instagram
Description	URL to a preview of the ad, as seen in the Instagram standard placement
Field type	dimension
Data type	string.text.value

instagram_story_preview_url

Field label	Ad preview URL: Instagram story
Description	URL to a preview of the ad, as seen in the Instagram Story placement
Field type	dimension
Data type	string.text.value

mobile_banner_preview_url

Field label	Ad preview URL: mobile banner
Description	URL to a preview of the ad, as seen in the mobile banner placement
Field type	dimension
Data type	string.text.value

mobile_interstitial_preview_url

Field label	Ad preview URL: mobile interstitial
Description	URL to a preview of the ad, as seen in the mobile interstitial placement
Field type	dimension
Data type	string.text.value

adconfigured_status

Field label	Ad configured status
Field type	dimension
Data type	string.text.value

adbid_info

Field label	Ad bid info
Field type	dimension
Data type	string.text.value

adcreative_id

Field label	Ad creative ID
Field type	dimension
Data type	string.text.value

creative_name

Field label	Ad creative name
Field type	dimension
Data type	string.text.value

creative_title

Field label	Ad title
Field type	dimension
Data type	string.text.value

creative_body

Field label	Ad body
Field type	dimension
Data type	string.text.value

creative_object_type

Field label	Object type
Field type	dimension
Data type	string.text.value

creative_call_to_action_type

Field label	Call-to-action type
Field type	dimension
Data type	string.text.value

creative_thumbnail_url

Field label	Ad creative thumbnail URL
Field type	dimension
Data type	string.text.url

creative_image_url

Field label	Ad creative image URL
Field type	dimension
Data type	string.text.url

creative_image

Field label	Ad creative image
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

destinationURL

Field label	Destination URL
Field type	dimension
Data type	string.text.url

creative_link_url

Field label	Internal destination URL
Field type	dimension
Data type	string.text.url

creative_object_url

Field label	External destination URL
Field type	dimension
Data type	string.text.url

creative_url_tags

Field label	URL tags
Field type	dimension
Data type	string.text.value

creative_template_url

Field label	Tracking template URL
Field type	dimension
Data type	string.text.url

adtracking_specs

Field label	Tracking specs
Field type	dimension
Data type	string.text.value

adconversion_specs

Field label	Conversion specs
Field type	dimension
Data type	string.text.value

adreview_feedback

Field label	Review feedback
Field type	dimension
Data type	string.text.value

utm_source

Field label	Source (utm)
Description	Value of the utm_source parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_medium

Field label	Medium (utm)
Description	Value of the utm_medium parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_campaign

Field label	Campaign (utm)
Description	Value of the utm_campaign parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_content

Field label	Content (utm)
Description	Value of the utm_content parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_term

Field label	Term (utm)
Description	Value of the utm_term parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

AD SET DETAILS

adset_name

Field label	Ad set name
Description	The name of the ad set that you're viewing in reporting
Field type	dimension
Data type	string.text.value

adset_id

Field label	Ad set ID
Description	The unique ID of the ad set you're viewing in reports
Field type	dimension
Data type	string.text.value

adsetstatus

Field label	Ad set status (effective status)
Field type	dimension
Data type	string.text.value

adset_tags

Field label	Ad set tags
Description	List of tags assigned to your ad set
Field type	dimension
Data type	string.text.value

ad_group_edit_link

Field label	Ad set edit link
Description	Link to edit the ad set in Facebook Ads
Field type	dimension
Data type	string.text.url

adsetconfigured_status

Field label	Ad set configured status
Field type	dimension
Data type	string.text.value

bidtype

Field label	Bid type
Field type	dimension
Data type	string.text.value

bidamount

Field label	Bid amount
Field type	dimension
Data type	float.currency.value

bid_strategy

Field label	Bid strategy
Description	Bid strategy for this ad set when you use AUCTION as your buying type
Field type	dimension
Data type	string.text.value

bidinfo

Field label	Ad set bid info
Field type	dimension
Data type	string.text.value

adsetstart_time

Field label	Start date
Field type	dimension
Data type	string.time.date

adsetend_time

Field label	End date
Field type	dimension
Data type	string.time.date

adsetstart_time_exact

Field label	Start date & time
Field type	dimension
Data type	string.text.value

adsetend_time_exact

Field label	End date & time
Field type	dimension
Data type	string.text.value

adsetdaily_budget

Field label	Daily budget
Field type	dimension
Data type	float.currency.value

adsetlifetime_budget

Field label	Lifetime budget
Field type	dimension
Data type	float.currency.value

lifetime_min_spend_target

Field label	Lifetime minimum spend target
Description	Lifetime minimum spend target for an ad set defined in your account currency. You must specify the lifetime budget at the ad campaign level
Field type	dimension
Data type	float.currency.value

lifetime_spend_cap

Field label	Lifetime spend cap
Description	Daily spend cap of the ad set defined in your account currency. You must specify the daily budget in the campaign
Field type	dimension
Data type	float.currency.value

adsetbudget_remaining

Field label	Budget remaining
Field type	dimension
Data type	float.currency.value

adsettargeting

Field label	Targeting
Field type	dimension
Data type	string.text.value

adsettargeting_age_max

Field label	Targeting maximum age
Description	Maximum of age range defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension
Field type	dimension
Data type	int.number.value

adsettargeting_age_min

Field label	Targeting minimum age
Description	Minimum of age range defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension
Field type	dimension
Data type	int.number.value

adsettargeting_geo_location_countries

Field label	Targeting country location
Description	Countries defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension
Field type	dimension
Data type	string.text.value

adsettargeting_geo_location_country_groups

Field label	Targeting country groups
Description	Country groups defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension
Field type	dimension
Data type	string.text.value

adsettargeting_geo_location_type

Field label	Targeting location type
Description	Location types defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension
Field type	dimension
Data type	string.text.value

adsetpromoted_object

Field label	Promoted object
Field type	dimension
Data type	string.text.value

optimization_goal

Field label	Ad set optimization goal
Description	The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads
Field type	dimension
Data type	string.text.value

APP ACTIONS

action_games.plays

Field label	Game plays
Field type	metric
Data type	int.number.value

action_app_engagement

Field label	Desktop app engagements
Field type	metric
Data type	int.number.value

action_app_install

Field label	Desktop app installs
Field type	metric
Data type	int.number.value

action_app_story

Field label	Desktop app story engagements
Field type	metric
Data type	int.number.value

action_app_use

Field label	Desktop app uses
Field type	metric
Data type	int.number.value

action_credit_spent

Field label	Credit spends
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_achievement_unlocked

Field label	Mobile app achievements unlocked
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_add_payment_info

Field label	Mobile app adds of payment info
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_add_to_cart

Field label	Mobile app adds to cart
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_add_to_wishlist

Field label	Mobile app adds to wishlist
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_complete_registration

Field label	Mobile app registrations completed
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_initiated_checkout

Field label	Mobile app checkouts initiated
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_content_view

Field label	Mobile app content views
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_spent_credits

Field label	Mobile app credits spent
Field type	metric
Data type	int.number.value

action_mobile_app_install

Field label	Mobile app installs
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_level_achieved

Field label	Mobile app levels completed
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_purchase

Field label	Mobile app purchases
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_rate

Field label	Mobile app ratings submitted
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_search

Field label	Mobile app searches
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_activate_app

Field label	Mobile app sessions
Field type	metric
Data type	int.number.value

action_app_custom_event.fb_mobile_tutorial_completion

Field label	Mobile app tutorials completed
Field type	metric
Data type	int.number.value

action_omni_app_install

Field label	Omni app installs
Description	The estimated number of completed app installs across all channels
Field type	metric
Data type	int.number.value

action_omni_purchase

Field label	Omni purchases
Description	The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_add_to_cart

Field label	Omni adds to cart
Description	The number of add to cart events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_complete_registration

Field label	Omni completed registrations
Description	The number of complete registration events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_view_content

Field label	Omni content views
Description	The number of view content events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_search

Field label	Omni searches
Description	The number of search events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_initiated_checkout

Field label	Omni initiated checkouts
Description	The number of initiate checkout events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_achievement_unlocked

Field label	Omni achievement unlocks
Description	The number of unlock achievement events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_activate_app

Field label	Omni app activations
Description	The number of times your app was activated attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_level_achieved

Field label	Omni level completed
Description	The estimated number of completed level across all channels
Field type	metric
Data type	int.number.value

action_omni_rate

Field label	Omni rates
Description	The number of achieve level events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_spend_credits

Field label	Omni credit spends
Description	The number of spend credits events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools. This does not refer to the total value of credits spent
Field type	metric
Data type	int.number.value

action_omni_tutorial_completion

Field label	Omni completed tutorials
Description	The number of completed tutorial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_omni_custom

Field label	Omni custom actions
Description	The number of custom events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

action_app_custom_event.other

Field label	Other mobile app actions
Field type	metric
Data type	int.number.value

APP ACTIONS COST

cost_per_app_install

Field label	Cost per app install
Field type	metric
Data type	float.currency.value

cost_per_game_play

Field label	Cost per game play
Field type	metric
Data type	float.currency.value

cost_per_desktop_app_engagement

Field label	Cost per desktop app engagement
Field type	metric
Data type	float.currency.value

cost_per_desktop_app_install

Field label	Cost per desktop app install
Field type	metric
Data type	float.currency.value

cost_per_desktop_app_story_engagement

Field label	Cost per desktop app story engagement
Field type	metric
Data type	float.currency.value

cost_per_desktop_app_use

Field label	Cost per desktop app use
Field type	metric
Data type	float.currency.value

cost_per_credit_spend_action

Field label	Cost per credit spend action
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_achievement_unlocked

Field label	Cost per mobile app achievement unlocked
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_add_to_basket

Field label	Cost per mobile app add to basket
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_add_to_wishlist

Field label	Cost per mobile app add to wishlist
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_checkout_initiated

Field label	Cost per mobile app checkout initiated
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_content_view

Field label	Cost per mobile app content view
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_credit_spent

Field label	Cost per mobile app credit spent
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_install

Field label	Cost per mobile app install
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_level_completed

Field label	Cost per mobile app level completed
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_payment_info_add

Field label	Cost per mobile app payment info add
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_purchase

Field label	Cost per mobile app purchase
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_rating_submitted

Field label	Cost per mobile app rating submitted
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_registration_completed

Field label	Cost per mobile app registration completed
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_search

Field label	Cost per mobile app search
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_session

Field label	Cost per mobile app session
Field type	metric
Data type	float.currency.value

cost_per_mobile_app_tutorial_completed

Field label	Cost per mobile app tutorial completed
Field type	metric
Data type	float.currency.value

cost_per_other_mobile_app_action

Field label	Cost per other mobile app action
Field type	metric
Data type	float.currency.value

APP CONVERSION VALUE

action_value_app_custom_event.fb_mobile_spent_credits

Field label	Mobile app credits spent conversion value
Field type	metric
Data type	float.currency.value

action_value_app_custom_event.fb_mobile_purchase

Field label	Mobile app purchases conversion value
Field type	metric
Data type	float.currency.value

action_value_app_custom_event.fb_mobile_initiated_checkout

Field label	Mobile app checkouts conversion value
Field type	metric
Data type	float.currency.value

action_value.credit_spent

Field label	Credits spent conversion value
Field type	metric
Data type	float.currency.value

ATTRIBUTION

attribution_setting

Field label	Attribution setting
Description	The default attribution window to be used when the attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for a campaign or an account is calculated based on existing ad sets. Returns mixed, indicating multiple attribution settings, skan, indicating SKAdNetwork attribution of iOS 14 app install campaigns, and na, indicating no ad set in a campaign or account
Field type	dimension
Data type	string.text.value

AWARENESS

estimated_ad_recallers

Field label	Estimated ad recall lift (people)
Description	An estimate of the number of additional people who may remember seeing your ads, if asked, within 2 days. This metric is only available for assets in the Brand Awareness Objective
Field type	metric
Data type	int.number.value

estimated_ad_recall_rate

Field label	Estimated ad recall lift rate (%)
Description	The rate at which an estimated number of additional people, when asked, would remember seeing your ads within 2 days. This metric is only available for assets in the Brand Awareness Objective
Field type	metric
Data type	float.number.ratio

AWARENESS COST

cost_per_estimated_ad_recallers

Field label	Cost per estimated ad recall lift (people)
Description	The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand Awareness Objective
Field type	metric
Data type	float.currency.value

CALLS

click_to_call_call_confirm

Field label	Estimated call confirmation clicks
Description	The estimated number of times the call button is clicked on a call confirmation dialogue after an ad with a call destination is clicked
Field type	metric
Data type	int.number.value

click_to_call_native_call_placed

Field label	Messenger calls placed
Description	The number of times a Messenger call was made to your business, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan
Field type	metric
Data type	int.number.value

click_to_call_native_20s_call_connect

Field label	20-second Messenger calls
Description	The number of times Messenger calls resulted in successful connections lasting at least 20 seconds, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan, and only is available in select countries
Field type	metric
Data type	int.number.value

click_to_call_native_60s_call_connect

Field label	60-second Messenger calls
Description	The number of times Messenger calls resulted in successful connections lasting at least 60 seconds, attributed to your ad. This metric excludes ads that were delivered from Europe and Japan, and only is available in select countries
Field type	metric
Data type	int.number.value

CAMPAIGN DETAILS

adcampaign_name

Field label	Campaign name
Description	The name of the advertising campaign that you're viewing in reporting
Field type	dimension
Data type	string.text.value

adcampaign_id

Field label	Campaign ID
Description	The unique ID number of the advertising campaign that you're viewing in reporting
Field type	dimension
Data type	string.text.value

campaignobjective

Field label	Campaign objective
Description	The objective you selected for your campaign. Your objective reflects the goal you want to achieve with your advertising
Field type	dimension
Data type	string.text.value

campaignstatus

Field label	Campaign status (effective status)
Field type	dimension
Data type	string.text.value

campaign_tags

Field label	Campaign tags
Description	List of tags assigned to your campaign
Field type	dimension
Data type	string.text.value

campaign_edit_link

Field label	Campaign edit link
Description	Link to edit the campaign in Facebook Ads
Field type	dimension
Data type	string.text.url

campaignconfigured_status

Field label	Campaign configured status
Field type	dimension
Data type	string.text.value

campaignbuyingtype

Field label	Campaign buying type
Description	The method by which you pay for and target ads in your campaigns: through dynamic auction bidding, fixed-price bidding, or reach and frequency buying
Field type	dimension
Data type	string.text.value

campaignspend_cap

Field label	Campaign spending limit
Field type	dimension
Data type	float.currency.value

campaign_start_date

Field label	Campaign start date
Field type	dimension
Data type	string.time.date

campaign_end_date

Field label	Campaign end date
Field type	dimension
Data type	string.time.date

campaign_start_time

Field label	Campaign start date & time
Field type	dimension
Data type	string.text.value

campaign_end_time

Field label	Campaign end date & time
Field type	dimension
Data type	string.text.value

campaign_daily_budget

Field label	Campaign daily budget
Field type	dimension
Data type	float.currency.value

campaign_lifetime_budget

Field label	Campaign lifetime budget
Field type	dimension
Data type	float.currency.value

campaign_is_skadnetwork_attribution

Field label	Is Campaign using SKAdNetwork
Description	Flag to indicate that the campaign will be using SKAdNetwork, which also means that it will only be targeting iOS 14.x and above
Field type	dimension
Data type	bool

campaign_budget_remaining

Field label	Campaign budget remaining
Field type	dimension
Data type	float.currency.value

CAROUSEL CARD

ActionCarouselCardId

Field label	Carousel card ID
Field type	dimension
Data type	string.text.value

ActionCarouselCardName

Field label	Carousel card name
Field type	dimension
Data type	string.text.value

carousel_card_description

Field label	Carousel card description
Description	Description of carousel card
Field type	dimension
Data type	string.text.value

carousel_card_call_to_action_type

Field label	Carousel card call to action type
Description	Call to action type of carousel card
Field type	dimension
Data type	string.text.value

carousel_card_target_url

Field label	Carousel card target URL
Description	Target URL of carousel card
Field type	dimension
Data type	string.text.url

carousel_card_image_url

Field label	Carousel card image URL
Description	The image URL of the carousel card
Field type	dimension
Data type	string.text.url

carousel_card_image

Field label	Carousel card image
Description	The image of the carousel card
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

CLICKS

action_link_click

Field label	Link clicks
Field type	metric
Data type	int.number.value

unique_action_link_click

Field label	Unique link clicks
Field type	metric
Data type	int.number.value

outbound_clicks

Field label	Outbound clicks
Description	The number of clicks on links that take people off Facebook-owned properties
Field type	metric
Data type	int.number.value

unique_outbound_clicks

Field label	Unique outbound clicks
Description	The number of people who performed an outbound click
Field type	metric
Data type	int.number.value

link_CTR

Field label	CTR (link click-through rate)
Field type	metric
Data type	float.number.ratio

unique_link_CTR

Field label	Unique CTR (link click-through rate)
Description	The percentage of unique people who saw your ad and performed a link click. The metric is calculated as unique link clicks divided by reach
Field type	metric
Data type	float.number.ratio

outbound_CTR

Field label	Outbound CTR
Field type	metric
Data type	float.number.ratio

unique_outbound_CTR

Field label	Unique outbound CTR
Field type	metric
Data type	float.number.ratio

Clicks

Field label	Clicks (all)
Field type	metric
Data type	int.number.value

UniqueClicks

Field label	Unique clicks (all)
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

CTR

Field label	CTR (all)
Field type	metric
Data type	float.number.ratio

UCTR

Field label	Unique CTR (all)
Field type	metric
Data type	float.number.ratio

CLICKS COST

CPLC

Field label	CPC (link)
Field type	metric
Data type	float.currency.value

UCPLC

Field label	Cost per unique link click
Field type	metric
Data type	float.currency.value

CPOC

Field label	Cost per outbound click
Field type	metric
Data type	float.currency.value

UCPOC

Field label	Cost per unique outbound click
Field type	metric
Data type	float.currency.value

CPC

Field label	CPC (all)
Field type	metric
Data type	float.currency.value

UCPC

Field label	Cost per unique click (all)
Field type	metric
Data type	float.currency.value

COLLABORATIVE ADS

omni_add_to_cart_shared_item

Field label	Omni adds to cart (shared item)
Description	The number of add to cart events that contain at least one shared item attributed to your ads based on information from one or more of your partner's connected Facebook Business Tools
Field type	metric
Data type	int.number.value

catalog_segment_action_app_custom_event_fb_mobile_add_to_cart

Field label	Mobile app adds to cart (shared item)
Description	The number of times at least one shared item was added to a shopping cart in your partner's mobile app that were recorded as app events and attributed to your ads
Field type	metric
Data type	int.number.value

catalog_segment_action_offsite_conversion_fb_pixel_add_to_cart

Field label	Website adds to cart (shared item)
Description	The number of add to cart events that contain at least one shared item tracked by the pixel on your partner's website and attributed to your ads
Field type	metric
Data type	int.number.value

omni_content_view_shared_item

Field label	Omni content view (shared item)
Description	The number of view content events that contain at least one shared item, attributed to your ads, based on information from one or more of this partner's connected Facebook Business Tools
Field type	metric
Data type	int.number.value

catalog_segment_action_app_custom_event_fb_mobile_content_view

Field label	Mobile apps content view (shared item)
Description	The number of content views in your partner's mobile app that contain at least one shared item that were recorded as app events and attributed to your ads
Field type	metric
Data type	int.number.value

catalog_segment_action_offsite_conversion_fb_pixel_view_content

Field label	Website content view (shared item)
Description	The number of view content events that contain at least one shared item, tracked by the pixel on your partner's website and attributed to your ads
Field type	metric
Data type	int.number.value

omni_purchase_shared_item

Field label	Omni purchase (shared item)
Description	The number of purchase events that contain at least one shared item, based on information received from one or more of your partner's connected Facebook Business Tools
Field type	metric
Data type	int.number.value

catalog_segment_action_app_custom_event_fb_mobile_purchase

Field label	Mobile apps purchase (shared item)
Description	The number of purchases made in your partner's mobile app that contain at least one shared item that were recorded as app events and attributed to your ads
Field type	metric
Data type	int.number.value

catalog_segment_action_offsite_conversion_fb_pixel_purchase

Field label	Website purchase (shared item)
Description	The number of purchase events that contain at least one shared item, tracked by the pixel on your partner's website and attributed to your ads
Field type	metric
Data type	int.number.value

catalog_segment_action_onsite_conversion_purchase

Field label	On-Facebook purchase (shared item)
Description	The number of purchases made within a Facebook-owned property (such as Pages or Messenger) that contain at least one shared item attributed to your ads based on information from one or more of your partner's connected Facebook Business Tools
Field type	metric
Data type	int.number.value

catalog_segment_value_omni_add_to_card_value

Field label	Omni adds to cart conversion value (shared item)
Description	The total value of the shared items contained in add to cart events with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog
Field type	metric
Data type	float.currency.value

catalog_segment_value_app_custom_event_fb_mobile_add_to_cart

Field label	Mobile apps adds to cart conversion value (shared item)
Description	The total value of the shared items contained in mobile app adds to cart with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.currency.value

catalog_segment_value_offsite_conversion_fb_pixel_add_to_cart

Field label	Website adds to cart conversion value (shared item)
Description	The total value of the shared items contained in website adds to cart with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.currency.value

catalog_segment_value_omni_purchase_value

Field label	Omni purchase conversion value (shared item)
Description	The total value of the shared items contained in purchases with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.currency.value

catalog_segment_value_app_custom_event_fb_mobile_purchase

Field label	Mobile apps purchase conversion value (shared item)
Description	The total value of the shared items contained in mobile app purchases with shared items conversion, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.currency.value

catalog_segment_value_offsite_conversion_fb_pixel_purchase

Field label	Website purchase conversion value (shared item)
Description	The total value of the shared items contained in website purchases with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.currency.value

catalog_segment_value_omni_purchase_roas

Field label	Omni purchase ROAS (shared item)
Description	The total return on ad spend (ROAS) from the purchases that contained at least one shared item, based on information received from one or more of your partner's connected Facebook Business Tools
Field type	metric
Data type	float.number.value

catalog_segment_value_website_purchase_roas

Field label	Website purchase ROAS (shared item)
Description	The total return on ad spend (ROAS) from the shared items contained in website purchases with shared items
Field type	metric
Data type	float.number.value

catalog_segment_value_mobile_purchase_roas

Field label	Mobile app purchase ROAS (shared item)
Description	The total return on ad spend (ROAS) from the shared items contained in mobile app purchases with shared items
Field type	metric
Data type	float.number.value

catalog_segment_value_omni_view_content

Field label	Omni content view conversion value (shared item)
Description	The total value of the shared items contained in content views with shared items conversions, calculated from the sum of item price in the catalog multiplied by quantity of the items that are part of the event and belong to the promoted catalog segment
Field type	metric
Data type	float.number.value

CONVERSIONS BY CONVERSION WINDOW

actions_1d_view

Field label	Conversions within 1 day of view
Field type	metric
Data type	int.number.value

actions_7d_view

Field label	Conversions within 7 days of view
Field type	metric
Data type	int.number.value

actions_28d_view

Field label	Conversions within 28 days of view
Field type	metric
Data type	int.number.value

actions_1d_click

Field label	Conversions within 1 day of click
Field type	metric
Data type	int.number.value

actions_7d_click

Field label	Conversions within 7 days of click
Field type	metric
Data type	int.number.value

actions_28d_click

Field label	Conversions within 28 days of click
Field type	metric
Data type	int.number.value

action_values_1d_view

Field label	Conversion value within 1 day of view
Field type	metric
Data type	float.currency.value

action_values_7d_view

Field label	Conversion value within 7 days of view
Field type	metric
Data type	float.currency.value

action_values_28d_view

Field label	Conversion value within 28 days of view
Field type	metric
Data type	float.currency.value

action_values_1d_click

Field label	Conversion value within 1 day of click
Field type	metric
Data type	float.currency.value

action_values_7d_click

Field label	Conversion value within 7 days of click
Field type	metric
Data type	float.currency.value

action_values_28d_click

Field label	Conversion value within 28 days of click
Field type	metric
Data type	float.currency.value

COST

cost

Field label	Amount spent
Field type	metric
Data type	float.currency.value

cost_eur

Field label	Amount spent (EUR)
Description	Advertising cost converted to euros
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cost_gbp

Field label	Amount spent (GBP)
Description	Advertising cost in your account currency
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cost_usd

Field label	Amount spent (USD)
Description	Advertising cost converted to US dollars
Field type	metric
Data type	float.currency.value
Services	Currency conversion

cost_sek

Field label	Amount spent (SEK)
Description	Advertising cost converted to Swedish krona
Field type	metric
Data type	float.currency.value
Services	Currency conversion

CPP

Field label	Cost per 1000 people reached
Field type	metric
Data type	float.currency.value

CPM

Field label	CPM
Description	The average cost for 1,000 impressions
Field type	metric
Data type	float.currency.value

CPA

Field label	Cost per any action
Field type	metric
Data type	float.currency.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

OLD_reach_estimate_bid_curve_json

Field label	Reach estimate: bid estimate curve JSON
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_curve_reach

Field label	Reach estimate: bid estimate curve for reach
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_amount_max

Field label	Reach estimate: max bid amount
Field type	dimension
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_amount_median

Field label	Reach estimate: median bid amount
Field type	dimension
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_users

Field label	Reach estimate: users
Field type	dimension
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_amount_min

Field label	Reach estimate: min bid amount
Field type	dimension
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_curve_impressions

Field label	Reach estimate: bid estimate curve for impressions
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

OLD_reach_estimate_bid_curve_actions

Field label	Reach estimate: bid estimate curve for actions
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

relevance_positive_feedback

Field label	Relevance score positive feedback (deprecated)
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

relevance_negative_feedback

Field label	Relevance score negative feedback (deprecated)
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

relevance_status

Field label	Relevance score status
Description	Relevance score status.
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-03-25

instant_article_preview_url

Field label	Ad preview URL: instant article
Description	URL to a preview of the ad, as seen in the instant article standard placement.
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2023-12-12

OLD_reach_estimate_bid_curve_spend

Field label	Reach estimate: bid estimate curve for spend
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2020-01-20

cost_per_lead_form

Field label	Cost per lead (form)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-03-25

unique_actions_1d_view

Field label	Unique conversions within 1 day of view
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_checkouts

Field label	Website checkouts initiated (conversion tracking pixel) (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

card_views

Field label	Card views
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_onsite_web_add_to_cart

Field label	Unique web adds to cart
Description	The estimated number of people who added items to their cart on web.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

SocialReach

Field label	Social reach (deprecated)
Description	The number of people who saw your ad when displayed with social information, which shows other Facebook friends who engaged with your Facebook Page or ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2018-07-30
Aggregation	Non-aggregatable metric

UniqueSocialClicks

Field label	Unique social clicks (all) (deprecated)
Description	The number of people who performed a click (all) on your ad when it was displayed with social information, which shows other Facebook friends who engaged with your Facebook Page or ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30
Aggregation	Non-aggregatable metric

unique_action_omni_custom

Field label	Unique Omni custom actions
Description	The estimated number of people who performed custom actions across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

UniqueActionRate

Field label	People taking action rate %
Field type	metric
Data type	float.number.ratio
🚫 Deprecated	Deprecated on 2024-10-30

SocialClicks

Field label	Social clicks (all) (deprecated)
Description	The number of clicks (all) when your ad was displayed with social information, which shows other Facebook friends who engaged with your Facebook Page or ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

relevance_score_number

Field label	Relevance score
Description	A rating from 1 to 10 that estimates how well your target audience is responding to your ad. This score is shown after your ad receives more than 500 impressions.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-03-25
Aggregation	Non-aggregatable metric

UniqueActions

Field label	People taking action
Description	The number of people who took an action that was attributed to your ads.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

SocialImpressions

Field label	Social impressions (deprecated)
Description	The number of times your ads were viewed when displayed with social information, which shows Facebook friends who engaged with your Facebook Page or ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2018-07-30

cost_per_unique_mobile_app_payment_info_add

Field label	Cost per unique mobile app payment info add
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

action_mention

Field label	Page mentions (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_achievement_unlocked

Field label	Cost per unique mobile app achievement unlocked
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

action_tab_view

Field label	Page tab views (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_search

Field label	Unique Omni searches
Description	The estimated number of people who searched across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

action_receive_offer

Field label	Offer claims
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_tutorial_completion

Field label	Unique mobile app tutorials completed
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_page_mention

Field label	Cost per page mention (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_offsite_conversion_registration

Field label	Cost per website registration (conversion tracking pixel) (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

cost_per_page_tab_view

Field label	Cost per page tab view (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_leads

Field label	Website leads (conversion tracking pixel) (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

cost_per_offer_claim

Field label	Cost per offer claim
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

store_visits_low_estimate

Field label	Store visits low estimate
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_page_engagement

Field label	Unique page engagements
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_actions_7d_click

Field label	Unique conversions within 7 days of click
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_like

Field label	Unique page likes
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_search

Field label	Cost per unique mobile app search
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_mention

Field label	Unique page mentions (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_content_view

Field label	Cost per unique mobile app content view
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_tab_view

Field label	Unique page tab views (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_desktop_app_install

Field label	Cost per unique desktop app install
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_comment

Field label	Unique post comments
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_level_achieved

Field label	Unique Omni level completed
Description	The estimated number of people who completed level across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_post_engagement

Field label	Unique post engagements
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_purchase

Field label	Unique Omni purchases
Description	The estimated number of people who completed at least one purchase across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_post_reaction

Field label	Unique post reactions
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_app_event

Field label	Unique web app events
Description	The estimated number of people who engaged on web app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_post

Field label	Unique post shares
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_rate

Field label	Unique mobile app ratings submitted
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_photo_view

Field label	Unique photo views
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_mobile_app_action

Field label	Cost per mobile app action (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_rsvp

Field label	Unique event responses
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_offsite_conversion_lead

Field label	Cost per website lead (conversion tracking pixel) (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_receive_offer

Field label	Unique offer claims
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_registrations

Field label	Website registrations (conversion tracking pixel) (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_checkin

Field label	Unique check-ins
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

action_app_custom_event

Field label	Mobile app actions (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_landing_page_view

Field label	Unique landing page views
Description	The number of unique people who landed on your ad's landing page after clicking a link in your ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

app_store_clicks

Field label	App store clicks
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

cost_per_unique_action_page_engagement

Field label	Cost per unique page engagement
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

store_visits_point_estimate

Field label	Store visits point estimate
Description	This field is still being developed by Facebook and as such it might not return any data.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2021-05-01

cost_per_unique_video_view

Field label	Cost per unique video view
Description	The average cost for each unique video view.
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

action_leadgen.other

Field label	Leads (form)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-03-25

cost_per_unique_link_click

Field label	Cost per unique link click
Description	The average cost for each unique click to link.
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_actions_28d_view

Field label	Unique conversions within 28 days of view
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_page_like

Field label	Cost per unique page like
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_tutorial_completed

Field label	Cost per unique mobile app tutorial completed
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_page_mention

Field label	Cost per unique page mention (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_rating_submitted

Field label	Cost per unique mobile app rating submitted
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_page_tab_view

Field label	Cost per unique page tab view (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_install

Field label	Cost per unique mobile app install
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_post_comment

Field label	Cost per unique post comment
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_add_to_wishlist

Field label	Cost per unique mobile app add to wishlist
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_post_engagement

Field label	Cost per unique post engagement
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_desktop_app_use

Field label	Cost per unique desktop app use
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_post_reaction

Field label	Cost per unique post reaction
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_action

Field label	Cost per unique mobile app action
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_post_share

Field label	Cost per unique post share
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_spend_credits

Field label	Unique Omni credit spends
Description	The estimated number of people who spent credits across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_photo_view

Field label	Cost per unique photo view
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_achievement_unlocked

Field label	Unique Omni achievement unlocks
Description	The estimated number of people who unlocked achievement across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_event_response

Field label	Cost per unique event response
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_complete_registration

Field label	Unique Omni completed registrations
Description	The estimated number of people who completed registration across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_offer_claim

Field label	Cost per unique offer claim
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_purchase

Field label	Unique web purchases
Description	The estimated number of people who completed at least one purchase on web.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_checkin

Field label	Cost per unique check-in
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_app_view_content

Field label	Unique web app content views
Description	The estimated number of people who viewed content on web app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

messaging_conversations_started

Field label	Messaging conversations started (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2019-08-08

unique_action_mobile_app_roas

Field label	Unique mobile app ROAS
Description	The estimated number of people who generated mobile app purchase ROAS.
Field type	metric
Data type	float.number.ratio
🚫 Deprecated	Deprecated on 2024-10-30

messaging_reply_rate

Field label	Messaging reply rate
Field type	metric
Data type	float.number.ratio
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_search

Field label	Unique mobile app searches
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_messaging_reply

Field label	Cost per messaging reply
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_level_achieved

Field label	Unique mobile app levels completed
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_video_view

Field label	Unique three-second video views
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

messaging_replies

Field label	Messaging replies
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

video_15_sec_watched_actions

Field label	15-second video views (Deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2018-07-30

cost_per_offsite_conversion_checkout

Field label	Cost per website checkout initiated (conversion tracking pixel) (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_video_play

Field label	Unique clicks to play video
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_offsite_conversion_other

Field label	Cost per other website conversion (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

estimated_ad_recallers_lower_bound

Field label	Estimated ad recall lift (lower bound)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-03-25

cost_per_offsite_conversion_key_page_view

Field label	Cost per website key page view (conversion tracking pixel) (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

estimated_ad_recallers_upper_bound

Field label	Estimated ad recall lift (upper bound)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-03-25

cost_per_offsite_conversion_add_to_cart

Field label	Cost per website add to cart (conversion tracking pixel) (deprecated)
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_page_story

Field label	Unique page stories engagements
Description	The estimated number of people who engaged with page stories.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_other

Field label	Other website conversions (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_post_story

Field label	Unique post stories engagements
Description	The estimated number of people who engaged with post stories.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_key_page_view

Field label	Website key page views (conversion tracking pixel) (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_instagram_profile_engagement

Field label	Unique instagram profile engagements
Description	The estimated number of people who engaged with instagram profile.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

offsite_conversions_add_to_cart

Field label	Website adds to cart (conversion tracking pixel) (deprecated)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_onsite_conversion

Field label	Unique conversions
Description	The estimated number of people with onsite conversions.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

call_to_action_clicks

Field label	Call-to-action clicks (deprecated)
Description	The number of times people clicked the call-to-action button on your ad.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_add_to_cart

Field label	Unique adds to cart
Description	The estimated number of people who added items to their cart.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

deeplink_clicks

Field label	Deeplink clicks
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_store_visit_with_dwell

Field label	Unique store visits with dwell
Description	The estimated number of people visited your stores, attributed to your ads with `Dwell time`.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

store_visits_high_estimate

Field label	Store visits high estimate
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_complete_registration

Field label	Unique completed registrations
Description	The estimated number of people who registered.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_store_visit

Field label	Cost per store visit
Description	This field is still being developed by Facebook and as such it might not return any data.
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2021-05-01
Aggregation	Non-aggregatable metric

unique_action_purchase

Field label	Unique purchases
Description	The estimated number of people who completed at least one purchase.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_leadgen.other

Field label	Unique leads (form)
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-03-25

unique_action_search

Field label	Unique searches
Description	The estimated number of people who searched.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_actions_28d_click

Field label	Unique conversions within 28 days of click
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_view_content

Field label	Unique content views
Description	The estimated number of people who viewed content.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_actions_1d_click

Field label	Unique conversions within 1 day of click
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_initiate_checkout

Field label	Unique initiated checkouts
Description	The estimated number of people who initiated checkouts.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_actions_7d_view

Field label	Unique conversions within 7 days of view
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_add_payment_info

Field label	Unique payment info adds
Description	The estimated number of people who submitted payment info.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_other_unique_mobile_app_action

Field label	Cost per other unique mobile app action
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_add_to_wishlist

Field label	Unique adds to wishlist
Description	The estimated number of people who added items to their wishlist.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_session

Field label	Cost per unique mobile app session
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_lead

Field label	Unique leads
Description	The estimated number of people with lead events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_registration_completed

Field label	Cost per unique mobile app registration completed
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_subscribe

Field label	Unique subscribes
Description	The estimated number of people with subscribe events.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_purchase

Field label	Cost per unique mobile app purchase
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_credit_spent

Field label	Unique credit spends
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_level_completed

Field label	Cost per unique mobile app level completed
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_games.plays

Field label	Unique game plays
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_credit_spent

Field label	Cost per unique mobile app credit spent
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_engagement

Field label	Unique desktop app engagements
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_checkout_initiated

Field label	Cost per unique mobile app checkout initiated
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_install

Field label	Unique desktop app installs
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_mobile_app_add_to_basket

Field label	Cost per unique mobile app add to basket
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_story

Field label	Unique desktop app story engagements
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_credit_spend_action

Field label	Cost per unique credit spend action
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_use

Field label	Unique desktop app uses
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_desktop_app_story_engagement

Field label	Cost per unique desktop app story engagement
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_app_add_to_cart

Field label	Unique desktop adds to cart
Description	The estimated number of people who added items to their cart on desktop app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_desktop_app_engagement

Field label	Cost per unique desktop app engagement
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_app_view_content

Field label	Unique desktop content views
Description	The estimated number of people who viewed content on desktop app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_unique_game_play

Field label	Cost per unique game play
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_app_purchase

Field label	Unique desktop purchases
Description	The estimated number of people who completed at least one purchase on desktop app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_tutorial_completion

Field label	Unique Omni completed tutorials
Description	The estimated number of people who completed tutorials across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_offsite_conversion

Field label	Unique website conversions
Description	The estimated number of people with offsite conversions.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_rate

Field label	Unique Omni rates
Description	The estimated number of people who rated across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_offsite_engagement

Field label	Unique website engagements
Description	The estimated number of people with offsite engagements.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_activate_app

Field label	Unique Omni app activations
Description	The estimated number of people who activated app across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_achievement_unlocked

Field label	Unique mobile app achievements unlocked
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_initiated_checkout

Field label	Unique Omni initiated checkouts
Description	The estimated number of people who initiated checkout across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event

Field label	Unique mobile app actions
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_view_content

Field label	Unique Omni content views
Description	The estimated number of people who viewed content across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_add_payment_info

Field label	Unique mobile app adds of payment info
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_add_to_cart

Field label	Unique Omni adds to cart
Description	The estimated number of people who added items to their cart across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_add_to_cart

Field label	Unique mobile app adds to cart
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_omni_app_install

Field label	Unique Omni app installs
Description	The estimated number of people who completed app installs across all channels.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_add_to_wishlist

Field label	Unique mobile app adds to wishlist
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_view_content

Field label	Unique web content views
Description	The estimated number of people who viewed content on web.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_initiated_checkout

Field label	Unique mobile app checkouts initiated
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_app_purchase

Field label	Unique web app purchases
Description	The estimated number of people who completed at least one purchase on web app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_app_custom_event.fb_mobile_content_view

Field label	Unique mobile app content views
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_onsite_web_app_add_to_cart

Field label	Unique web app adds to cart
Description	The estimated number of people who added items to their cart on web app.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

action_gift_sale

Field label	Gift sales
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2017-04-18
Destinations	BigQuery

unique_action_app_custom_event.other

Field label	Other unique mobile app actions
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_follow

Field label	Unique question follows
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2017-04-18
Destinations	BigQuery

unique_action_mobile_app_retention

Field label	Unique mobile app retentions
Description	The estimated number of people who performed mobile app retention.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

action_follow

Field label	Question follows
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2017-04-18
Destinations	BigQuery

unique_action_app_custom_event.fb_mobile_activate_app

Field label	Unique mobile app sessions
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

video_average_watched

Field label	Video average percentage watched
Description	The average percentage of your video that people watched.
Field type	metric
Data type	float.number.percentage
🚫 Deprecated	Deprecated on 2020-01-20
Aggregation	Non-aggregatable metric

unique_action_app_custom_event.fb_mobile_complete_registration

Field label	Unique mobile app registrations completed
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

cost_per_10s_video_view

Field label	Cost per ten-second video view
Field type	metric
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_app_custom_event.fb_mobile_purchase

Field label	Unique mobile app purchases
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

video_10_sec_watched_actions

Field label	Ten-second video views
Description	The number of times your video was watched for an aggregate of at least 10 seconds, or for nearly its total length, whichever happened first.
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2020-01-20

unique_action_app_custom_event.fb_mobile_spent_credits

Field label	Unique mobile app credits spent
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

unique_action_mobile_app_install

Field label	Unique mobile app installs
Field type	metric
Data type	int.number.value
🚫 Deprecated	Deprecated on 2024-10-30

DYNAMIC CREATIVE ADS

body_asset_id

Field label	Body asset ID
Description	Body asset ID
Field type	dimension
Data type	string.text.value

body_asset_text

Field label	Body asset text
Description	Body asset text
Field type	dimension
Data type	string.text.value

description_asset_id

Field label	Description asset ID
Description	Description asset ID
Field type	dimension
Data type	string.text.value

description_asset_text

Field label	Description asset text
Description	Description asset text
Field type	dimension
Data type	string.text.value

image_asset_id

Field label	Image asset ID
Description	ID for an image asset
Field type	dimension
Data type	string.text.value

image_asset_name

Field label	Image asset name
Description	Name for an image asset
Field type	dimension
Data type	string.text.value

image_asset_hash

Field label	Image asset hash
Description	Hash for an image asset
Field type	dimension
Data type	string.text.value

image_asset_url

Field label	Image asset URL
Description	URL for an image asset
Field type	dimension
Data type	string.text.url

title_asset_id

Field label	Title asset ID
Description	Title asset ID
Field type	dimension
Data type	string.text.value

title_asset_text

Field label	Title asset text
Description	Title asset text
Field type	dimension
Data type	string.text.value

call_to_action_asset_id

Field label	Call to action asset ID
Description	Call to action asset asset ID
Field type	dimension
Data type	string.text.value

call_to_action_asset_name

Field label	Call to action asset name
Description	Call to action asset name
Field type	dimension
Data type	string.text.value

link_url_asset_id

Field label	Link asset ID
Description	Link asset ID
Field type	dimension
Data type	string.text.value

link_url_asset_website_url

Field label	Link asset website URL
Description	Website URL for a link URL asset
Field type	dimension
Data type	string.text.url

link_url_asset_display_url

Field label	Link URL asset display URL
Description	Link URL asset display URL
Field type	dimension
Data type	string.text.url

video_asset_video_name

Field label	Video asset name
Description	Video asset name
Field type	dimension
Data type	string.text.value

video_asset_id

Field label	Video asset ID
Description	Video asset ID
Field type	dimension
Data type	string.text.value

video_asset_video_id

Field label	Video asset video ID
Description	Video asset video ID
Field type	dimension
Data type	string.text.value

video_asset_url

Field label	Video asset URL
Description	Video asset URL
Field type	dimension
Data type	string.text.url

video_asset_thumbnail_url

Field label	Video asset thumbnail URL
Description	Video asset thumbnail URL
Field type	dimension
Data type	string.text.url

video_asset_thumbnail_image

Field label	Video asset thumbnail image
Description	Video asset thumbnail image
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

IMPRESSION

impression_device

Field label	Impression device
Field type	dimension
Data type	string.text.value

placement

Field label	Placement
Field type	dimension
Data type	string.text.value

place_page_id

Field label	Place page ID
Field type	dimension
Data type	string.text.value

publisher_platform

Field label	Publisher platform
Description	Distinguishes between platforms like Facebook and Instagram
Field type	dimension
Data type	string.text.value

platform_position

Field label	Platform position
Field type	dimension
Data type	string.text.value

device_platform

Field label	Device platform
Field type	dimension
Data type	string.text.value

LEAD ADS

lead_form_id

Field label	Lead form ID
Field type	dimension
Data type	string.text.value

lead_form_name

Field label	Lead form name
Field type	dimension
Data type	string.text.value

lead_form_status

Field label	Lead form status
Field type	dimension
Data type	string.text.value

lead_created_time

Field label	Lead created
Field type	dimension
Data type	string.text.value

lead_id

Field label	Lead ID
Field type	dimension
Data type	string.text.value

lead_info

Field label	Lead info
Field type	dimension
Data type	string.text.value

lead_info_json

Field label	Lead info (JSON)
Field type	dimension
Data type	string.text.value

lead_email

Field label	Lead email
Field type	dimension
Data type	string.text.email

lead_phone_number

Field label	Lead phone number
Field type	dimension
Data type	string.text.value

lead_full_name

Field label	Lead full name
Field type	dimension
Data type	string.text.value

lead_company_name

Field label	Lead company name
Field type	dimension
Data type	string.text.value

lead_country

Field label	Lead country
Field type	dimension
Data type	string.geo.country

lead_state

Field label	Lead state
Field type	dimension
Data type	string.geo.region

lead_name_f1

Field label	Lead field 1 name
Field type	dimension
Data type	string.text.value

lead_name_f2

Field label	Lead field 2 name
Field type	dimension
Data type	string.text.value

lead_name_f3

Field label	Lead field 3 name
Field type	dimension
Data type	string.text.value

lead_name_f4

Field label	Lead field 4 name
Field type	dimension
Data type	string.text.value

lead_name_f5

Field label	Lead field 5 name
Field type	dimension
Data type	string.text.value

lead_name_f6

Field label	Lead field 6 name
Field type	dimension
Data type	string.text.value

lead_value_f1

Field label	Lead field 1 value
Field type	dimension
Data type	string.text.value

lead_value_f2

Field label	Lead field 2 value
Field type	dimension
Data type	string.text.value

lead_value_f3

Field label	Lead field 3 value
Field type	dimension
Data type	string.text.value

lead_value_f4

Field label	Lead field 4 value
Field type	dimension
Data type	string.text.value

lead_value_f5

Field label	Lead field 5 value
Field type	dimension
Data type	string.text.value

lead_value_f6

Field label	Lead field 6 value
Field type	dimension
Data type	string.text.value

MEDIA

action_video_view

Field label	Three-second video views
Field type	metric
Data type	int.number.value

video_30_sec_watched_actions

Field label	30-second video views
Description	The number of times your video was watched for an aggregate of at least 30 seconds, or for nearly its total length, whichever happened first
Field type	metric
Data type	int.number.value

video_p25_watched_actions

Field label	Video watches at 25%
Description	The number of times your video was watched at 25% of its length, including watches that skipped to this point
Field type	metric
Data type	int.number.value

video_p50_watched_actions

Field label	Video watches at 50%
Description	The number of times your video was watched at 50% of its length, including watches that skipped to this point
Field type	metric
Data type	int.number.value

video_p75_watched_actions

Field label	Video watches at 75%
Description	The number of times your video was watched at 75% of its length, including watches that skipped to this point
Field type	metric
Data type	int.number.value

video_p95_watched_actions

Field label	Video watches at 95%
Description	The number of times your video was watched at 95% of its length, including watches that skipped to this point
Field type	metric
Data type	int.number.value

video_p100_watched_actions

Field label	Video watches at 100%
Description	The number of times your video was watched at 100% of its length, including watches that skipped to this point
Field type	metric
Data type	int.number.value

video_continuous_2_sec_watched_actions

Field label	2-second continuous video plays
Description	The number of times your video was played for two continuous seconds or more. Two-second continuous video plays will have at least 50% of the video pixels in view
Field type	metric
Data type	int.number.value

video_average_watch_time

Field label	Video average watch time
Description	The average time a video was played in seconds, including any time spent replaying the video for a single impression. As this contains replays, the watch time may be longer than the actual video length
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

action_video_play

Field label	Clicks to play video
Field type	metric
Data type	int.number.value

video_play_actions

Field label	Video play actions
Description	The number of times your video starts to play. This is counted for each impression of a video, and excludes replays
Field type	metric
Data type	int.number.value

video_play_curve_actions_s0

Field label	Video play curve actions second: 0
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 0 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s1

Field label	Video play curve actions second: 1
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 1 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s2

Field label	Video play curve actions second: 2
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 2 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s3

Field label	Video play curve actions second: 3
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 3 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s4

Field label	Video play curve actions second: 4
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 4 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s5

Field label	Video play curve actions second: 5
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 5 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s6

Field label	Video play curve actions second: 6
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 6 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s7

Field label	Video play curve actions second: 7
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 7 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s8

Field label	Video play curve actions second: 8
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 8 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s9

Field label	Video play curve actions second: 9
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 9 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s10

Field label	Video play curve actions second: 10
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 10 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s11

Field label	Video play curve actions second: 11
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 11 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s12

Field label	Video play curve actions second: 12
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 12 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s13

Field label	Video play curve actions second: 13
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 13 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s14

Field label	Video play curve actions second: 14
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 14 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s15_s20

Field label	Video play curve actions second: 15-20
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 15-20 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s20_s25

Field label	Video play curve actions second: 20-25
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 20-25 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s25_s30

Field label	Video play curve actions second: 25-30
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 25-30 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s30_s40

Field label	Video play curve actions second: 30-40
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 30-40 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s40_s50

Field label	Video play curve actions second: 40-50
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 40-50 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s50_s60

Field label	Video play curve actions second: 50-60
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 50-60 second
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_play_curve_actions_s60

Field label	Video play curve actions second 60 and more
Description	A video-play based curve graph that illustrates the percentage of video plays that reached 60 seconds and more
Field type	metric
Data type	int.number.percentage
Aggregation	Non-aggregatable metric

video_thruplay_watched_actions

Field label	ThruPlay actions
Description	The number of times your video was played to completion, or for at least 15 seconds
Field type	metric
Data type	int.number.value

canvas_avg_view_time

Field label	Avg. canvas view time
Description	The average total time, in seconds, that people spent viewing a Facebook Canvas. Canvas is a screen that opens on mobile after a person clicks the Canvas link in your ad. It may include a series of interactive or multimedia components, including video, images, product catalogs and more
Field type	metric
Data type	float.number.value
Aggregation	Non-aggregatable metric

canvas_avg_view_percent

Field label	Avg. canvas view percentage
Description	The average percentage of the Facebook Canvas that people saw. Canvas is a screen that opens on mobile after a person clicks the Canvas link in your ad. It may include a series of interactive or multimedia components, including video, images, product catalogs and more
Field type	metric
Data type	float.number.ratio
Aggregation	Non-aggregatable metric

MEDIA COST

cost_per_3s_video_view

Field label	Cost per three-second video view
Field type	metric
Data type	float.currency.value

cost_per_2_sec_continuous_video_view

Field label	Cost per 2-second continuous video play
Description	The average cost for each 2-second continuous videoplay. Calculated by: Amount spent / 2-second continuous video plays
Field type	metric
Data type	float.currency.value

cost_per_thruplay

Field label	Cost per ThruPlay
Description	The average cost for each ThruPlay
Field type	metric
Data type	float.currency.value

MESSAGING

new_messaging_conversations

Field label	New messaging contacts
Description	The number of accounts that messaged your business for the first time, attributed to your ads. This doesn't include new messaging contacts from ads delivered to or from Europe or Japan
Field type	metric
Data type	int.number.value

new_messaging_conversations_7d

Field label	Messaging conversations started
Description	The number of accounts that messaged your business for the first time, attributed to your ads. This doesn't include new messaging contacts from ads delivered to or from Europe or Japan
Field type	metric
Data type	int.number.value

blocked_message_conversations

Field label	Blocked messaging conversations
Description	The number of times people blocked messages from your business on messaging apps (such as Facebook Messenger), attributed to your ads. Also called "Blocks"
Field type	metric
Data type	int.number.value

onsite_conversion_messaging_user_subscribed

Field label	Messaging subscription
Description	The number of times an account has subscribed to receive marketing messages from your business, attributed to your ad. If an account has subscribed to multiple topics, it will be counted again for each topic
Field type	metric
Data type	int.number.value

MESSAGING COST

cost_per_new_messaging_conversation

Field label	Cost per new messaging contact
Description	The average cost for each new messaging contact. Calculated by: Amount spent / New messaging contacts
Field type	metric
Data type	float.currency.value

cost_per_messaging_conversation_started

Field label	Cost per messaging conversations started
Description	The average cost for each messaging conversation started. Calculated by: Amount spent / Messaging conversations started
Field type	metric
Data type	float.currency.value

MOBILE APP CONVERSION VALUE

app_custom_event_fb_mobile_add_to_cart

Field label	Mobile app adds to cart conversion value
Description	The conversion value of cart adds made on mobile platforms
Field type	metric
Data type	float.currency.value

OFFLINE

offline_conversions_leads

Field label	Offline leads
Field type	metric
Data type	int.number.value

offline_conversion_purchase

Field label	Offline purchases
Field type	metric
Data type	int.number.value

offline_other_conversion

Field label	Offline other conversions
Field type	metric
Data type	int.number.value

offline_conversion_add_payment_info

Field label	Offline adds of payment info
Field type	metric
Data type	int.number.value

offline_conversion_add_to_cart

Field label	Offline adds to cart
Field type	metric
Data type	int.number.value

offline_conversion_add_to_wishlist

Field label	Offline adds to wishlist
Field type	metric
Data type	int.number.value

offline_conversion_complete_registration

Field label	Offline registrations completed
Field type	metric
Data type	int.number.value

offline_conversion_initiate_checkout

Field label	Offline checkouts initiated
Field type	metric
Data type	int.number.value

offline_conversion_search

Field label	Offline searches
Field type	metric
Data type	int.number.value

offline_conversion_view_content

Field label	Offline content views
Field type	metric
Data type	int.number.value

OFFLINE CONVERSION VALUE

offline_conversion_add_payment_info_action_value

Field label	Offline adds of payment info conversion value
Field type	metric
Data type	int.number.value

offline_conversion_add_to_cart_action_value

Field label	Offline adds to cart conversion value
Field type	metric
Data type	int.number.value

offline_conversion_add_to_wishlist_action_value

Field label	Offline adds to wishlist conversion value
Field type	metric
Data type	int.number.value

offline_conversion_complete_registration_action_value

Field label	Offline registrations completed conversion value
Field type	metric
Data type	int.number.value

offline_conversion_initiate_checkout_action_value

Field label	Offline checkouts initiated conversion value
Field type	metric
Data type	int.number.value

offline_conversion_lead_action_value

Field label	Offline leads conversion value
Field type	metric
Data type	int.number.value

offline_conversion_other_action_value

Field label	Offline other conversion value
Field type	metric
Data type	int.number.value

offline_conversion_purchase_action_value

Field label	Offline purchases conversion value
Field type	metric
Data type	int.number.value

offline_conversion_search_action_value

Field label	Offline searches conversion value
Field type	metric
Data type	int.number.value

offline_conversion_view_content_action_value

Field label	Offline content views conversion value
Field type	metric
Data type	int.number.value

OMNI CONVERSION VALUE

purchase_conversion_value

Field label	Purchase conversion value
Field type	metric
Data type	float.currency.value

ON FACEBOOK

on_facebook_purchases

Field label	On-Facebook purchases
Field type	metric
Data type	int.number.value

on_facebook_workflow_completion

Field label	On-Facebook workflow completion
Field type	metric
Data type	int.number.value

onsite_conversion.lead_grouped

Field label	On-Facebook leads
Field type	metric
Data type	int.number.value

on_facebook_view_content

Field label	On-Facebook view content
Description	The number of product views within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads
Field type	metric
Data type	int.number.value

on_facebook_click_to_call

Field label	Phone number clicks
Description	The number of times that your phone number or Call Now button was clicked on your on-Facebook listing (such as a Marketplace listing), attributed to your ads
Field type	metric
Data type	int.number.value

on_facebook_find_location

Field label	Get directions clicks
Description	The number of times that your address or the Get Directions button was clicked on your on-Facebook listing (such as a Marketplace listing), attributed to your ads
Field type	metric
Data type	int.number.value

ON FACEBOOK CONVERSION VALUE

on_facebook_purchase_conversion_value

Field label	Conversion value of purchase on Facebook
Field type	metric
Data type	float.currency.value

on_facebook_workflow_completion_conversion_value

Field label	Conversion value of workflow completion on Facebook
Field type	metric
Data type	float.currency.value

ON FACEBOOK COST

cost_per_on_facebook_purchase

Field label	Cost per on-Facebook purchase
Field type	metric
Data type	float.currency.value

cost_per_on_facebook_workflow_completion

Field label	Cost per workflow completion on Facebook
Field type	metric
Data type	float.currency.value

cost_per_on_facebook_lead

Field label	Cost per on-Facebook lead
Field type	metric
Data type	float.currency.value

cost_per_on_facebook_view_content

Field label	Cost per on-Facebook view content
Field type	metric
Data type	float.currency.value

cost_per_on_facebook_click_to_call

Field label	Cost per on-Facebook phone number click
Field type	metric
Data type	float.currency.value

cost_per_on_facebook_find_location

Field label	Cost per on-Facebook get directions click
Field type	metric
Data type	float.currency.value

OTHER

inline_link_clicks

Field label	Inline link clicks
Description	The number of clicks on links to select destinations or experiences, on or off Facebook-owned properties. Inline link clicks use a fixed 1-day-click attribution window
Field type	metric
Data type	int.number.value

unique_inline_link_clicks

Field label	Unique inline link clicks
Description	The number of people who performed an inline link click
Field type	metric
Data type	int.number.value

inline_post_engagement

Field label	Inline post engagement
Description	The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window
Field type	metric
Data type	int.number.value

PAGE POST ENGAGEMENT

action_page_engagement

Field label	Page engagements
Field type	metric
Data type	int.number.value

action_like

Field label	Page likes
Field type	metric
Data type	int.number.value

action_subscribe

Field label	Page subscribes
Description	Page subscribe actions
Field type	metric
Data type	int.number.value

action_comment

Field label	Post comments
Field type	metric
Data type	int.number.value

action_post_engagement

Field label	Post engagements
Field type	metric
Data type	int.number.value

action_post_like

Field label	Post reactions
Field type	metric
Data type	int.number.value

post_save

Field label	Post saves
Field type	metric
Data type	int.number.value

action_post

Field label	Post shares
Field type	metric
Data type	int.number.value

action_photo_view

Field label	Photo views
Field type	metric
Data type	int.number.value

action_rsvp

Field label	Event responses
Field type	metric
Data type	int.number.value

action_checkin

Field label	Check-ins
Field type	metric
Data type	int.number.value

PAGE POST ENGAGEMENT COST

cost_per_page_engagement

Field label	Cost per page engagement
Field type	metric
Data type	float.currency.value

cost_per_page_like

Field label	Cost per page like
Field type	metric
Data type	float.currency.value

cost_per_post_comment

Field label	Cost per post comment
Field type	metric
Data type	float.currency.value

cost_per_post_engagement

Field label	Cost per post engagement
Field type	metric
Data type	float.currency.value

cost_per_post_reaction

Field label	Cost per post reaction
Field type	metric
Data type	float.currency.value

cost_per_post_share

Field label	Cost per post share
Field type	metric
Data type	float.currency.value

cost_per_photo_view

Field label	Cost per photo view
Field type	metric
Data type	float.currency.value

cost_per_event_response

Field label	Cost per event response
Field type	metric
Data type	float.currency.value

cost_per_checkin

Field label	Cost per check-in
Field type	metric
Data type	float.currency.value

PERFORMANCE

quality_score_organic_text

Field label	Quality ranking (text)
Description	Ad's perceived quality compared with ads competing for the same audience
Field type	dimension
Data type	string.text.value

quality_score_ectr_text

Field label	Engagement Rate Ranking (text)
Description	Ad's expected engagement rate compared with ads competing for the same audience
Field type	dimension
Data type	string.text.value

quality_score_ecvr_text

Field label	Conversion Rate Ranking (text)
Description	Ad's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience
Field type	dimension
Data type	string.text.value

reach

Field label	Reach
Description	The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

reach7d

Field label	Reach (7 days)
Description	The number of people who saw your ads at least once in the last 7 days. Reach is different from impressions, which may include multiple views of your ads by the same people
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric
Destinations	BigQuery

reach28d

Field label	Reach (28d)
Description	The number of people who saw your ads at least once in the last 28 days. Reach is different from impressions, which may include multiple views of your ads by the same people
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric
Destinations	BigQuery

Frequency

Field label	Frequency
Description	The average number of times each person saw your ad
Field type	metric
Data type	float.number.value

impressions

Field label	Impressions
Description	The number of times your ads were on screen
Field type	metric
Data type	int.number.value

Actions

Field label	Actions
Field type	metric
Data type	int.number.value

SocialSpend

Field label	Social spend
Field type	metric
Data type	float.currency.value

ActionRate

Field label	Action rate %
Field type	metric
Data type	float.number.ratio

actionvalue

Field label	Total action value
Field type	metric
Data type	float.currency.value

ROAS_perc

Field label	Return on ad spend (ROAS) %
Field type	metric
Data type	float.number.percentage
Destinations	API, Data warehouse, Google Sheets

ROAS

Field label	Return on ad spend (ROAS)
Field type	metric
Data type	float.number.ratio

quality_score_organic

Field label	Quality ranking
Description	Ad's perceived quality compared with ads competing for the same audience
Field type	metric
Data type	int.number.value

quality_score_ectr

Field label	Engagement Rate Ranking
Description	Ad's expected engagement rate compared with ads competing for the same audience
Field type	metric
Data type	int.number.value

quality_score_ecvr

Field label	Conversion Rate Ranking
Description	Ad's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience
Field type	metric
Data type	int.number.value

PRODUCT

product_id

Field label	Product ID
Field type	dimension
Data type	string.text.value

PROMOTED POST

promoted_post_id

Field label	Post ID
Field type	dimension
Data type	string.text.value

promoted_post_id_ig

Field label	Post Instagram ID
Field type	dimension
Data type	string.text.value

promoted_post_type

Field label	Post type
Field type	dimension
Data type	string.text.value

promoted_post_source

Field label	Post source
Field type	dimension
Data type	string.text.value

promoted_page_name

Field label	Page name
Description	The Facebook Page associated with the business your ad is promoting. Only works at ad level
Field type	dimension
Data type	string.text.value

promoted_page_id

Field label	Page ID
Description	ID of the Facebook Page associated with the business your ad is promoting. Only works at ad level
Field type	dimension
Data type	string.text.value

promoted_post_name

Field label	Post name
Field type	dimension
Data type	string.text.value

promoted_post_caption

Field label	Post caption
Field type	dimension
Data type	string.text.value

promoted_post_message

Field label	Post message
Field type	dimension
Data type	string.text.value

promoted_post_story

Field label	Post story
Field type	dimension
Data type	string.text.value

promoted_post_description

Field label	Post description
Field type	dimension
Data type	string.text.value

promoted_post_destination_url

Field label	Promoted post destination URL
Field type	dimension
Data type	string.text.url

promoted_destination_url

Field label	Existing post destination URL
Field type	dimension
Data type	string.text.url

promoted_post_privacy

Field label	Post privacy
Field type	dimension
Data type	string.text.value

promoted_post_privacy_description

Field label	Post privacy description
Field type	dimension
Data type	string.text.value

promoted_post_icon

Field label	Post icon
Field type	dimension
Data type	string.text.value

promoted_post_picture

Field label	Post thumbnail URL
Field type	dimension
Data type	string.text.url

promoted_post_picture_image

Field label	Promoted post thumbnail
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

promoted_post_full_picture

Field label	Post image URL
Field type	dimension
Data type	string.text.url

promoted_post_created_time

Field label	Post created date
Field type	dimension
Data type	string.time.date

promoted_post_permalink_url

Field label	Link to post
Field type	dimension
Data type	string.text.url

promoted_post_permalink_url_ig

Field label	Link to Instagram post
Field type	dimension
Data type	string.text.url

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

REACH ESTIMATES

reach_estimate_users

Field label	Reach estimate: users
Field type	dimension
Data type	int.number.value

reach_estimate_daily_active_users

Field label	Reach estimate: daily active users
Field type	dimension
Data type	int.number.value

reach_estimate_bid_amount_min

Field label	Reach estimate: min bid amount
Field type	dimension
Data type	int.number.value

reach_estimate_bid_amount_median

Field label	Reach estimate: median bid amount
Field type	dimension
Data type	int.number.value

reach_estimate_bid_amount_max

Field label	Reach estimate: max bid amount
Field type	dimension
Data type	int.number.value

reach_estimate_bid_curve_json

Field label	Reach estimate: bid estimate curve JSON
Field type	dimension
Data type	string.text.value

reach_estimate_bid_curve_spend

Field label	Reach estimate: bid estimate curve for spend
Field type	dimension
Data type	string.text.value

reach_estimate_bid_curve_reach

Field label	Reach estimate: bid estimate curve for reach
Field type	dimension
Data type	string.text.value

reach_estimate_bid_curve_impressions

Field label	Reach estimate: bid estimate curve for impressions
Field type	dimension
Data type	string.text.value

reach_estimate_bid_curve_actions

Field label	Reach estimate: bid estimate curve for actions
Field type	dimension
Data type	string.text.value

STANDARD EVENT COST

cost_per_conversion_ad_click_mobile_app

Field label	Cost per Ad click (mobile app)
Description	The average cost for an in-app ad click from your Facebook ads
Field type	metric
Data type	float.currency.value

cost_per_conversion_ad_impression_mobile_app

Field label	Cost per Ad impression (mobile app)
Description	The average cost for 1,000 in-app ad impressions
Field type	metric
Data type	float.currency.value

cost_per_conversion_submit_application_total

Field label	Cost per Submit application
Description	The average cost of each submit application
Field type	metric
Data type	float.currency.value

cost_per_conversion_contact_total

Field label	Cost per Contact
Description	The average cost of each contact
Field type	metric
Data type	float.currency.value

cost_per_conversion_donate_total

Field label	Cost per Donate
Description	The average cost of each donate
Field type	metric
Data type	float.currency.value

cost_per_conversion_find_location_total

Field label	Cost per Find location
Description	The average cost of each find location
Field type	metric
Data type	float.currency.value

cost_per_conversion_customize_product_total

Field label	Cost per Customize product
Description	The average cost of each customize product
Field type	metric
Data type	float.currency.value

cost_per_conversion_schedule_total

Field label	Cost per Schedule
Description	The average cost of each schedule
Field type	metric
Data type	float.currency.value

cost_per_conversion_start_trial_total

Field label	Cost per Start trial
Description	The average cost of each start trial
Field type	metric
Data type	float.currency.value

cost_per_conversion_subscribe_total

Field label	Cost per Subscribe
Description	The average cost of each subscription
Field type	metric
Data type	float.currency.value

STANDARD EVENT VALUE

conversion_values_contact_total

Field label	Contact value (total)
Description	The total value of contact conversions
Field type	metric
Data type	float.currency.value

conversion_values_contact_website

Field label	Contact value (website)
Description	The total value of contact conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_contact_mobile_app

Field label	Contact value (mobile app)
Description	The total value of contact conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_contact_offline

Field label	Contact value (offline)
Description	The total value of contact conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_customize_product_total

Field label	Customize product value (total)
Description	The total value of customize product conversions
Field type	metric
Data type	float.currency.value

conversion_values_customize_product_website

Field label	Customize product value (website)
Description	The total value of customize product conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_customize_product_mobile_app

Field label	Customize product value (mobile app)
Description	The total value of customize product conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_customize_product_offline

Field label	Customize product value (offline)
Description	The total value of customize product conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_donate_total

Field label	Donate value (total)
Description	The total value of donate conversions
Field type	metric
Data type	float.currency.value

conversion_values_donate_website

Field label	Donate value (website)
Description	The total value of donate conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_donate_on_facebook

Field label	Donate value (on facebook)
Description	The total value of on-Facebook donations that occurred within a Facebook-owned property (such as Pages or Messenger)
Field type	metric
Data type	float.currency.value

conversion_values_donate_mobile_app

Field label	Donate value (mobile app)
Description	The total value of donate conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_donate_offline

Field label	Donate value (offline)
Description	The total value of donate conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_find_location_total

Field label	Find location value (total)
Description	The total value of find location conversions
Field type	metric
Data type	float.currency.value

conversion_values_find_location_website

Field label	Find location value (website)
Description	The total value of find location conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_find_location_mobile_app

Field label	Find location value (mobile app)
Description	The total value of find location conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_find_location_offline

Field label	Find location value (offline)
Description	The total value of find location conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_schedule_total

Field label	Schedule value (total)
Description	The total value of schedule conversions
Field type	metric
Data type	float.currency.value

conversion_values_schedule_website

Field label	Schedule value (website)
Description	The total value of schedule conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_schedule_mobile_app

Field label	Schedule value (mobile app)
Description	The total value of schedule conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_schedule_offline

Field label	Schedule value (offline)
Description	The total value of schedule conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_start_trial_total

Field label	Start trial value (total)
Description	The total value of start trial conversions
Field type	metric
Data type	float.currency.value

conversion_values_start_trial_website

Field label	Start trial value (website)
Description	The total value of start trial conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_start_trial_mobile_app

Field label	Start trial value (mobile app)
Description	The total value of start trial conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_start_trial_offline

Field label	Start trial value (offline)
Description	The total value of start trial conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_submit_application_total

Field label	Submit application value (total)
Description	The total value of applications submitted tracked with the conversions objective
Field type	metric
Data type	float.currency.value

conversion_values_submit_application_website

Field label	Submit application value (website)
Description	The total value of submit application conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_submit_application_mobile_app

Field label	Submit application value (mobile app)
Description	The total value of submit application conversions that occurred on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_submit_application_offline

Field label	Submit application value (offline)
Description	The total value of submit application conversions that occurred offline
Field type	metric
Data type	float.currency.value

conversion_values_subscribe_total

Field label	Subscribe value (total)
Description	The total value of subscribe conversions
Field type	metric
Data type	float.currency.value

conversion_values_subscribe_website

Field label	Subscribe value (website)
Description	The total value of subscribe conversions that occurred on your website
Field type	metric
Data type	float.currency.value

conversion_values_subscribe_mobile_app

Field label	Subscribe value (mobile app)
Description	The total value of subscribe conversions on your mobile app
Field type	metric
Data type	float.currency.value

conversion_values_subscribe_offline

Field label	Subscribe value (offline)
Description	The total value of subscribe conversions that occurred offline
Field type	metric
Data type	float.currency.value

STANDARD EVENTS

conversions_ad_click_mobile_app

Field label	Ad click (mobile app)
Description	The number of in-app ad click events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_ad_impression_mobile_app

Field label	Ad impression (mobile app)
Description	The number of in-app ad impression events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_contact_total

Field label	Contact (total)
Description	The number of contact events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_contact_website

Field label	Contact (website)
Description	The number of contact events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_contact_mobile_app

Field label	Contact (mobile app)
Description	The number of contact events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_contact_offline

Field label	Contact (offline)
Description	The number of contact events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_customize_product_total

Field label	Customize product (total)
Description	The number of customize product events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_customize_product_website

Field label	Customize product (website)
Description	The number of customize product events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_customize_product_mobile_app

Field label	Customize product (mobile app)
Description	The number of customize product events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_customize_product_offline

Field label	Customize product (offline)
Description	The number of customize product events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_donate_total

Field label	Donate (total)
Description	The number of donate events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_donate_website

Field label	Donate (website)
Description	The number of donate events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_donate_on_facebook

Field label	Donate (on facebook)
Description	The number of donate events that occurred within a Facebook-owned property (such as Pages or Messenger) and are attributed to your ads
Field type	metric
Data type	int.number.value

conversions_donate_mobile_app

Field label	Donate (mobile app)
Description	The number of donate events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_donate_offline

Field label	Donate (offline)
Description	The number of donate events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_find_location_total

Field label	Find location (total)
Description	The number of find location events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_find_location_website

Field label	Find location (website)
Description	The number of find location events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_find_location_mobile_app

Field label	Find location (mobile app)
Description	The number of find location events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_find_location_offline

Field label	Find location (offline)
Description	The number of find location events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_schedule_total

Field label	Schedule (total)
Description	The number of schedule events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_schedule_website

Field label	Schedule (website)
Description	The number of schedule events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_schedule_mobile_app

Field label	Schedule (mobile app)
Description	The number of schedule events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_schedule_offline

Field label	Schedule (offline)
Description	The number of schedule events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_start_trial_total

Field label	Start trial (total)
Description	The number of start trial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_start_trial_website

Field label	Start trial (website)
Description	The number of start trial events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_start_trial_mobile_app

Field label	Start trial (mobile app)
Description	The number of start trial events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_start_trial_offline

Field label	Start trial (offline)
Description	The number of start trial events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_submit_application_total

Field label	Submit application (total)
Description	The number of submit application events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_submit_application_website

Field label	Submit application (website)
Description	The number of submit application events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_submit_application_mobile_app

Field label	Submit application (mobile app)
Description	The number of submit application events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_submit_application_offline

Field label	Submit application (offline)
Description	The number of submit application events that occurred offline and are attributed to your ads, based on information received from your offline event set
Field type	metric
Data type	int.number.value

conversions_subscribe_total

Field label	Subscribe (total)
Description	The number of subscribe events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
Field type	metric
Data type	int.number.value

conversions_subscribe_website

Field label	Subscribe (website)
Description	The number of subscribe events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
Field type	metric
Data type	int.number.value

conversions_subscribe_mobile_app

Field label	Subscribe (mobile app)
Description	The number of subscribe events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
Field type	metric
Data type	int.number.value

conversions_subscribe_offline

Field label	Subscribe (offline)
Description	The number of subscribe events that occurred offline and are attributed to your ads, based on information received from your offline event set
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

YearOfISOweek

Field label	Year of week (Mon-Sun)
Field type	dimension
Data type	string.time.year

Yearofweek

Field label	Year of week (Sun-Sat)
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

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

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

Quarter

Field label	Quarter
Description	Quarter, e.g. 1
Field type	dimension
Data type	string.time.quarter

Month

Field label	Month
Description	Month, e.g. 6
Field type	dimension
Data type	string.time.month

weekiso

Field label	Week (Mon-Sun)
Description	ISO week number, e.g. 51
Field type	dimension
Data type	string.time.weekiso

week

Field label	Week (Sun-Sat)
Description	US week number, e.g. 51
Field type	dimension
Data type	string.time.week

Dayofweek

Field label	Day of week
Field type	dimension
Data type	string.time.dayofweek

Date

Field label	Date
Description	Date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date

hourly_stats_aggregated_by_advertiser_time_zone

Field label	Hour (advert account time zone)
Field type	dimension
Data type	string.time.hour

hourly_stats_aggregated_by_audience_time_zone

Field label	Hour (viewer's time zone)
Field type	dimension
Data type	string.time.hour

USER

Gender

Field label	Gender
Field type	dimension
Data type	string.person.gender

Age

Field label	Age
Field type	dimension
Data type	string.person.age

Countryname

Field label	Country
Field type	dimension
Data type	string.geo.country

Country

Field label	Country code
Field type	dimension
Data type	string.geo.country.twolettercode

Region

Field label	Region
Field type	dimension
Data type	string.geo.region

dma

Field label	DMA
Description	Designated Market Area
Field type	dimension
Data type	string.geo.region

user_segment_key

Field label	Audience type
Description	The audience type for Advantage+ Shopping Campaigns. Values may be 'prospecting', 'existing', 'unknown' or 'uncategorized'. This breakdown only works with Advantage+ Shopping Campaigns
Field type	dimension
Data type	string.text.value

WEBSITE (FACEBOOK PIXEL)

offsite_conversions

Field label	Website conversions
Field type	metric
Data type	int.number.value

offsite_conversion_rate

Field label	Website conversion rate
Field type	metric
Data type	float.number.ratio

offsite_conversions_fb_pixel_add_payment_info

Field label	Website adds of payment info
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_add_to_wishlist

Field label	Website adds to wishlist
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_complete_registration

Field label	Website registrations completed
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_custom

Field label	Website custom conversions
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_initiate_checkout

Field label	Website checkouts initiated
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_lead

Field label	Website leads
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_purchase

Field label	Website purchases
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_search

Field label	Website searches
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_view_content

Field label	Website content views
Field type	metric
Data type	int.number.value

offsite_conversions_fb_pixel_add_to_cart

Field label	Website adds to cart
Field type	metric
Data type	int.number.value

landing_page_views

Field label	Landing page views
Field type	metric
Data type	int.number.value

WEBSITE (FACEBOOK PIXEL) COST

cost_per_website_conversion

Field label	Cost per website conversion
Field type	metric
Data type	float.currency.value

cost_per_website_add_payment_info

Field label	Cost per website add of payment info
Field type	metric
Data type	float.currency.value

cost_per_website_add_to_cart

Field label	Cost per website add to cart
Field type	metric
Data type	float.currency.value

cost_per_website_add_to_wishlist

Field label	Cost per website add to wishlist
Field type	metric
Data type	float.currency.value

cost_per_website_complete_registration

Field label	Cost per website registration completed
Field type	metric
Data type	float.currency.value

cost_per_website_custom_conversion

Field label	Cost per website custom conversion
Field type	metric
Data type	float.currency.value

cost_per_offsite_conversions_fb_pixel_initiate_checkout

Field label	Cost per website checkout initiated
Description	Cost per website checkout initiated
Field type	metric
Data type	float.currency.value

cost_per_website_lead

Field label	Cost per website lead
Field type	metric
Data type	float.currency.value

cost_per_website_purchase

Field label	Cost per website purchase
Field type	metric
Data type	float.currency.value

cost_per_website_search

Field label	Cost per website search
Field type	metric
Data type	float.currency.value

cost_per_website_view_content

Field label	Cost per website content views
Field type	metric
Data type	float.currency.value

cost_per_landing_page_view

Field label	Cost per landing page view
Field type	metric
Data type	float.currency.value

WEBSITE CONVERSION VALUE (FACEBOOK PIXEL)

offsite_conversion_value

Field label	Website conversion value
Field type	metric
Data type	float.currency.value

website_purchase_roas_perc

Field label	Website purchase ROAS %
Field type	metric
Data type	float.number.percentage
Destinations	API, Data warehouse, Google Sheets

website_purchase_roas

Field label	Website purchase ROAS
Field type	metric
Data type	float.number.ratio

offsite_conversion_value_fb_pixel_add_payment_info

Field label	Website adds of payment info conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_add_to_cart

Field label	Website adds to cart conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_add_to_wishlist

Field label	Website adds to wishlist conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_complete_registration

Field label	Website registrations completed conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_custom

Field label	Website custom conversions value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_initiate_checkout

Field label	Website checkouts initiated conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_lead

Field label	Website leads conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_purchase

Field label	Website purchases conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_search

Field label	Website searches conversion value
Field type	metric
Data type	float.currency.value

offsite_conversion_value_fb_pixel_view_content

Field label	Website content views conversion value
Field type	metric
Data type	float.currency.value