Facebook Ads fields

  • Updated on Sep 11, 2025
  • Published on Aug 5, 2025
Prev Next

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

537 metrics243 dimensionsCustom 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
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
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
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

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