Facebook Ads metrics list

ACCOUNT METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
DIMENSIONaccount_currencySTRINGAccount currency
DIMENSIONaccount_idSTRINGAccount ID
DIMENSIONaccount_nameSTRINGAccount name
DIMENSIONplace_page_idSTRINGPlace page ID
DIMENSIONplace_page_nameSTRINGPlace page name
DIMENSIONattribution_settingSTRINGThe 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.
METRICspend_eurNUMBERAmount spent (EUR)
METRICspend_sekNUMBERAmount spent (SEK)
METRICspend_gbpNUMBERAmount spent (GBP)
METRICspend_usdNUMBERAmount spent (USD)
DIMENSIONbusiness_nameSTRINGBusiness name.
DIMENSIONbusiness_country_codeSTRINGBusiness country.
DIMENSIONbusiness_citySTRINGBusiness city.
DIMENSIONaccount_statusSTRINGAccount status.
DIMENSIONusersSTRINGAccount users.
DIMENSIONlifetime_min_spend_targetNUMBERLifetime minimum spend target for an ad set defined in your account currency. You must specify the lifetime budget at the ad campaign level.
DIMENSIONspend_capNUMBERAccount spend cap.
DIMENSIONlifetime_spend_capNUMBERDaily spend cap of the ad set defined in your account currency. You must specify the daily budget in the campaign.
DIMENSIONbalanceNUMBERAccount balance.
DIMENSIONaccount_edit_linkSTRINGLink to edit the Facebook Ads account.

AD METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
DIMENSIONad_format_assetSTRINGAd format asset
DIMENSIONad_idSTRINGAd ID
DIMENSIONad_nameSTRINGAd name
DIMENSIONad_statusSTRINGAd status
DIMENSIONcall_to_action_asset_nameSTRINGCall to action asset name
DIMENSIONdescription_asset_textSTRINGDescription asset text
METRICestimated_ad_recall_rate_lower_boundNUMBEREstimated ad recall rate lower bound
METRICestimated_ad_recall_rate_upper_boundNUMBEREstimated ad recall rate upper bound
METRICestimated_ad_recallers_lower_boundNUMBEREstimated ad recallers lower bound
METRICestimated_ad_recallers_upper_boundNUMBEREstimated ad recallers upper bound
DIMENSIONimage_assetSTRINGAd image URL
DIMENSIONimage_thumbnailSTRINGAd thumbnail URL
DIMENSIONbody_assetSTRINGAd primary text
DIMENSIONad_image_imgSTRINGAd image
DIMENSIONthumbnail_image_imgSTRINGAd thumbnail image
DIMENSIONlink_url_asset_website_urlSTRINGWebsite URL for a link URL asset
DIMENSIONad_urlSTRINGAd URL
METRICestimated_ad_recallersNUMBEREstimated ad recall lift (people)
METRICcost_per_estimated_ad_recallersNUMBERThe average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives.
DIMENSIONad_group_edit_linkSTRINGLink to edit the ad set in Facebook Ads.
DIMENSIONaction_carousel_card_nameSTRINGCarousel card name
DIMENSIONcarousel_card_descriptionSTRINGDescription of carousel card
DIMENSIONcarousel_card_call_to_action_typeSTRINGCall to action type of carousel card
DIMENSIONcarousel_card_target_urlSTRINGTarget URL of carousel card
DIMENSIONcarousel_card_image_urlSTRINGThe image URL of the carousel card
DIMENSIONcarousel_card_imageSTRINGThe image of the carousel card
DIMENSIONdescription_asset_idSTRINGDescription asset ID
DIMENSIONbody_asset_idSTRINGBody asset ID
DIMENSIONbody_asset_textSTRINGBody asset text
DIMENSIONimage_asset_idSTRINGID for an image asset
DIMENSIONimage_asset_nameSTRINGName for an image asset
DIMENSIONimage_asset_hashSTRINGHash for an image asset
DIMENSIONimage_asset_urlSTRINGURL for an image asset
DIMENSIONtitle_asset_idSTRINGTitle asset ID
DIMENSIONcall_to_action_asset_idSTRINGCall to action asset ID
DIMENSIONad_url_tagsSTRINGURL tags
DIMENSIONad_configured_statusSTRINGAd configured status
DIMENSIONad_creative_idSTRINGAd creative ID
DIMENSIONad_creative_nameSTRINGAd creative name
DIMENSIONad_titleSTRINGAd title
DIMENSIONad_object_typeSTRINGObject type
DIMENSIONad_call_to_action_typeSTRINGType of call to action button in your ad
DIMENSIONad_tagsSTRINGAd tags
DIMENSIONad_bid_infoSTRINGAd bid info
DIMENSIONad_destination_urlSTRINGDestination URL
DIMENSIONad_link_urlSTRINGInternal destination URL
DIMENSIONad_object_urlSTRINGExternal destination URL
DIMENSIONad_template_urlSTRINGTracking template URL
DIMENSIONad_utm_sourceSTRINGValue of the utm_source parameter extracted from the ad destination URL
DIMENSIONad_utm_mediumSTRINGValue of the utm_medium parameter extracted from the ad destination URL
DIMENSIONad_utm_contentSTRINGValue of the utm_content parameter extracted from the ad destination URL
DIMENSIONad_utm_termSTRINGValue of the utm_term parameter extracted from the ad destination URL
DIMENSIONad_desktop_feed_preview_urlSTRINGURL to a preview of the ad, as seen in the desktop feed standard placement
DIMENSIONad_facebook_story_preview_urlSTRINGURL to a preview of the ad, as seen in the Facebook story mobile placement
DIMENSIONad_instant_article_preview_urlSTRINGURL to a preview of the ad, as seen in the instant article standard placement
DIMENSIONad_right_column_preview_urlSTRINGURL to a preview of the ad, as seen in the right column standard placement
DIMENSIONad_mobile_feed_preview_urlSTRINGURL to a preview of the ad, as seen in the mobile feed standard placement
DIMENSIONad_instagram_preview_urlSTRINGURL to a preview of the ad, as seen in the Instagram standard placement
DIMENSIONad_instagram_story_preview_urlSTRINGURL to a preview of the ad, as seen in the Instagram Story placement
DIMENSIONad_mobile_banner_preview_urlSTRINGURL to a preview of the ad, as seen in the mobile banner placement
DIMENSIONad_mobile_interstitial_preview_urlSTRINGURL to a preview of the ad, as seen in the mobile interstitial placement

AD Set METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
DIMENSIONdmaSTRINGDMA (Designated Market Area)
METRICfrequencyNUMBERFrequency
DIMENSIONbidamountNUMBERAdset bid amount.
DIMENSIONbidinfoSTRINGAd set bid info.
DIMENSIONadset_idSTRINGAdset ID
DIMENSIONadset_statusSTRINGAdset status
DIMENSIONadset_nameSTRINGAdset name
DIMENSIONadsetconfigured_statusSTRINGAdset configured status.
DIMENSIONadsetstart_timeSTRINGAdset start date.
DIMENSIONadsetend_timeSTRINGAdset end date.
DIMENSIONadsetstart_time_exactSTRINGAdset start date & time.
DIMENSIONadsetend_time_exactSTRINGAdset end date & time.
DIMENSIONadsetdaily_budgetNUMBERAdset daily budget.
DIMENSIONadsetlifetime_budgetNUMBERAdset lifetime budget.
DIMENSIONadsetbudget_remainingNUMBERAdset budget remaining.
DIMENSIONadsettargeting_age_maxSTRINGMaximum of age range defined by user for ad set targeting. A breakdown of the data in the 'Targeting' dimension.
DIMENSIONadsettargeting_age_minSTRINGMinimum of age range defined by user for ad set targeting. A breakdown of the data in the 'Targeting' dimension.
DIMENSIONadsettargeting_geo_location_countriesSTRINGCountries defined by user for ad set targeting. A breakdown of the data in the 'Targeting' dimension.
DIMENSIONadsettargeting_geo_location_country_groupsSTRINGTargeting country groups.
DIMENSIONadsettargeting_geo_location_typeSTRINGLocation types defined by user for ad set targeting. A breakdown of the data in the 'Targeting' dimension.

Campaign METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICauction_bidNUMBERAuction Bid
METRICauction_competitivenessSTRINGAuction Competitiveness
DIMENSIONbuying_typeSTRINGBuying type
DIMENSIONcampaign_idSTRINGCampaign ID
DIMENSIONcampaign_nameSTRINGCampaign name
DIMENSIONobjectiveSTRINGObjective
METRICspendNUMBERAmount spent
DIMENSIONcampaign_edit_linkSTRINGList of tags assigned to your campaign
DIMENSIONcampaign_configured_statusSTRINGCampaign configured status.
DIMENSIONcampaign_spend_capSTRINGCampaign spending limit.
DIMENSIONcampaign_start_timeSTRINGCampaign start date & time.
DIMENSIONcampaign_end_timeSTRINGCampaign end date & time.
DIMENSIONcampaign_daily_budgetNUMBERCampaign daily budget.
DIMENSIONcampaign_lifetime_budgetNUMBERCampaign lifetime budget.
DIMENSIONcampaign_is_skadnetwork_attributionBOOLEANFlag to indicate that the campaign will be using SKAdNetwork, which also means that it will only be targeting iOS 14.x and above.
DIMENSIONcampaign_budget_remainingNUMBERCampaign budget remaining.
DIMENSIONamount_spentNUMBERAccount amount spent.
DIMENSIONad_utm_campaignSTRINGValue of the utm_campaign parameter extracted from the ad destination URL

Conversion METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICapp_installNUMBERApp installs
METRICcheckinNUMBERCheck-ins
METRICcredit_spentNUMBERCredit spents
METRICgames_playsNUMBERGame plays
METRICmobile_app_installNUMBERMobile app install
METRICoffsite_conversion_fb_pixel_add_payment_infoNUMBERWebsite adds of payment info
METRICoffsite_conversion_fb_pixel_add_to_cartNUMBERWebsite adds to cart
METRICoffsite_conversion_fb_pixel_add_to_wishlistNUMBEROffline add to wishlist
METRICoffsite_conversion_fb_pixel_complete_registrationNUMBEROffline registration complete
METRICoffsite_conversion_fb_pixel_customNUMBEROffline custom conversions
METRICoffsite_conversion_fb_pixel_initiate_checkoutNUMBEROffline checkout initiated
METRICoffsite_conversion_fb_pixel_leadNUMBEROffline website leads
METRICoffsite_conversion_fb_pixel_purchaseNUMBERWebsite purchases
METRICoffsite_conversion_fb_pixel_searchNUMBERWebsite searches
METRICoffsite_conversion_fb_pixel_view_contentNUMBERWebsite content view
METRIConsite_conversion_flow_completeNUMBEROn-Facebook workflow completions
METRIConsite_conversion_messaging_blockNUMBERBlocked messaging connections
METRIConsite_conversion_messaging_conversation_started_7dNUMBERMessaging conversations started within 7 days
METRIConsite_conversion_messaging_first_replyNUMBERNew messaging conversations
METRIConsite_conversion_post_saveNUMBERPost saves
METRICoffsite_conversionNUMBEROffline website conversions
METRIConsite_web_app_eventNUMBERWebsite app event
METRICmobile_app_retentionNUMBERMobile app retention
METRICoffsite_engagementNUMBERWebsite engagement
METRICstore_visit_with_dwellNUMBERStore visit with dwell
METRICadd_to_cartNUMBERAdds to cart
METRIConsite_app_add_to_cartNUMBEROn-Facebook add to cart
METRIConsite_web_add_to_cartNUMBERWeb adds to cart
METRIConsite_web_app_add_to_cartNUMBERWeb app add to cart
METRICcomplete_registrationNUMBERRegistration completed
METRICpurchaseNUMBERPurchases
METRIConsite_app_purchaseNUMBERDesktop purchases
METRIConsite_conversion_lead_groupedNUMBERFacebook leads
METRIConsite_web_purchaseNUMBERWeb purchases
METRIConsite_web_app_purchaseNUMBERWeb app purchase
METRICsearchNUMBERSearches
METRICview_contentNUMBERContent views
METRIConsite_app_view_contentNUMBERDesktop content views
METRIConsite_web_view_contentNUMBERWeb content views
METRIConsite_web_app_view_contentNUMBERWeb app content view
METRICinitiate_checkoutNUMBERCheckout initiated
METRICadd_payment_infoNUMBERAdds of payment info
METRICadd_to_wishlistNUMBERAdd to wishlist
METRIComni_app_installNUMBEROmni app install
METRIComni_purchaseNUMBEROmni purchase
METRIComni_add_to_cartNUMBEROmni adds to cart
METRICwebsite_add_to_cartNUMBEROffline website adds to cart
METRIComni_complete_registrationNUMBEROmni complete registration
METRIComni_view_contentNUMBEROmni content view
METRIComni_searchNUMBEROmni searchs
METRIComni_initiated_checkoutNUMBEROmni checkout initiated
METRIComni_activate_appNUMBEROmni app activate
METRIComni_level_achievedNUMBEROmni level achieved
METRIComni_spend_creditsNUMBEROmni credits spend
METRIComni_tutorial_completionNUMBEROmni tutorial completed
METRICsubscribeNUMBERWebsite subscriptions
METRICsubscribe_totalNUMBERTotal subscriptions
METRICsubscribe_mobile_appNUMBERMobile app subscriptions
METRICsubscribe_offlineNUMBEROffline subscriptions
METRICactions_allNUMBERActions (All)
METRICvalue_credit_spentNUMBERCredit spents conversion value
METRICvalue_offsite_conversion_fb_pixel_add_payment_infoNUMBERWebsite adds of payment info conversion value
METRICvalue_offsite_conversion_fb_pixel_add_to_cartNUMBERWebsite adds of payment info conversion value
METRICvalue_offsite_conversion_fb_pixel_add_to_wishlistNUMBERWebsite adds to wishlist conversion value
METRICvalue_offsite_conversion_fb_pixel_complete_registrationNUMBERWebsite registrations completed conversion value
METRICvalue_offsite_conversion_fb_pixel_customNUMBERWebsite custom conversions value
METRICvalue_offsite_conversion_fb_pixel_initiate_checkoutNUMBERWebsite checkouts initiated conversion value
METRICvalue_offsite_conversion_fb_pixel_leadNUMBERWebsite leads conversion value
METRICvalue_offsite_conversion_fb_pixel_purchaseNUMBERWebsite purchases conversion value
METRICvalue_offsite_conversion_fb_pixel_searchNUMBERWebsite searches conversion value
METRICvalue_offsite_conversion_fb_pixel_view_contentNUMBERValue website content views
METRICvalue_onsite_conversion_flow_completeNUMBEROn-Facebook workflow completion conversion value
METRICvalue_onsite_conversion_purchaseNUMBEROn-Facebook purchase conversion value
METRICvalue_offsite_conversionNUMBERWebsite conversion value
METRICvalue_onsite_web_app_eventNUMBERWeb app event value
METRICvalue_mobile_app_roasNUMBERMobile app ROAS
METRICvalue_add_to_cartNUMBERAdd to cart conversion value
METRICvalue_onsite_app_add_to_cartNUMBEROnsite app add to cart
METRICvalue_onsite_web_add_to_cartNUMBEROnsite web add to cart
METRICvalue_complete_registrationNUMBERRegistration completed conversion value
METRICvalue_searchNUMBERSearches conversion value
METRICvalue_view_contentNUMBERContent view conversion value
METRICvalue_initiate_checkoutNUMBERCheckouts initiated conversion value
METRICvalue_add_payment_infoNUMBERWebsite adds to cart conversion value
METRICvalue_add_to_wishlistNUMBERAdds to wishlist conversion value
METRICvalue_leadNUMBERLead conversion value
METRICvalue_omni_purchaseNUMBERPurchase conversion value
METRICvalue_subscribeNUMBERSubscribe conversion value
METRICpurchase_roas_purchaseNUMBERPurchase ROAS (Return on ad spend)
METRICwebsite_purchase_roasNUMBERWebsite purchase ROAS
METRICmobile_app_purchase_roasNUMBERMobile app purchase ROAS
METRICunique_action_value_checkinNUMBERUnique check-ins
METRICunique_action_offsite_conversion_fb_pixel_add_payment_infoNUMBERUnique website adds of payment info
METRICunique_action_offsite_conversion_fb_pixel_add_to_cartNUMBERUnique website adds to cart
METRICunique_action_offsite_conversion_fb_pixel_add_to_wishlistNUMBERUnique website adds to wishlist
METRICunique_action_offsite_conversion_fb_pixel_complete_registrationNUMBERUnique website registrations completed
METRICunique_action_offsite_conversion_fb_pixel_customNUMBERUnique website custom conversions
METRICunique_action_offsite_conversion_fb_pixel_initiate_checkoutNUMBERUnique website checkouts initiated
METRICunique_action_offsite_conversion_fb_pixel_leadNUMBERUnique website leads
METRICunique_action_offsite_conversion_fb_pixel_purchaseNUMBERUnique website purchases
METRICunique_action_offsite_conversion_fb_pixel_searchNUMBERUnique website searches
METRICunique_action_offsite_conversion_fb_pixel_view_contentNUMBERUnique website content views
METRICunique_action_offsite_conversionNUMBERUnique conversions
METRICunique_action_onsite_conversion_lead_groupedNUMBERFacebook lead ads unique
DIMENSIONconversion_rate_rankingSTRINGConversion rate ranking
METRICconversions_allNUMBERConversions (All with customs)
METRICconversions_without_customsNUMBERConversions (Without customs)
METRICcost_per_action_typeNUMBERCost per any action (CPA)
METRICcost_per_conversionNUMBERCost per conversion
METRICcost_per_inline_link_clickNUMBERCost per inline link click
METRICcost_per_inline_post_engagementNUMBERCost per inline post engagement
METRICcost_per_outbound_clickNUMBERCost per outbound click
METRICcost_per_store_visit_actionNUMBERCost per store visit action
METRICcost_per_thruplayNUMBERCost per ThruPlay
METRICcost_per_unique_conversionNUMBERCost per unique conversion
METRICcost_per_purchaseNUMBERCost per purchase
METRICcost_per_leadNUMBERCPL (Cost per lead)
METRICaction_type_valueNUMBERAction type value
METRICcost_per_installationNUMBERCost per mobile app installation
METRICwebsite_purchase_roas_percNUMBERWebsite purchase ROAS percent
METRICcost_per_3s_video_viewNUMBERCost per three-second video view
METRICcost_per_new_messaging_conversationNUMBERCost per new messaging conversation
METRICcost_per_messaging_conversations_startedNUMBERCost per messaging conversations started
METRICoffsite_conversion_rateNUMBERWebsite conversion rate
METRICconversions_schedule_totalNUMBERThe number of schedule events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
METRICconversions_schedule_websiteNUMBERThe number of schedule events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
METRICconversions_schedule_mobile_appNUMBERThe number of schedule events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
METRICconversions_schedule_offlineNUMBERThe number of schedule events that occurred offline and are attributed to your ads, based on information received from your offline event set.
METRICconversion_values_schedule_totalNUMBERThe total value of schedule conversions.
METRICconversion_values_schedule_websiteNUMBERThe total value of schedule conversions that occurred on your website.
METRICconversion_values_schedule_mobile_appNUMBERThe total value of schedule conversions that occurred on your mobile app.
METRICconversion_values_schedule_offlineNUMBERThe total value of schedule conversions that occurred offline.
METRICcost_per_conversion_schedule_totalNUMBERThe average cost of each schedule.
METRICaction_valueNUMBERTotal action value
METRICconversions_ad_click_mobile_appNUMBERThe 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
METRICconversions_ad_impression_mobile_appNUMBERThe 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
METRICconversions_contact_totalNUMBERThe number of contact events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_contact_websiteNUMBERThe number of contact events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_contact_mobile_appNUMBERThe number of contact events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
METRICconversions_contact_offlineNUMBERThe number of contact events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_customize_product_totalNUMBERThe number of customize product events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_customize_product_websiteNUMBERThe number of customize product events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_customize_product_mobile_appNUMBERThe 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
METRICconversions_customize_product_offlineNUMBERThe number of customize product events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_donate_totalNUMBERThe number of donate events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_donate_websiteNUMBERThe number of donate events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_donate_on_facebookNUMBERThe number of donate events that occurred within a Facebook-owned property (such as Pages or Messenger) and are attributed to your ads
METRICconversions_donate_mobile_appNUMBERThe number of donate events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK
METRICconversions_donate_offlineNUMBERThe number of donate events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_find_location_totalNUMBERThe number of find location events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_find_location_websiteNUMBERThe number of find location events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_find_location_mobile_appNUMBERThe 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
METRICconversions_find_location_offlineNUMBERThe number of find location events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_start_trial_totalNUMBERThe number of start trial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_start_trial_websiteNUMBERThe number of start trial events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_start_trial_mobile_appNUMBERThe 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
METRICconversions_start_trial_offlineNUMBERThe number of start trial events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_submit_application_totalNUMBERThe number of submit application events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools
METRICconversions_submit_application_websiteNUMBERThe number of submit application events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel
METRICconversions_submit_application_mobile_appNUMBERThe 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
METRICconversions_submit_application_offlineNUMBERThe number of submit application events that occurred offline and are attributed to your ads, based on information received from your offline event set
METRICconversions_submit_application_on_facebookNUMBERThe number of submit application events that occurred within a Facebook-owned property (such as Pages or Messenger) and are attributed to your ads
METRICconversion_values_contact_totalNUMBERThe total value of contact conversions
METRICconversion_values_contact_websiteNUMBERThe total value of contact conversions that occurred on your website
METRICconversion_values_contact_mobile_appNUMBERThe total value of contact conversions that occurred on your mobile app
METRICconversion_values_contact_offlineNUMBERThe total value of contact conversions that occurred offline
METRICconversion_values_customize_product_totalNUMBERThe total value of customize product conversions
METRICconversion_values_customize_product_websiteNUMBERThe total value of customize product conversions that occurred on your website
METRICconversion_values_customize_product_mobile_appNUMBERThe total value of customize product conversions that occurred on your mobile app
METRICconversion_values_customize_product_offlineNUMBERThe total value of customize product conversions that occurred offline
METRICconversion_values_donate_totalNUMBERThe total value of donate conversions
METRICconversion_values_donate_websiteNUMBERThe total value of donate conversions that occurred on your website
METRICconversion_values_donate_on_facebookNUMBERThe total value of on-Facebook donations that occurred within a Facebook-owned property (such as Pages or Messenger)
METRICconversion_values_donate_mobile_appNUMBERThe total value of donate conversions that occurred on your mobile app
METRICconversion_values_donate_offlineNUMBERThe total value of donate conversions that occurred offline
METRICconversion_values_find_location_totalNUMBERThe total value of find location conversions
METRICconversion_values_find_location_websiteNUMBERThe total value of find location conversions that occurred on your website
METRICconversion_values_find_location_mobile_appNUMBERThe total value of find location conversions that occurred on your mobile app
METRICconversion_values_find_location_offlineNUMBERThe total value of find location conversions that occurred offline
METRICconversion_values_start_trial_totalNUMBERThe total value of start trial conversions
METRICconversion_values_start_trial_websiteNUMBERThe total value of start trial conversions that occurred on your website
METRICconversion_values_start_trial_mobile_appNUMBERThe total value of start trial conversions that occurred on your mobile app
METRICconversion_values_start_trial_offlineNUMBERThe total value of start trial conversions that occurred offline
METRICconversion_values_submit_application_totalNUMBERThe total value of applications submitted tracked with the conversions objective
METRICconversion_values_submit_application_websiteNUMBERThe total value of submit application conversions that occurred on your website
METRICconversion_values_submit_application_mobile_appNUMBERThe total value of submit application conversions that occurred on your mobile app
METRICconversion_values_submit_application_offlineNUMBERThe total value of submit application conversions that occurred offline
METRICconversion_values_submit_application_on_facebookNUMBERThe total value of on-Facebook submit application that occurred within a Facebook-owned property (such as Pages or Messenger)
METRICconversion_values_subscribe_totalNUMBERThe total value of subscribe conversions
METRICconversion_values_subscribe_websiteNUMBERThe total value of subscribe conversions that occurred on your website
METRICconversion_values_subscribe_mobile_appNUMBERThe total value of subscribe conversions on your mobile app
METRICconversion_values_subscribe_offlineNUMBERThe total value of subscribe conversions that occurred offline
METRICoffline_conversions_leadsNUMBEROffline leads
METRICoffline_conversion_purchaseNUMBEROffline purchases
METRICoffline_other_conversionNUMBEROffline other conversions
METRICoffline_conversion_add_payment_infoNUMBEROffline adds of payment info
METRICoffline_conversion_add_to_cartNUMBEROffline adds to cart
METRICoffline_conversion_add_to_wishlistNUMBEROffline adds to wishlist
METRICoffline_conversion_complete_registrationNUMBEROffline registrations completed
METRICoffline_conversion_initiate_checkoutNUMBEROffline checkouts initiated
METRICoffline_conversion_searchNUMBEROffline searches
METRICoffline_conversion_view_contentNUMBEROffline content views
METRICunique_action_onsite_conversionNUMBERThe estimated number of people with onsite conversions
METRICoffline_conversion_add_to_cart_action_valueNUMBEROffline adds to cart conversion value
METRICoffline_conversion_add_to_wishlist_action_valueNUMBEROffline adds to wishlist conversion value
METRICoffline_conversion_complete_registration_action_valueNUMBEROffline registrations completed conversion value
METRICoffline_conversion_lead_action_valueNUMBEROffline leads conversion value
METRICoffline_conversion_other_action_valueNUMBEROffline other conversion value
METRICoffline_conversion_purchase_action_valueNUMBEROffline purchases conversion value
METRICoffline_conversion_search_action_valueNUMBEROffline searches conversion value
METRICoffline_conversion_view_content_action_valueNUMBEROffline content views conversion value
METRIComni_achievement_unlockedNUMBERMobile app feature unlocks
METRIComni_rateNUMBEROmni rates
METRICcost_per_page_engagementNUMBERCost per page engagement
METRICcost_per_page_likeNUMBERCost per page like
METRICcost_per_post_commentNUMBERCost per post comment
METRICcost_per_post_engagementNUMBERCost per post engagement
METRICcost_per_post_reactionNUMBERCost per post reaction
METRICcost_per_photo_viewNUMBERCost per photo view.
METRICcost_per_rsvpNUMBERCost per event response.
METRICcost_per_offer_claimNUMBERCost per offer claim.
METRICcost_per_checkinNUMBERCost per check-in.
METRICcost_per_onsite_conversion_purchaseNUMBERCost per on-Facebook purchase.
METRICcost_per_onsite_conversion_flow_completeNUMBERCost per workflow completion on Facebook.
METRICcost_per_onsite_conversion_lead_groupedNUMBERCost per on-Facebook lead.
METRICcost_per_post_shareNUMBERCost per post share
METRICcost_per_offsite_conversionNUMBERCost per website conversion
METRICcost_per_offsite_conversion_fb_pixel_add_payment_infoNUMBERCost per website add of payment info
METRICcost_per_offsite_conversion_fb_pixel_add_to_cartNUMBERCost per website add to cart
METRICcost_per_offsite_conversion_fb_pixel_add_to_wishlistNUMBERCost per website add to wishlist
METRICcost_per_offsite_conversion_fb_pixel_complete_registrationNUMBERCost per website registration completed
METRICcost_per_offsite_conversion_fb_pixel_customNUMBERCost per website custom conversion
METRICcost_per_offsite_conversion_fb_pixel_initiate_checkoutNUMBERCost per website checkout initiated
METRICcost_per_offsite_conversion_fb_pixel_leadNUMBERCost per website lead
METRICcost_per_offsite_conversion_fb_pixel_purchaseNUMBERCost per website purchase
METRICcost_per_offsite_conversion_fb_pixel_searchNUMBERCost per website search
METRICcost_per_offsite_conversion_fb_pixel_view_contentNUMBERCost per website content views
METRICcost_per_landing_page_viewNUMBERCost per landing page view
METRICcost_per_conversion_ad_click_mobile_appNUMBERThe average cost for an in-app ad click from your Facebook ads
METRICcost_per_conversion_ad_impression_mobile_appNUMBERThe average cost for 1,000 in-app ad impressions
METRICcost_per_conversion_submit_application_totalNUMBERThe average cost of each submit application
METRICcost_per_conversion_contact_totalNUMBERThe average cost of each contact
METRICcost_per_conversion_donate_totalNUMBERThe average cost of each donate
METRICcost_per_conversion_find_location_totalNUMBERThe average cost of each find location
METRICcost_per_conversion_customize_product_totalNUMBERThe average cost of each customize product
METRICcost_per_conversion_start_trial_totalNUMBERThe average cost of each start trial
METRICcost_per_conversion_subscribe_totalNUMBERThe average cost of each subscription
METRICcost_per_app_installNUMBERCost per app install
METRICcost_per_game_playNUMBERCost per game play
METRICcost_per_desktop_app_engagementNUMBERCost per desktop app engagement
METRICcost_per_desktop_app_installNUMBERCost per desktop app install
METRICcost_per_desktop_app_story_engagementNUMBERCost per desktop app story engagement
METRICcost_per_desktop_app_useNUMBERCost per desktop app use
METRICcost_per_credit_spendNUMBERCost per credit spend action
METRICcost_per_mobile_app_achievement_unlockedNUMBERCost per mobile app achievement unlocked
METRICcost_per_mobile_app_add_to_basketNUMBERCost per mobile app add to basket
METRICcost_per_mobile_app_add_to_wishlistNUMBERCost per mobile app add to wishlist
METRICcost_per_mobile_app_checkout_initiatedNUMBERCost per mobile app checkout initiated
METRICcost_per_mobile_app_content_viewNUMBERCost per mobile app content view
METRICcost_per_mobile_app_credit_spentNUMBERCost per mobile app credit spent
METRICcost_per_mobile_app_installNUMBERCost per mobile app install
METRICcost_per_mobile_app_level_completedNUMBERCost per mobile app level completed
METRICcost_per_mobile_app_payment_info_addNUMBERCost per mobile app payment info add
METRICcost_per_mobile_app_purchaseNUMBERCost per mobile app purchase
METRICcost_per_mobile_app_rating_submittedNUMBERCost per mobile app rating submitted
METRICcost_per_mobile_app_registration_completedNUMBERCost per mobile app registration completed
METRICcost_per_mobile_app_searchNUMBERCost per mobile app search
METRICcost_per_mobile_app_sessionNUMBERCost per mobile app session
METRICcost_per_mobile_app_tutorial_completedNUMBERCost per mobile app tutorial completed
METRICcost_per_other_mobile_app_actionNUMBERCost per other mobile app action
METRICcatalog_segment_omni_add_to_cartNUMBERThe 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
METRICcatalog_segment_offsite_conversion_fb_pixel_add_to_cartNUMBERThe 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
METRICcatalog_segment_omni_view_contentNUMBERThe 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
METRICcatalog_segment_offsite_conversion_fb_pixel_view_contentNUMBERThe 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
METRICcatalog_segment_omni_purchaseNUMBERThe 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
METRICcatalog_segment_offsite_conversion_fb_pixel_purchaseNUMBERThe 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
METRICcatalog_segment_onsite_conversion_purchaseNUMBERThe 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
METRICcatalog_segment_value_omni_add_to_cartNUMBERThe 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
METRICcatalog_segment_value_offsite_conversion_fb_pixel_add_to_cartNUMBERThe 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
METRICcatalog_segment_value_omni_purchaseNUMBERThe 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
METRICcatalog_segment_value_offsite_conversion_fb_pixel_purchaseNUMBERThe 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
METRICcatalog_segment_value_omni_purchase_roasNUMBERThe 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
METRICcatalog_segment_value_website_purchase_roasNUMBERThe total return on ad spend (ROAS) from the shared items contained in website purchases with shared items
METRICcatalog_segment_value_mobile_purchase_roasNUMBERThe total return on ad spend (ROAS) from the shared items contained in mobile app purchases with shared items

Custom Event METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICapp_custom_event_fb_mobile_activate_appNUMBERMobile app sessions
METRICapp_custom_event_fb_mobile_add_payment_infoNUMBERMobile app adds of payment info
METRICapp_custom_event_fb_mobile_add_to_wishlistNUMBERMobile app add to wishlist
METRICapp_custom_event_fb_mobile_complete_registrationNUMBERMobile app registration completed
METRICapp_custom_event_fb_mobile_content_viewNUMBERMobile app content views
METRICapp_custom_event_fb_mobile_initiated_checkoutNUMBERMobile app checkout initiated_
METRICapp_custom_event_fb_mobile_level_achievedNUMBERMobile app levels completed
METRICapp_custom_event_fb_mobile_purchaseNUMBERMobile app purchase
METRICapp_custom_event_fb_mobile_rateNUMBERMobile app rating submitted
METRICapp_custom_event_fb_mobile_searchNUMBERMobile App searches
METRICapp_custom_event_fb_mobile_spent_creditsNUMBERMobile app credits spent
METRICapp_custom_event_fb_mobile_tutorial_completionNUMBERMobile app tutorial completed
METRICapp_custom_event_otherNUMBEROther mobile app actions
METRICapp_custom_eventNUMBERApp custom event
METRIComni_customNUMBEROmni custom
METRICactions_without_customsNUMBERActions (Without customs)
METRICcustom_actions_onlyNUMBERConversions (Customs Only)
METRICvalue_app_custom_event_fb_mobile_add_payment_infoNUMBERMobile app adds of payment info
METRICvalue_app_custom_event_fb_mobile_add_to_cartNUMBERMobile app adds to cart
METRICvalue_app_custom_event_fb_mobile_add_to_wishlistNUMBERMobile app adds to wishlist conversion value
METRICvalue_app_custom_event_fb_mobile_complete_registrationNUMBERMobile app registrations completed conversion value
METRICvalue_app_custom_event_fb_mobile_content_viewNUMBERMobile app content views conversion value
METRICvalue_app_custom_event_fb_mobile_initiated_checkoutNUMBERMobile app checkouts initiated conversion value
METRICvalue_app_custom_event_fb_mobile_level_achievedNUMBERMobile app levels completed conversion value
METRICvalue_app_custom_event_fb_mobile_purchaseNUMBERMobile app purchases conversion value
METRICvalue_app_custom_event_fb_mobile_searchNUMBERMobile app searches conversion value
METRICvalue_app_custom_event_fb_mobile_spent_creditsNUMBERMobile app credits spent conversion value
METRICvalue_app_custom_event_fb_mobile_tutorial_completionNUMBERMobile app tutorials completed conversion value
METRICvalue_actions_without_customsNUMBERActions value without customs
METRICvalue_custom_actions_onlyNUMBERActions value customs only
METRICunique_action_app_custom_event_fb_mobile_activate_appNUMBERMobile app sessions
METRICunique_action_app_custom_event_fb_mobile_add_payment_infoNUMBERUnique mobile app adds of payment info
METRICunique_action_app_custom_event_fb_mobile_add_to_cartNUMBERUnique mobile app adds to cart
METRICunique_action_app_custom_event_fb_mobile_add_to_wishlistNUMBERMobile app adds to wishlist
METRICunique_action_app_custom_event_fb_mobile_complete_registrationNUMBERMobile app registrations completed
METRICunique_action_app_custom_event_fb_mobile_content_viewNUMBERUnique mobile app content views
METRICunique_action_app_custom_event_fb_mobile_initiated_checkoutNUMBERUnique mobile app checkouts initiated
METRICunique_action_app_custom_event_fb_mobile_level_achievedNUMBERUnique mobile app levels completed
METRICunique_action_app_custom_event_fb_mobile_purchaseNUMBERUnique mobile app purchases
METRICunique_action_app_custom_event_fb_mobile_rateNUMBERUnique mobile app ratings submitted
METRICunique_action_app_custom_event_fb_mobile_searchNUMBERUnique mobile app searches
METRICunique_action_app_custom_event_fb_mobile_spent_creditsNUMBERUnique mobile app credits spent
METRICunique_action_app_custom_event_fb_mobile_tutorial_completionNUMBERUnique mobile app tutorials completed
METRICunique_action_app_custom_event_otherNUMBEROther unique mobile app actions
METRICunique_action_app_custom_eventNUMBERUnique mobile app actions
METRICunique_action_omni_customNUMBERUnique action Omni custom
METRICunique_action_actions_without_customsNUMBERUnique standard actions
METRICunique_action_custom_actions_onlyNUMBERUnique custom actions
DIMENSIONaction_type_with_custom_labelsSTRINGThe 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
METRICunique_action_app_custom_event_fb_mobile_achievement_unlockedNUMBERUnique mobile app achievements unlocked
METRICaction_app_custom_event_fb_mobile_achievement_unlockedNUMBERMobile app feature unlocks
METRICcatalog_segment_app_custom_event_fb_mobile_add_to_cartNUMBERThe 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
METRICcatalog_segment_app_custom_event_fb_mobile_content_viewNUMBERThe 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
METRICcatalog_segment_app_custom_event_fb_mobile_purchaseNUMBERThe 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
METRICcatalog_segment_value_app_custom_event_fb_mobile_add_to_cartNUMBERThe 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
METRICcatalog_segment_value_app_custom_event_fb_mobile_purchaseNUMBERThe 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

Lead METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICleadNUMBERLeads
DIMENSIONlead_form_idSTRINGLead form ID
DIMENSIONlead_form_nameSTRINGLead form name
DIMENSIONlead_form_statusSTRINGLead form status
DIMENSIONlead_created_timeSTRINGLead created
DIMENSIONlead_idSTRINGLead ID
DIMENSIONlead_emailSTRINGLead email
DIMENSIONlead_phone_numberSTRINGLead phone number
DIMENSIONlead_full_nameSTRINGLead full name
DIMENSIONlead_company_nameSTRINGLead company name
DIMENSIONlead_countrySTRINGLead country
DIMENSIONlead_stateSTRINGLead state

Other METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
DIMENSIONstatusSTRINGCampaign status.
DIMENSIONageSTRINGAge
DIMENSIONage_targetingSTRINGAge targeting
DIMENSIONcountry_codeSTRINGCountry code
DIMENSIONgenderSTRINGGender
DIMENSIONgender_targetingSTRINGGender targeting
DIMENSIONplatform_positionSTRINGPlatform position
DIMENSIONproduct_idSTRINGProduct ID
DIMENSIONpublisher_platformSTRINGPublisher platform
DIMENSIONregionSTRINGRegion
METRICrule_assetSTRINGRule asset
METRICsocial_spendNUMBERSocial spend
DIMENSIONtitle_asset_textSTRINGTitle asset text
DIMENSIONdevice_platformSTRINGDevice platform
METRICwish_bidNUMBERWish bid
DIMENSIONaction_typeSTRINGAction type
DIMENSIONcountry_nameSTRINGCountry name
DIMENSIONlink_url_asset_idSTRINGLink asset ID

Performance METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICclicksNUMBERClicks
METRICaction_landing_page_viewNUMBERLanding page views
METRICaction_page_engagementNUMBERPage engagement
METRICapp_useNUMBERDesktop app uses
METRICcommentNUMBERPost comments
METRIClikeNUMBERPage likes
METRICoutbound_clickNUMBEROutbound clicks
METRICphoto_viewNUMBERPhoto views
METRICrsvpNUMBEREvent responses
METRICapp_engagementNUMBERDesktop app engagements
METRICapp_storyNUMBERDesktop app story
METRICpage_storyNUMBERDesktop app story engagement
METRICinstagram_profile_engagementNUMBERInstagram profile engagement
METRICcanvas_avg_view_percentNUMBERcanvas avg view percent
METRICcpcNUMBERCPC (All)
METRICcpmNUMBERCPM (Cost per 1000 impressions)
METRICcppNUMBERCPP (Cost per 1000 people reached)
METRICctrNUMBERCTR (All)
DIMENSIONengagement_rate_rankingSTRINGEngagement rate ranking
METRICfull_view_impressionsNUMBERFull view impressions
METRICfull_view_reachNUMBERFull view reach
DIMENSIONimpression_deviceSTRINGImpression device
METRICimpressionsNUMBERImpressions
METRICinline_link_click_ctrNUMBERCTR (Link click-through rate)
METRICinline_link_clicksNUMBERLink clicks
METRICinstant_experience_clicks_to_openNUMBERInstant experience clicks to open
METRICinstant_experience_clicks_to_startNUMBERInstant experience clicks to start
METRICinstant_experience_outbound_clicksNUMBERInstant experience outbound clicks
DIMENSIONquality_rankingSTRINGQuality ranking
METRICreachNUMBERReach
METRICclick_to_call_call_confirmNUMBERThe estimated number of times the call button is clicked on a call confirmation dialogue after an ad with a call destination is clicked.
METRICcpc_linkNUMBERCPC (Cost per link Click)
METRICaction_subscribeNUMBERPage subscribe actions
METRICaction_receive_offerNUMBEROffer claims
METRICoutbound_CTRNUMBEROutbound CTR
METRICmessaging_reply_rateNUMBERMessaging reply rate
METRICquality_score_organicNUMBERAd's perceived quality compared with ads competing for the same audience
METRICquality_score_ectrNUMBERAd's expected engagement rate compared with ads competing for the same audience.
METRICquality_score_ecvrNUMBERAd's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience.
METRICaction_rateNUMBERAction rate %.
DIMENSIONreach_estimate_users_lower_boundNUMBERReach estimate: users lower bound
DIMENSIONreach_estimate_users_upper_boundNUMBERReach estimate: users upper bound
METRICoutbound_click_through_rateNUMBEROutbound click through rate
METRICengagement_rateNUMBEREngagement rate %.

POST METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICaction_post_reactionNUMBERPost reactions
METRICaction_post_engagementNUMBERPost engagement
METRICpostNUMBERPost shares
METRICpost_storyNUMBERDesktop post story engagement
METRICinline_post_engagementNUMBERInline post engagement
DIMENSIONpromoted_post_idSTRINGPost ID
DIMENSIONpromoted_post_id_igSTRINGPost Instagram ID
DIMENSIONpromoted_post_typeSTRINGPost type
DIMENSIONpromoted_post_sourceSTRINGPost source
DIMENSIONpromoted_post_nameSTRINGPost name
DIMENSIONpromoted_post_captionSTRINGPost caption
DIMENSIONpromoted_post_messageSTRINGPost message
DIMENSIONpromoted_post_storySTRINGPost story
DIMENSIONpromoted_post_descriptionSTRINGPost description
DIMENSIONpromoted_post_destination_urlSTRINGPromoted post destination URL
DIMENSIONpromoted_post_permalink_url_igSTRINGLink to Instagram post
DIMENSIONpromoted_post_pictureSTRINGPost thumbnail URL.
DIMENSIONpromoted_post_picture_imageSTRINGPromoted post thumbnail
DIMENSIONpromoted_post_full_pictureSTRINGPost image URL.
DIMENSIONpromoted_post_created_timeSTRINGPost created date
DIMENSIONpromoted_post_permalink_urlSTRINGLink to post

TIME METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
DIMENSIONdateSTRINGDate
DIMENSIONweekSTRINGWeek
DIMENSIONmonthSTRINGMonth of year
DIMENSIONstart_timeSTRINGCampaign starting date set by the advertiser.
DIMENSIONstop_timeSTRINGCampaign ending date set by the advertiser.
METRICcanvas_avg_view_timeNUMBERcanvas avg view time
DIMENSIONcreated_timeSTRINGCreated time
DIMENSIONhourly_stats_aggregated_by_advertiser_time_zoneSTRINGHourly stats aggregated by advertiser time zone
DIMENSIONhourly_stats_aggregated_by_audience_time_zoneSTRINGHourly stats aggregated by audience time zone
DIMENSIONupdated_timeSTRINGUpdated time
DIMENSIONdaySTRINGDay of week
DIMENSIONyearSTRINGYear
DIMENSIONyear_of_weekSTRINGYear of week for US-style Sunday-Saturday weeks
DIMENSIONyear_of_week_isoSTRINGYear of week for ISO standard Monday-Sunday weeks
DIMENSIONyear_monthSTRINGYear and month
DIMENSIONyear_week_isoSTRINGYear and week for ISO weeks
DIMENSIONyear_weekSTRINGYear and week for US weeks
DIMENSIONweek_isoSTRINGISO week number
DIMENSIONtimezone_nameSTRINGAccount timezone.
DIMENSIONtimezone_idNUMBERAccount timezone ID.
DIMENSIONtimezone_offset_hours_utcNUMBERAccount timezone offset from UTC.

Unique Action METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICunique_omni_achievement_unlockedNUMBERUnique Omni achievement unlocked
METRICunique_action_action_post_reactionNUMBERUnique post reaction
METRICunique_action_action_landing_page_viewNUMBERUnique landing page view
METRICunique_action_action_link_clickNUMBERUnique link clicks
METRICunique_action_action_post_engagementNUMBERUnique post engagements
METRICunique_action_action_page_engagementNUMBERUnique page engagements
METRICunique_action_app_installNUMBERUnique desktop app installs
METRICunique_action_app_useNUMBERUnique desktop app uses
METRICunique_action_commentNUMBERUnique post comments
METRICunique_action_credit_spentNUMBERUnique credit spends
METRICunique_action_games_playsNUMBERUnique game plays
METRICunique_action_likeNUMBERUnique page likes
METRICunique_action_mobile_app_installNUMBERUnique mobile app installs
METRICunique_action_outbound_clickNUMBERUnique outbound clicks
METRICunique_action_photo_viewNUMBERUnique photo views
METRICunique_action_postNUMBERUnique post shares
METRICunique_action_rsvpNUMBERUnique event responses
METRICunique_action_app_engagementNUMBERUnique desktop app engagements
METRICunique_action_app_storyNUMBERUnique desktop app story engagements
METRICunique_action_page_storyNUMBERUnique page stories engagements
METRICunique_action_instagram_profile_engagementNUMBERUnique instagram profile engagements
METRICunique_action_post_storyNUMBERUnique post stories engagements
METRICunique_action_onsite_web_app_eventNUMBERUnique web app events
METRICunique_action_mobile_app_retentionNUMBERUnique mobile app retentions
METRICunique_action_mobile_app_roasNUMBERUnique mobile app ROAS
METRICunique_action_offsite_engagementNUMBERUnique website engagements
METRICunique_action_store_visit_with_dwellNUMBERUnique store visits with dwell
METRICunique_action_add_to_cartNUMBERUnique add to cart
METRICunique_action_onsite_app_add_to_cartNUMBERUnique desktop adds to cart
METRICunique_action_onsite_web_add_to_cartNUMBERUnique web adds to cart
METRICunique_action_complete_registrationNUMBERUnique completed registration
METRICunique_action_purchaseNUMBERUnique purchase
METRICunique_action_onsite_app_purchaseNUMBERUnique desktop purchase
METRICunique_action_onsite_web_purchaseNUMBERUnique Web App Purchasese
METRICunique_action_onsite_web_app_purchaseNUMBERUnique web purchases
METRICunique_action_searchNUMBERUnique searches
METRICunique_action_view_contentNUMBERUnique content views
METRICunique_action_onsite_app_view_contentNUMBERUnique desktop content views
METRICunique_action_initiate_checkoutNUMBERUnique initiated checkouts
METRICunique_action_add_payment_infoNUMBERUnique adds off payment info
METRICunique_action_add_to_wishlistNUMBERUnique action adds to wishlist
METRICunique_action_leadNUMBERUnique leads
METRICunique_action_omni_app_installNUMBERUnique Omni app installs
METRICunique_action_omni_purchaseNUMBERUnique Omni purchases
METRICunique_action_omni_add_to_cartNUMBERUnique Omni add to cart
METRICunique_action_omni_complete_registrationNUMBERUnique Omni completed registration
METRICunique_action_omni_view_contentNUMBERUnique Omni content views
METRICunique_action_omni_searchNUMBERUnique Omni searches
METRICunique_action_omni_initiated_checkoutNUMBERUnique Omni checkout initiated
METRICunique_action_omni_activate_appNUMBERUnique Omni app activations
METRICunique_action_omni_level_achievedNUMBERUnique action Omni level achieved
METRICunique_action_omni_rateNUMBERUnique Omni action rate
METRICunique_action_omni_spend_creditsNUMBERUnique Omni credit spends
METRICunique_action_omni_tutorial_completionNUMBERUnique Omni tutorials completed
METRICunique_action_actions_allNUMBERUnique actions (all)
METRICcost_per_unique_clickNUMBERCost per unique click
METRICcost_per_unique_inline_link_clickNUMBERCost per unique link click
METRICcost_per_unique_outbound_clickNUMBERCost per unique outbound click
METRICunique_clicksNUMBERUnique clicks
METRICunique_ctrNUMBERUnique CTR
METRICunique_inline_link_click_ctrNUMBERUnique inline link click CTR
METRICunique_action_receive_offerNUMBERUnique offer claims
METRICunique_outbound_CTRNUMBERUnique outbound CTR
METRICunique_action_rateNUMBERPeople taking action rate %.
METRICunique_action_subscribeNUMBERThe estimated number of people with subscribe events
METRICcost_per_unique_video_viewNUMBERCost per unique video view
METRICunique_action_onsite_web_app_add_to_cartNUMBERThe estimated number of people who added items to their cart on web app
METRICunique_action_onsite_web_app_view_contentNUMBERThe estimated number of people who viewed content on web app
METRICunique_action_onsite_web_view_contentNUMBERThe estimated number of people who viewed content on web
METRICunique_3s_video_viewNUMBERUnique three-second video views
METRICcost_per_unique_page_engagementNUMBERCost per unique_ page engagement
METRICcost_per_unique_page_likeNUMBERCost per unique page like
METRICcost_per_unique_post_commentNUMBERCost per unique post comment
METRICcost_per_unique_post_engagementNUMBERCost per unique post engagement
METRICcost_per_unique_post_reactionNUMBERCost per unique post reaction
METRICcost_per_unique_photo_viewNUMBERCost per unique photo view.
METRICcost_per_unique_rsvpNUMBERCost per unique event response.
METRICcost_per_unique_offer_claimNUMBERCost per unique offer claim.
METRICcost_per_unique_checkinNUMBERCost per unique check-in.
METRICcost_per_unique_post_shareNUMBERCost per unique post share
METRICcost_per_unique_game_playNUMBERCost per unique game play
METRICcost_per_unique_desktop_app_engagementNUMBERCost per unique desktop app engagement
METRICcost_per_unique_desktop_app_installNUMBERCost per unique desktop app install
METRICcost_per_unique_desktop_app_story_engagementNUMBERCost per unique desktop app story engagement
METRICcost_per_unique_desktop_app_useNUMBERCost per unique desktop app use
METRICcost_per_unique_credit_spendNUMBERCost per unique credit spend action
METRICcost_per_unique_mobile_app_achievement_unlockedNUMBERCost per unique mobile app achievement unlocked
METRICcost_per_unique_mobile_app_add_to_basketNUMBERCost per unique mobile app add to basket
METRICcost_per_unique_mobile_app_add_to_wishlistNUMBERCost per unique mobile app add to wishlist
METRICcost_per_unique_mobile_app_checkout_initiatedNUMBERCost per unique mobile app checkout initiated
METRICcost_per_unique_mobile_app_content_viewNUMBERCost per unique mobile app content view
METRICcost_per_unique_mobile_app_credit_spentNUMBERCost per unique mobile app credit spent
METRICcost_per_unique_mobile_app_installNUMBERCost per unique mobile app install
METRICcost_per_unique_mobile_app_level_completedNUMBERCost per unique mobile app level completed
METRICcost_per_unique_mobile_app_payment_info_addNUMBERCost per unique mobile app payment info add
METRICcost_per_unique_mobile_app_purchaseNUMBERCost per unique mobile app purchase
METRICcost_per_unique_mobile_app_rating_submittedNUMBERCost per unique mobile app rating submitted
METRICcost_per_unique_mobile_app_registration_completedNUMBERCost per unique mobile app registration completed
METRICcost_per_unique_mobile_app_searchNUMBERCost per unique mobile app search
METRICcost_per_unique_mobile_app_sessionNUMBERCost per unique mobile app session
METRICcost_per_unique_mobile_app_tutorial_completedNUMBERCost per unique mobile app tutorial completed
METRICcost_per_unique_other_mobile_app_actionNUMBERCost per unique other mobile app action

Video METRICS AND DIMENSIONS

Field TypeNameData TypeDescription
METRICaction_video_viewNUMBERVideo plays
METRICvideo_15_sec_watched_actionsNUMBERThe number of times your video was played to completion, or for at least 15 seconds
METRICvideo_30_sec_watched_actionsNUMBERThe number of times your video was played to completion, or for at least 30 seconds
METRICvideo_p25_watched_actionsNUMBERVideo plays at 25%
METRICvideo_p50_watched_actionsNUMBERVideo Plays at 50%
METRICvideo_p75_watched_actionsNUMBERVideo plays at 75%
METRICvideo_p95_watched_actionsNUMBERVideo plays at 95%
METRICvideo_p100_watched_actionsNUMBERVideo plays at 100%
DIMENSIONvideo_assetSTRINGVideo asset
METRICvideo_thruplay_watched_actionsNUMBERThe number of times your video was played to completion, or for at least 15 seconds
METRICvideo_play_curve_second_0NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 0 seconds.
METRICvideo_play_curve_second_1NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 1 seconds.
METRICvideo_play_curve_second_2NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 2 seconds.
METRICvideo_play_curve_second_3NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 3 seconds.
METRICvideo_play_curve_second_4NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 4 seconds.
METRICvideo_play_curve_second_5NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 5 seconds.
METRICvideo_play_curve_second_6NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 6 seconds.
METRICvideo_play_curve_second_7NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 7 seconds.
METRICvideo_play_curve_second_8NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 8 seconds.
METRICvideo_play_curve_second_9NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 9 seconds.
METRICvideo_play_curve_second_10NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 10 seconds.
METRICvideo_play_curve_second_11NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 11 seconds.
METRICvideo_play_curve_second_12NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 12 seconds.
METRICvideo_play_curve_second_13NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 13 seconds.
METRICvideo_play_curve_second_14NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 14 seconds.
METRICvideo_play_curve_second_15_20NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 15 and 20 seconds.
METRICvideo_play_curve_second_20_25NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 20 and 25 seconds.
METRICvideo_play_curve_second_25_30NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 25 and 30 seconds.
METRICvideo_play_curve_second_30_40NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 30 and 40 seconds.
METRICvideo_play_curve_second_40_50NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 40 and 50 seconds.
METRICvideo_play_curve_second_50_60NUMBERA video-play based curve graph that illustrates the percentage of video plays that reached between 40 and 60 seconds.
METRICvideo_play_curve_second_60_moreNUMBERA video-play based curve graph that illustrates the percentage of video plays that reached 60 and more seconds.
METRICvideo_avg_time_watched_actionsNUMBERThe average time a video was played, including any time spent replaying the video for a single impression.