Supermetrics brings all your marketing data into Google Sheets, Google Data Studio, Excel, BigQuery, Snowflake, Redshift, Azure
Category | Field | Code | Type | Description |
---|---|---|---|---|
TIME | Year | Year | dim | Year, e.g. 2017 |
Year of week (Mon-Sun) | YearOfISOweek | dim | ||
Year of week (Sun-Sat) | Yearofweek | dim | ||
Year & month | Yearmonth | dim | Year and month, e.g. 2017|06 | |
Year & week (Mon-Sun) | YearweekISO | dim | Year and week for ISO weeks, e.g. 2017|08 | |
Year & week (Sun-Sat) | Yearweek | dim | Year and week for US weeks, e.g. 2017|08 | |
Quarter | Quarter | dim | Quarter, e.g. 1 | |
Month | Month | dim | Month, e.g. 6 | |
Week (Mon-Sun) | WeekISO | dim | ISO week number, e.g. 51 | |
Week (Sun-Sat) | Week | dim | US week number, e.g. 51 | |
Day of week | DayOfWeek | dim | ||
Date | Date | dim | Date, e.g. 2017-01-31 | |
Hour (advert account time zone) | hourly_stats_aggregated_by_advertiser_time_zone | dim | ||
Hour (viewer's time zone) | hourly_stats_aggregated_by_audience_time_zone | dim | ||
ACCOUNT STRUCTURE | Account name | account_name | dim | The name of your ad account, which groups your advertising activity |
Account ID | account_id | dim | The ID number of your ad account, which groups your advertising activity | |
Campaign name | campaign_group_name | dim | The name of the advertising campaign that you're viewing in reporting | |
Campaign ID | campaign_group_id | dim | The unique ID number of the advertising campaign that you're viewing in reporting | |
Ad set name | campaign_name | dim | The name of the ad set that you're viewing in reporting | |
Ad set ID | campaign_id | dim | The unique ID of the ad set you're viewing in reports | |
Ad name | adgroup_name | dim | The name of the ad that you're viewing in the report | |
Ad ID | adgroup_id | dim | The unique ID of the ad that you're viewing in reporting | |
ATTRIBUTION | Attribution setting | attribution_setting | dim | 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 |
IMPRESSION | Impression device | impression_device | dim | |
Placement | placement | dim | ||
Place page ID | place_page_id | dim | ||
Publisher platform | publisher_platform | dim | Distinguishes between platforms like Facebook and Instagram | |
Platform position | platform_position | dim | ||
Device platform | device_platform | dim | ||
USER | Gender | gender | dim | |
Age | age | dim | ||
Country | Countryname | dim | ||
Country code | country | dim | ||
Region | region | dim | ||
DMA | dma | dim | Designated Market Area | |
PRODUCT | Product ID | product_id | dim | |
ACTION/CONVERSION | Action type | ActionTypeWithCustomLabels | dim | 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 |
Action type (with custom conv. IDs) | ActionType | dim | 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 | |
Action target ID | ActionTargetID | dim | ||
Action device | ActionDevice | dim | ||
Canvas component name | ActionCanvasComponentName | dim | ||
ACCOUNT DETAILS | Business name | business_name | dim | |
Business country | business_country_code | dim | ||
Business city | business_city | dim | ||
Account status | account_status | dim | ||
Account edit link | account_edit_link | dim | Link to edit the Facebook Ads account | |
Account currency | currency | dim | ||
Account timezone | timezone_name | dim | ||
Account timezone ID | timezone_id | dim | ||
Account timezone offset from UTC | timezone_offset_hours_utc | dim | ||
Account users | users | dim | ||
Account spend cap | spend_cap | dim | ||
Account amount spent | amount_spent | dim | ||
Account balance | balance | dim | ||
Account funding source | funding_source | dim | ||
CAMPAIGN DETAILS | Campaign objective | campaignobjective | dim | The objective you selected for your campaign. Your objective reflects the goal you want to achieve with your advertising |
Campaign status (effective status) | campaignstatus | dim | ||
Campaign tags | campaign_tags | dim | List of tags assigned to your campaign | |
Campaign edit link | campaign_edit_link | dim | Link to edit the campaign in Facebook Ads | |
Campaign configured status | campaignconfigured_status | dim | ||
Campaign buying type | campaignbuyingtype | dim | 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 | |
Campaign spending limit | campaignspend_cap | dim | ||
Campaign start date | campaign_start_date | dim | ||
Campaign end date | campaign_end_date | dim | ||
Campaign start date & time | campaign_start_time | dim | ||
Campaign end date & time | campaign_end_time | dim | ||
Campaign daily budget | campaign_daily_budget | dim | ||
Campaign lifetime budget | campaign_lifetime_budget | dim | ||
Is Campaign using SKAdNetwork | campaign_is_skadnetwork_attribution | dim | Flag to indicate that the campaign will be using SKAdNetwork, which also means that it will only be targeting iOS 14.x and above | |
Campaign budget remaining | campaign_budget_remaining | dim | ||
AD SET DETAILS | Ad set status (effective status) | adsetstatus | dim | |
Ad set tags | adset_tags | dim | List of tags assigned to your ad set | |
Ad set edit link | ad_group_edit_link | dim | Link to edit the ad set in Facebook Ads | |
Ad set configured status | adsetconfigured_status | dim | ||
Bid type | bidtype | dim | ||
Bid amount | bidamount | dim | ||
Ad set bid info | bidinfo | dim | ||
Start date | adsetstart_time | dim | ||
End date | adsetend_time | dim | ||
Start date & time | adsetstart_time_exact | dim | ||
End date & time | adsetend_time_exact | dim | ||
Daily budget | adsetdaily_budget | dim | ||
Lifetime budget | adsetlifetime_budget | dim | ||
Lifetime minimum spend target | lifetime_min_spend_target | dim | Lifetime minimum spend target for an ad set defined in your account currency. You must specify the lifetime budget at the ad campaign level | |
Lifetime spend cap | lifetime_spend_cap | dim | Daily spend cap of the ad set defined in your account currency. You must specify the daily budget in the campaign | |
Budget remaining | adsetbudget_remaining | dim | ||
Targeting | adsettargeting | dim | ||
Targeting maximum age | adsettargeting_age_max | dim | Maximum of age range defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension | |
Targeting minimum age | adsettargeting_age_min | dim | Minimum of age range defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension | |
Targeting country location | adsettargeting_geo_location_countries | dim | Countries defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension | |
Targeting country groups | adsettargeting_geo_location_country_groups | dim | Country groups defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension | |
Targeting location type | adsettargeting_geo_location_type | dim | Location types defined by user for ad set targeting. A breakdown of the data in the "Targeting" dimension | |
Promoted object | adsetpromoted_object | dim | ||
AD DETAILS | Ad status (effective status) | adstatus | dim | |
Ad tags | ad_tags | dim | List of tags assigned to your ad | |
Ad preview URL: desktop feed | desktop_feed_preview_url | dim | URL to a preview of the ad, as seen in the desktop feed standard placement | |
Ad preview URL: Facebook story | facebook_story_preview_url | dim | URL to a preview of the ad, as seen in the Facebook story mobile placement | |
Ad preview URL: instant article | instant_article_preview_url | dim | URL to a preview of the ad, as seen in the instant article standard placement | |
Ad preview URL: right column | right_column_preview_url | dim | URL to a preview of the ad, as seen in the right column standard placement | |
Ad preview URL: mobile feed | mobile_feed_preview_url | dim | URL to a preview of the ad, as seen in the mobile feed standard placement | |
Ad preview URL: Instagram | instagram_preview_url | dim | URL to a preview of the ad, as seen in the Instagram standard placement | |
Ad preview URL: Instagram story | instagram_story_preview_url | dim | URL to a preview of the ad, as seen in the Instagram Story placement | |
Ad preview URL: mobile banner | mobile_banner_preview_url | dim | URL to a preview of the ad, as seen in the mobile banner placement | |
Ad preview URL: mobile interstitial | mobile_interstitial_preview_url | dim | URL to a preview of the ad, as seen in the mobile interstitial placement | |
Ad configured status | adconfigured_status | dim | ||
Ad bid info | adbid_info | dim | ||
Ad creative ID | creative_id | dim | ||
Ad creative name | creative_name | dim | ||
Ad title | creative_title | dim | ||
Ad body | creative_body | dim | ||
Object type | creative_object_type | dim | ||
Call-to-action type | creative_call_to_action_type | dim | ||
Ad creative thumbnail URL | creative_thumbnail_url | dim | ||
Ad creative image URL | creative_image_url | dim | ||
Ad creative image | creative_image | dim | ||
Destination URL | destinationURL | dim | ||
Internal destination URL | creative_link_url | dim | ||
External destination URL | creative_object_url | dim | ||
URL tags | creative_url_tags | dim | ||
Tracking template URL | creative_template_url | dim | ||
Tracking specs | adtracking_specs | dim | ||
Conversion specs | adconversion_specs | dim | ||
Review feedback | adreview_feedback | dim | ||
Source (utm) | utm_source | dim | Value of the utm_source parameter extracted from the ad destination URL | |
Medium (utm) | utm_medium | dim | Value of the utm_medium parameter extracted from the ad destination URL | |
Campaign (utm) | utm_campaign | dim | Value of the utm_campaign parameter extracted from the ad destination URL | |
Content (utm) | utm_content | dim | Value of the utm_content parameter extracted from the ad destination URL | |
Term (utm) | utm_term | dim | Value of the utm_term parameter extracted from the ad destination URL | |
PROMOTED POST | Post ID | promoted_post_id | dim | |
Post Instagram ID | promoted_post_id_ig | dim | ||
Post type | promoted_post_type | dim | ||
Post source | promoted_post_source | dim | ||
Post name | promoted_post_name | dim | ||
Post caption | promoted_post_caption | dim | ||
Post message | promoted_post_message | dim | ||
Post story | promoted_post_story | dim | ||
Post description | promoted_post_description | dim | ||
Promoted post destination URL | promoted_post_destination_url | dim | ||
Existing post destination URL | promoted_destination_url | dim | ||
Post privacy | promoted_post_privacy | dim | ||
Post privacy description | promoted_post_privacy_description | dim | ||
Post icon | promoted_post_icon | dim | ||
Post thumbnail URL | promoted_post_picture | dim | ||
Promoted post thumbnail | promoted_post_picture_image | dim | ||
Post image URL | promoted_post_full_picture | dim | ||
Post created date | promoted_post_created_time | dim | ||
Link to post | promoted_post_permalink_url | dim | ||
Link to Instagram post | promoted_post_permalink_url_ig | dim | ||
LEAD ADS | Lead form ID | lead_form_id | dim | |
Lead form name | lead_form_name | dim | ||
Lead form status | lead_form_status | dim | ||
Lead created | lead_created_time | dim | ||
Lead ID | lead_id | dim | ||
Lead info | lead_info | dim | ||
Lead info (JSON) | lead_info_json | dim | ||
Lead email | lead_email | dim | ||
Lead phone number | lead_phone_number | dim | ||
Lead full name | lead_full_name | dim | ||
Lead company name | lead_company_name | dim | ||
Lead country | lead_country | dim | ||
Lead state | lead_state | dim | ||
Lead field 1 name | lead_name_f1 | dim | ||
Lead field 2 name | lead_name_f2 | dim | ||
Lead field 3 name | lead_name_f3 | dim | ||
Lead field 4 name | lead_name_f4 | dim | ||
Lead field 5 name | lead_name_f5 | dim | ||
Lead field 6 name | lead_name_f6 | dim | ||
Lead field 1 value | lead_value_f1 | dim | ||
Lead field 2 value | lead_value_f2 | dim | ||
Lead field 3 value | lead_value_f3 | dim | ||
Lead field 4 value | lead_value_f4 | dim | ||
Lead field 5 value | lead_value_f5 | dim | ||
Lead field 6 value | lead_value_f6 | dim | ||
CAROUSEL CARD | Carousel card ID | ActionCarouselCardId | dim | |
Carousel card name | ActionCarouselCardName | dim | ||
Carousel card description | carousel_card_description | dim | Description of carousel card | |
Carousel card call to action type | carousel_card_call_to_action_type | dim | Call to action type of carousel card | |
Carousel card target URL | carousel_card_target_url | dim | Target URL of carousel card | |
Carousel card image URL | carousel_card_image_url | dim | The image URL of the carousel card | |
Carousel card image | carousel_card_image | dim | The image of the carousel card | |
REACH ESTIMATES | Reach estimate: users | reach_estimate_users | dim | |
Reach estimate: daily active users | reach_estimate_daily_active_users | dim | ||
Reach estimate: min bid amount | reach_estimate_bid_amount_min | dim | ||
Reach estimate: median bid amount | reach_estimate_bid_amount_median | dim | ||
Reach estimate: max bid amount | reach_estimate_bid_amount_max | dim | ||
Reach estimate: bid estimate curve JSON | reach_estimate_bid_curve_json | dim | ||
Reach estimate: bid estimate curve for spend | reach_estimate_bid_curve_spend | dim | ||
Reach estimate: bid estimate curve for reach | reach_estimate_bid_curve_reach | dim | ||
Reach estimate: bid estimate curve for impressions | reach_estimate_bid_curve_impressions | dim | ||
Reach estimate: bid estimate curve for actions | reach_estimate_bid_curve_actions | dim | ||
PERFORMANCE | Quality ranking (text) | quality_score_organic_text | dim | Ad's perceived quality compared with ads competing for the same audience |
Engagement Rate Ranking (text) | quality_score_ectr_text | dim | Ad's expected engagement rate compared with ads competing for the same audience | |
Conversion Rate Ranking (text) | quality_score_ecvr_text | dim | Ad's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience | |
DYNAMIC CREATIVE ADS | Body asset ID | body_asset_id | dim | Body asset ID |
Body asset text | body_asset_text | dim | Body asset text | |
Description asset ID | description_asset_id | dim | Description asset ID | |
Description asset text | description_asset_text | dim | Description asset text | |
Image asset ID | image_asset_id | dim | ID for an image asset | |
Image asset name | image_asset_name | dim | Name for an image asset | |
Image asset hash | image_asset_hash | dim | Hash for an image asset | |
Image asset URL | image_asset_url | dim | URL for an image asset | |
Title asset ID | title_asset_id | dim | Title asset ID | |
Title asset text | title_asset_text | dim | Title asset text | |
Call to action asset ID | call_to_action_asset_id | dim | Call to action asset asset ID | |
Call to action asset name | call_to_action_asset_name | dim | Call to action asset name | |
Link asset ID | link_url_asset_id | dim | Link asset ID | |
Link asset website URL | link_url_asset_website_url | dim | Website URL for a link URL asset | |
Link URL asset display URL | link_url_asset_display_url | dim | Link URL asset display URL | |
Video asset name | video_asset_video_name | dim | Video asset name | |
Video asset ID | video_asset_id | dim | Video asset ID | |
Video asset video ID | video_asset_video_id | dim | Video asset video ID | |
Video asset URL | video_asset_url | dim | Video asset URL | |
Video asset thumbnail URL | video_asset_thumbnail_url | dim | Video asset thumbnail URL | |
Video asset thumbnail image | video_asset_thumbnail_image | dim | Video asset thumbnail image | |
DEPRECATED | Reach estimate: bid estimate curve for reach | OLD_reach_estimate_bid_curve_reach | dim | Please note that this field will be removed on 2020-01-20 |
Reach estimate: median bid amount | OLD_reach_estimate_bid_amount_median | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: bid estimate curve JSON | OLD_reach_estimate_bid_curve_json | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: min bid amount | OLD_reach_estimate_bid_amount_min | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: max bid amount | OLD_reach_estimate_bid_amount_max | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: bid estimate curve for actions | OLD_reach_estimate_bid_curve_actions | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: users | OLD_reach_estimate_users | dim | Please note that this field will be removed on 2020-01-20 | |
Relevance score negative feedback (deprecated) | relevance_negative_feedback | dim | Please note that this field will be removed on 2020-01-20 | |
Reach estimate: bid estimate curve for impressions | OLD_reach_estimate_bid_curve_impressions | dim | Please note that this field will be removed on 2020-01-20 | |
Relevance score positive feedback (deprecated) | relevance_positive_feedback | dim | Please note that this field will be removed on 2020-01-20 | |
Relevance score status | relevance_status | dim | Relevance score status. Please note that this field will be removed on 2020-03-25 | |
Reach estimate: bid estimate curve for spend | OLD_reach_estimate_bid_curve_spend | dim | Please note that this field will be removed on 2020-01-20 | |
PERFORMANCE | Reach | reach | met | 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 |
Frequency | frequency | met | The average number of times each person saw your ad | |
Impressions | impressions | met | The number of times your ads were on screen | |
Social reach (deprecated) | socialreach | met | 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 | |
Social impressions (deprecated) | socialimpressions | met | 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 | |
Actions | actions | met | ||
People taking action | unique_actions | met | The number of people who took an action that was attributed to your ads | |
Social spend | socialspend | met | ||
Action rate % | actionrate_perc | met | ||
People taking action rate % | uniqueactionrate_perc | met | ||
Total action value | action_value | met | ||
Return on ad spend (ROAS) % | ROAS_perc | met | ||
Return on ad spend (ROAS) | ROAS | met | ||
Quality ranking | quality_score_organic | met | Ad's perceived quality compared with ads competing for the same audience | |
Engagement Rate Ranking | quality_score_ectr | met | Ad's expected engagement rate compared with ads competing for the same audience | |
Conversion Rate Ranking | quality_score_ecvr | met | Ad's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience | |
COST | Amount spent | cost | met | |
Amount spent (EUR) | cost_eur | met | Advertising cost converted to euros | |
Amount spent (GBP) | cost_gbp | met | Advertising cost in your account currency | |
Amount spent (USD) | cost_usd | met | Advertising cost converted to US dollars | |
Amount spent (SEK) | cost_sek | met | Advertising cost converted to Swedish krona | |
Cost per 1000 people reached | CPP | met | ||
CPM | CPM | met | The average cost for 1,000 impressions | |
Cost per any action | CPA | met | ||
CLICKS | Link clicks | link_clicks | met | |
Unique link clicks | unique_action_link_click | met | ||
Outbound clicks | outbound_clicks | met | The number of clicks on links that take people off Facebook-owned properties | |
Unique outbound clicks | unique_outbound_clicks | met | The number of people who performed an outbound click | |
CTR (link click-through rate) | link_CTR_perc | met | ||
Unique CTR (link click-through rate) | unique_link_CTR_perc | met | 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 | |
Outbound CTR | outbound_CTR_perc | met | ||
Unique outbound CTR | unique_outbound_CTR_perc | met | ||
Clicks (all) | clicks | met | ||
Unique clicks (all) | uniqueclicks | met | ||
CTR (all) | CTR_perc | met | ||
Unique CTR (all) | UCTR_perc | met | ||
Social clicks (all) (deprecated) | socialclicks | met | 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 | |
Unique social clicks (all) (deprecated) | uniquesocialclicks | met | 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 | |
CLICKS COST | CPC (link) | CPLC | met | |
Cost per unique link click | UCPLC | met | ||
Cost per outbound click | CPOC | met | ||
Cost per unique outbound click | UCPOC | met | ||
CPC (all) | CPC | met | ||
Cost per unique click (all) | UCPC | met | ||
PAGE POST ENGAGEMENT | Page engagements | page_engagement | met | |
Page likes | like | met | ||
Page subscribes | action_subscribe | met | Page subscribe actions | |
Page mentions (deprecated) | mention | met | ||
Page tab views (deprecated) | tab_view | met | ||
Post comments | comment | met | ||
Post engagements | post_engagement | met | ||
Post reactions | post_like | met | ||
Post saves | post_save | met | ||
Post shares | post | met | ||
Photo views | photo_view | met | ||
Event responses | rsvp | met | ||
Offer claims | receive_offer | met | ||
Check-ins | checkin | met | ||
PAGE POST ENGAGEMENT COST | Cost per page engagement | cost_per_page_engagement | met | |
Cost per page like | cost_per_page_like | met | ||
Cost per page mention (deprecated) | cost_per_page_mention | met | ||
Cost per page tab view (deprecated) | cost_per_page_tab_view | met | ||
Cost per post comment | cost_per_post_comment | met | ||
Cost per post engagement | cost_per_post_engagement | met | ||
Cost per post reaction | cost_per_post_reaction | met | ||
Cost per post share | cost_per_post_share | met | ||
Cost per photo view | cost_per_photo_view | met | ||
Cost per event response | cost_per_event_response | met | ||
Cost per offer claim | cost_per_offer_claim | met | ||
Cost per check-in | cost_per_checkin | met | ||
UNIQUE PAGE POST ENGAGEMENT | Unique page engagements | unique_action_page_engagement | met | |
Unique page likes | unique_action_like | met | ||
Unique page mentions (deprecated) | unique_action_mention | met | ||
Unique page tab views (deprecated) | unique_action_tab_view | met | ||
Unique post comments | unique_action_comment | met | ||
Unique post engagements | unique_action_post_engagement | met | ||
Unique post reactions | unique_action_post_reaction | met | ||
Unique post shares | unique_action_post | met | ||
Unique photo views | unique_action_photo_view | met | ||
Unique event responses | unique_action_rsvp | met | ||
Unique offer claims | unique_action_receive_offer | met | ||
Unique check-ins | unique_action_checkin | met | ||
Unique landing page views | unique_landing_page_view | met | The number of unique people who landed on your ad's landing page after clicking a link in your ad | |
UNIQUE PAGE POST ENGAGEMENT COST | Cost per unique page engagement | cost_per_unique_action_page_engagement | met | |
Cost per unique video view | cost_per_unique_video_view | met | The average cost for each unique video view | |
Cost per unique link click | cost_per_unique_link_click | met | The average cost for each unique click to link | |
Cost per unique page like | cost_per_unique_page_like | met | ||
Cost per unique page mention (deprecated) | cost_per_unique_page_mention | met | ||
Cost per unique page tab view (deprecated) | cost_per_unique_page_tab_view | met | ||
Cost per unique post comment | cost_per_unique_post_comment | met | ||
Cost per unique post engagement | cost_per_unique_post_engagement | met | ||
Cost per unique post reaction | cost_per_unique_post_reaction | met | ||
Cost per unique post share | cost_per_unique_post_share | met | ||
Cost per unique photo view | cost_per_unique_photo_view | met | ||
Cost per unique event response | cost_per_unique_event_response | met | ||
Cost per unique offer claim | cost_per_unique_offer_claim | met | ||
Cost per unique check-in | cost_per_unique_checkin | met | ||
MESSAGING | New messaging conversations | new_messaging_conversations | met | |
New messaging conversations within 7 days | new_messaging_conversations_7d | met | The number of times people started messaging your business after at least seven days of inactivity, attributed to your ads | |
Messaging reply rate | messaging_reply_rate | met | ||
Blocked message conversations | blocked_message_conversations | met | ||
MESSAGING COST | Cost per new messaging conversation | cost_per_new_messaging_conversation | met | |
Cost per messaging reply | cost_per_messaging_reply | met | ||
MEDIA | Three-second video views | video_view | met | |
Unique three-second video views | unique_action_video_view | met | ||
15-second video views (Deprecated) | video_15_sec_watched_actions | met | ||
30-second video views | video_30_sec_watched_actions | met | 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 | |
Video watches at 25% | video_p25_watched_actions | met | The number of times your video was watched at 25% of its length, including watches that skipped to this point | |
Video watches at 50% | video_p50_watched_actions | met | The number of times your video was watched at 50% of its length, including watches that skipped to this point | |
Video watches at 75% | video_p75_watched_actions | met | The number of times your video was watched at 75% of its length, including watches that skipped to this point | |
Video watches at 95% | video_p95_watched_actions | met | The number of times your video was watched at 95% of its length, including watches that skipped to this point | |
Video watches at 100% | video_p100_watched_actions | met | The number of times your video was watched at 100% of its length, including watches that skipped to this point | |
Video average watch time | video_average_watch_time | met | ||
Clicks to play video | video_play | met | ||
Video play actions | video_play_actions | met | The number of times your video starts to play. This is counted for each impression of a video, and excludes replays | |
Video play curve actions second: 0 | video_play_curve_actions_s0 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 0 second | |
Video play curve actions second: 1 | video_play_curve_actions_s1 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 1 second | |
Video play curve actions second: 2 | video_play_curve_actions_s2 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 2 second | |
Video play curve actions second: 3 | video_play_curve_actions_s3 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 3 second | |
Video play curve actions second: 4 | video_play_curve_actions_s4 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 4 second | |
Video play curve actions second: 5 | video_play_curve_actions_s5 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 5 second | |
Video play curve actions second: 6 | video_play_curve_actions_s6 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 6 second | |
Video play curve actions second: 7 | video_play_curve_actions_s7 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 7 second | |
Video play curve actions second: 8 | video_play_curve_actions_s8 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 8 second | |
Video play curve actions second: 9 | video_play_curve_actions_s9 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 9 second | |
Video play curve actions second: 10 | video_play_curve_actions_s10 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 10 second | |
Video play curve actions second: 11 | video_play_curve_actions_s11 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 11 second | |
Video play curve actions second: 12 | video_play_curve_actions_s12 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 12 second | |
Video play curve actions second: 13 | video_play_curve_actions_s13 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 13 second | |
Video play curve actions second: 14 | video_play_curve_actions_s14 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 14 second | |
Video play curve actions second: 15-20 | video_play_curve_actions_s15_s20 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 15-20 second | |
Video play curve actions second: 20-25 | video_play_curve_actions_s20_s25 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 20-25 second | |
Video play curve actions second: 25-30 | video_play_curve_actions_s25_s30 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 25-30 second | |
Video play curve actions second: 30-40 | video_play_curve_actions_s30_s40 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 30-40 second | |
Video play curve actions second: 40-50 | video_play_curve_actions_s40_s50 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 40-50 second | |
Video play curve actions second: 50-60 | video_play_curve_actions_s50_s60 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 50-60 second | |
Video play curve actions second 60 and more | video_play_curve_actions_s60 | met | A video-play based curve graph that illustrates the percentage of video plays that reached 60 seconds and more | |
ThruPlay actions | video_thruplay_watched_actions | met | The number of times your video was played to completion, or for at least 15 seconds | |
Unique clicks to play video | unique_action_video_play | met | ||
Avg. canvas view time | canvas_avg_view_time | met | 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 | |
Avg. canvas view percentage | canvas_avg_view_percent_perc | met | 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 | |
MEDIA COST | Cost per three-second video view | cost_per_3s_video_view | met | |
Cost per ThruPlay | cost_per_thruplay | met | The average cost for each ThruPlay | |
AWARENESS | Estimated ad recall lift (people) | estimated_ad_recallers | met | 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 |
Estimated ad recall lift rate (%) | estimated_ad_recall_rate_perc | met | 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 | |
Estimated ad recall lift (lower bound) | estimated_ad_recallers_lower_bound | met | ||
Estimated ad recall lift (upper bound) | estimated_ad_recallers_upper_bound | met | ||
AWARENESS COST | Cost per estimated ad recall lift (people) | cost_per_estimated_ad_recallers | met | The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand Awareness Objective |
WEBSITE (FACEBOOK PIXEL) | Website conversions | offsite_conversion | met | |
Website conversion rate | offsite_conversion_rate_perc | met | ||
Website adds of payment info | offsite_conversions_fb_pixel_add_payment_info | met | ||
Website adds to wishlist | offsite_conversions_fb_pixel_add_to_wishlist | met | ||
Website registrations completed | offsite_conversions_fb_pixel_complete_registration | met | ||
Website custom conversions | offsite_conversions_fb_pixel_custom | met | ||
Website checkouts initiated | offsite_conversions_fb_pixel_initiate_checkout | met | ||
Website leads | offsite_conversions_fb_pixel_lead | met | ||
Website purchases | offsite_conversions_fb_pixel_purchase | met | ||
Website searches | offsite_conversions_fb_pixel_search | met | ||
Website content views | offsite_conversions_fb_pixel_view_content | met | ||
Website adds to cart | offsite_conversions_fb_pixel_add_to_cart | met | ||
Landing page views | landing_page_views | met | ||
WEBSITE (FACEBOOK PIXEL) COST | Cost per website conversion | cost_per_website_conversion | met | |
Cost per website add of payment info | cost_per_website_add_payment_info | met | ||
Cost per website add to cart | cost_per_website_add_to_cart | met | ||
Cost per website add to wishlist | cost_per_website_add_to_wishlist | met | ||
Cost per website registration completed | cost_per_website_complete_registration | met | ||
Cost per website custom conversion | cost_per_website_custom_conversion | met | ||
Cost per website checkout initiated | cost_per_offsite_conversions_fb_pixel_initiate_checkout | met | Cost per website checkout initiated | |
Cost per website lead | cost_per_website_lead | met | ||
Cost per website purchase | cost_per_website_purchase | met | ||
Cost per website search | cost_per_website_search | met | ||
Cost per website content views | cost_per_website_view_content | met | ||
Cost per landing page view | cost_per_landing_page_view | met | ||
WEBSITE CONVERSION VALUE (FACEBOOK PIXEL) | Website conversion value | offsite_conversion_value | met | |
Website purchase ROAS % | website_purchase_roas_perc | met | ||
Website purchase ROAS | website_purchase_roas | met | ||
Website adds of payment info conversion value | offsite_conversion_value_fb_pixel_add_payment_info | met | ||
Website adds to cart conversion value | offsite_conversion_value_fb_pixel_add_to_cart | met | ||
Website adds to wishlist conversion value | offsite_conversion_value_fb_pixel_add_to_wishlist | met | ||
Website registrations completed conversion value | offsite_conversion_value_fb_pixel_complete_registration | met | ||
Website custom conversions value | offsite_conversion_value_fb_pixel_custom | met | ||
Website checkouts initiated conversion value | offsite_conversion_value_fb_pixel_initiate_checkout | met | ||
Website leads conversion value | offsite_conversion_value_fb_pixel_lead | met | ||
Website purchases conversion value | offsite_conversion_value_fb_pixel_purchase | met | ||
Website searches conversion value | offsite_conversion_value_fb_pixel_search | met | ||
Website content views conversion value | offsite_conversion_value_fb_pixel_view_content | met | ||
STANDARD EVENTS | Ad click (mobile app) | conversions_ad_click_mobile_app | met | 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 |
Ad impression (mobile app) | conversions_ad_impression_mobile_app | met | 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 | |
Contact (total) | conversions_contact_total | met | The number of contact events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Contact (website) | conversions_contact_website | met | The number of contact events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel | |
Contact (mobile app) | conversions_contact_mobile_app | met | 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 | |
Contact (offline) | conversions_contact_offline | met | The number of contact events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Customize product (total) | conversions_customize_product_total | met | The number of customize product events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Customize product (website) | conversions_customize_product_website | met | 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 | |
Customize product (mobile app) | conversions_customize_product_mobile_app | met | 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 | |
Customize product (offline) | conversions_customize_product_offline | met | The number of customize product events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Donate (total) | conversions_donate_total | met | The number of donate events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Donate (website) | conversions_donate_website | met | The number of donate events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel | |
Donate (on facebook) | conversions_donate_on_facebook | met | The number of donate events that occurred within a Facebook-owned property (such as Pages or Messenger) and are attributed to your ads | |
Donate (mobile app) | conversions_donate_mobile_app | met | 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 | |
Donate (offline) | conversions_donate_offline | met | The number of donate events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Find location (total) | conversions_find_location_total | met | The number of find location events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Find location (website) | conversions_find_location_website | met | 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 | |
Find location (mobile app) | conversions_find_location_mobile_app | met | 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 | |
Find location (offline) | conversions_find_location_offline | met | The number of find location events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Schedule (total) | conversions_schedule_total | met | The number of schedule events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Schedule (website) | conversions_schedule_website | met | The number of schedule events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel | |
Schedule (mobile app) | conversions_schedule_mobile_app | met | 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 | |
Schedule (offline) | conversions_schedule_offline | met | The number of schedule events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Start trial (total) | conversions_start_trial_total | met | The number of start trial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Start trial (website) | conversions_start_trial_website | met | 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 | |
Start trial (mobile app) | conversions_start_trial_mobile_app | met | 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 | |
Start trial (offline) | conversions_start_trial_offline | met | The number of start trial events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Submit application (total) | conversions_submit_application_total | met | The number of submit application events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Submit application (website) | conversions_submit_application_website | met | 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 | |
Submit application (mobile app) | conversions_submit_application_mobile_app | met | 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 | |
Submit application (offline) | conversions_submit_application_offline | met | The number of submit application events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
Subscribe (total) | conversions_subscribe_total | met | The number of subscribe events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Subscribe (website) | conversions_subscribe_website | met | The number of subscribe events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel | |
Subscribe (mobile app) | conversions_subscribe_mobile_app | met | 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 | |
Subscribe (offline) | conversions_subscribe_offline | met | The number of subscribe events that occurred offline and are attributed to your ads, based on information received from your offline event set | |
STANDARD EVENT VALUE | Contact value (total) | conversion_values_contact_total | met | The total value of contact conversions |
Contact value (website) | conversion_values_contact_website | met | The total value of contact conversions that occurred on your website | |
Contact value (mobile app) | conversion_values_contact_mobile_app | met | The total value of contact conversions that occurred on your mobile app | |
Contact value (offline) | conversion_values_contact_offline | met | The total value of contact conversions that occurred offline | |
Customize product value (total) | conversion_values_customize_product_total | met | The total value of customize product conversions | |
Customize product value (website) | conversion_values_customize_product_website | met | The total value of customize product conversions that occurred on your website | |
Customize product value (mobile app) | conversion_values_customize_product_mobile_app | met | The total value of customize product conversions that occurred on your mobile app | |
Customize product value (offline) | conversion_values_customize_product_offline | met | The total value of customize product conversions that occurred offline | |
Donate value (total) | conversion_values_donate_total | met | The total value of donate conversions | |
Donate value (website) | conversion_values_donate_website | met | The total value of donate conversions that occurred on your website | |
Donate value (on facebook) | conversion_values_donate_on_facebook | met | The total value of on-Facebook donations that occurred within a Facebook-owned property (such as Pages or Messenger) | |
Donate value (mobile app) | conversion_values_donate_mobile_app | met | The total value of donate conversions that occurred on your mobile app | |
Donate value (offline) | conversion_values_donate_offline | met | The total value of donate conversions that occurred offline | |
Find location value (total) | conversion_values_find_location_total | met | The total value of find location conversions | |
Find location value (website) | conversion_values_find_location_website | met | The total value of find location conversions that occurred on your website | |
Find location value (mobile app) | conversion_values_find_location_mobile_app | met | The total value of find location conversions that occurred on your mobile app | |
Find location value (offline) | conversion_values_find_location_offline | met | The total value of find location conversions that occurred offline | |
Schedule value (total) | conversion_values_schedule_total | met | The total value of schedule conversions | |
Schedule value (website) | conversion_values_schedule_website | met | The total value of schedule conversions that occurred on your website | |
Schedule value (mobile app) | conversion_values_schedule_mobile_app | met | The total value of schedule conversions that occurred on your mobile app | |
Schedule value (offline) | conversion_values_schedule_offline | met | The total value of schedule conversions that occurred offline | |
Start trial value (total) | conversion_values_start_trial_total | met | The total value of start trial conversions | |
Start trial value (website) | conversion_values_start_trial_website | met | The total value of start trial conversions that occurred on your website | |
Start trial value (mobile app) | conversion_values_start_trial_mobile_app | met | The total value of start trial conversions that occurred on your mobile app | |
Start trial value (offline) | conversion_values_start_trial_offline | met | The total value of start trial conversions that occurred offline | |
Submit application value (total) | conversion_values_submit_application_total | met | The total value of applications submitted tracked with the conversions objective | |
Submit application value (website) | conversion_values_submit_application_website | met | The total value of submit application conversions that occurred on your website | |
Submit application value (mobile app) | conversion_values_submit_application_mobile_app | met | The total value of submit application conversions that occurred on your mobile app | |
Submit application value (offline) | conversion_values_submit_application_offline | met | The total value of submit application conversions that occurred offline | |
Subscribe value (total) | conversion_values_subscribe_total | met | The total value of subscribe conversions | |
Subscribe value (website) | conversion_values_subscribe_website | met | The total value of subscribe conversions that occurred on your website | |
Subscribe value (mobile app) | conversion_values_subscribe_mobile_app | met | The total value of subscribe conversions on your mobile app | |
Subscribe value (offline) | conversion_values_subscribe_offline | met | The total value of subscribe conversions that occurred offline | |
STANDARD EVENT COST | Cost per Ad click (mobile app) | cost_per_conversion_ad_click_mobile_app | met | The average cost for an in-app ad click from your Facebook ads |
Cost per Ad impression (mobile app) | cost_per_conversion_ad_impression_mobile_app | met | The average cost for 1,000 in-app ad impressions | |
Cost per Submit application | cost_per_conversion_submit_application_total | met | The average cost of each submit application | |
Cost per Contact | cost_per_conversion_contact_total | met | The average cost of each contact | |
Cost per Donate | cost_per_conversion_donate_total | met | The average cost of each donate | |
Cost per Find location | cost_per_conversion_find_location_total | met | The average cost of each find location | |
Cost per Customize product | cost_per_conversion_customize_product_total | met | The average cost of each customize product | |
Cost per Schedule | cost_per_conversion_schedule_total | met | The average cost of each schedule | |
Cost per Start trial | cost_per_conversion_start_trial_total | met | The average cost of each start trial | |
Cost per Subscribe | cost_per_conversion_subscribe_total | met | The average cost of each subscription | |
MOBILE APP CONVERSION VALUE | Mobile app adds to cart conversion value | app_custom_event_fb_mobile_add_to_cart | met | The conversion value of cart adds made on mobile platforms |
APP ACTIONS | Game plays | games.plays | met | |
Desktop app engagements | app_engagement | met | ||
Desktop app installs | app_install | met | ||
Desktop app story engagements | app_story | met | ||
Desktop app uses | app_use | met | ||
Credit spends | credit_spent | met | ||
Mobile app achievements unlocked | app_custom_event.fb_mobile_achievement_unlocked | met | ||
Mobile app adds of payment info | app_custom_event.fb_mobile_add_payment_info | met | ||
Mobile app adds to cart | app_custom_event.fb_mobile_add_to_cart | met | ||
Mobile app adds to wishlist | app_custom_event.fb_mobile_add_to_wishlist | met | ||
Mobile app registrations completed | app_custom_event.fb_mobile_complete_registration | met | ||
Mobile app checkouts initiated | app_custom_event.fb_mobile_initiated_checkout | met | ||
Mobile app content views | app_custom_event.fb_mobile_content_view | met | ||
Mobile app credits spent | app_custom_event.fb_mobile_spent_credits | met | ||
Mobile app installs | mobile_app_install | met | ||
Mobile app levels completed | app_custom_event.fb_mobile_level_achieved | met | ||
Mobile app purchases | app_custom_event.fb_mobile_purchase | met | ||
Mobile app ratings submitted | app_custom_event.fb_mobile_rate | met | ||
Mobile app searches | app_custom_event.fb_mobile_search | met | ||
Mobile app sessions | app_custom_event.fb_mobile_activate_app | met | ||
Mobile app tutorials completed | app_custom_event.fb_mobile_tutorial_completion | met | ||
Omni app installs | action_omni_app_install | met | The estimated number of completed app installs across all channels | |
Omni purchases | action_omni_purchase | met | The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni adds to cart | action_omni_add_to_cart | met | 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 | |
Omni completed registrations | action_omni_complete_registration | met | The number of complete registration events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni content views | action_omni_view_content | met | The number of view content events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni searches | action_omni_search | met | The number of search events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni initiated checkouts | action_omni_initiated_checkout | met | The number of initiate checkout events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni achievement unlocks | action_omni_achievement_unlocked | met | The number of unlock achievement events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni app activations | action_omni_activate_app | met | 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 | |
Omni level completed | action_omni_level_achieved | met | The estimated number of completed level across all channels | |
Omni rates | action_omni_rate | met | The number of achieve level events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni credit spends | action_omni_spend_credits | met | 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 | |
Omni completed tutorials | action_omni_tutorial_completion | met | The number of completed tutorial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Omni custom actions | action_omni_custom | met | The number of custom events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools | |
Other mobile app actions | app_custom_event.other | met | ||
APP ACTIONS COST | Cost per app install | cost_per_app_install | met | |
Cost per game play | cost_per_game_play | met | ||
Cost per desktop app engagement | cost_per_desktop_app_engagement | met | ||
Cost per desktop app install | cost_per_desktop_app_install | met | ||
Cost per desktop app story engagement | cost_per_desktop_app_story_engagement | met | ||
Cost per desktop app use | cost_per_desktop_app_use | met | ||
Cost per credit spend action | cost_per_credit_spend_action | met | ||
Cost per mobile app achievement unlocked | cost_per_mobile_app_achievement_unlocked | met | ||
Cost per mobile app add to basket | cost_per_mobile_app_add_to_basket | met | ||
Cost per mobile app add to wishlist | cost_per_mobile_app_add_to_wishlist | met | ||
Cost per mobile app checkout initiated | cost_per_mobile_app_checkout_initiated | met | ||
Cost per mobile app content view | cost_per_mobile_app_content_view | met | ||
Cost per mobile app credit spent | cost_per_mobile_app_credit_spent | met | ||
Cost per mobile app install | cost_per_mobile_app_install | met | ||
Cost per mobile app level completed | cost_per_mobile_app_level_completed | met | ||
Cost per mobile app payment info add | cost_per_mobile_app_payment_info_add | met | ||
Cost per mobile app purchase | cost_per_mobile_app_purchase | met | ||
Cost per mobile app rating submitted | cost_per_mobile_app_rating_submitted | met | ||
Cost per mobile app registration completed | cost_per_mobile_app_registration_completed | met | ||
Cost per mobile app search | cost_per_mobile_app_search | met | ||
Cost per mobile app session | cost_per_mobile_app_session | met | ||
Cost per mobile app tutorial completed | cost_per_mobile_app_tutorial_completed | met | ||
Cost per other mobile app action | cost_per_other_mobile_app_action | met | ||
UNIQUE APP ACTIONS | Unique page stories engagements | unique_action_page_story | met | The estimated number of people who engaged with page stories |
Unique post stories engagements | unique_action_post_story | met | The estimated number of people who engaged with post stories | |
Unique instagram profile engagements | unique_action_instagram_profile_engagement | met | The estimated number of people who engaged with instagram profile | |
Unique conversions | unique_action_onsite_conversion | met | The estimated number of people with onsite conversions | |
Unique adds to cart | unique_action_add_to_cart | met | The estimated number of people who added items to their cart | |
Unique store visits with dwell | unique_action_store_visit_with_dwell | met | The estimated number of people visited your stores, attributed to your ads with `Dwell time` | |
Unique completed registrations | unique_action_complete_registration | met | The estimated number of people who registered | |
Unique purchases | unique_action_purchase | met | The estimated number of people who completed at least one purchase | |
Unique searches | unique_action_search | met | The estimated number of people who searched | |
Unique content views | unique_action_view_content | met | The estimated number of people who viewed content | |
Unique initiated checkouts | unique_action_initiate_checkout | met | The estimated number of people who initiated checkouts | |
Unique payment info adds | unique_action_add_payment_info | met | The estimated number of people who submitted payment info | |
Unique adds to wishlist | unique_action_add_to_wishlist | met | The estimated number of people who added items to their wishlist | |
Unique leads | unique_action_lead | met | The estimated number of people with lead events | |
Unique subscribes | unique_action_subscribe | met | The estimated number of people with subscribe events | |
Unique credit spends | unique_action_credit_spent | met | ||
Unique game plays | unique_action_games.plays | met | ||
Unique desktop app engagements | unique_action_app_engagement | met | ||
Unique desktop app installs | unique_action_app_install | met | ||
Unique desktop app story engagements | unique_action_app_story | met | ||
Unique desktop app uses | unique_action_app_use | met | ||
Unique desktop adds to cart | unique_action_onsite_app_add_to_cart | met | The estimated number of people who added items to their cart on desktop app | |
Unique desktop content views | unique_action_onsite_app_view_content | met | The estimated number of people who viewed content on desktop app | |
Unique desktop purchases | unique_action_onsite_app_purchase | met | The estimated number of people who completed at least one purchase on desktop app | |
Unique website conversions | unique_action_offsite_conversion | met | The estimated number of people with offsite conversions | |
Unique website engagements | unique_action_offsite_engagement | met | The estimated number of people with offsite engagements | |
Unique mobile app achievements unlocked | unique_action_app_custom_event.fb_mobile_achievement_unlocked | met | ||
Unique mobile app actions | unique_action_app_custom_event | met | ||
Unique mobile app adds of payment info | unique_action_app_custom_event.fb_mobile_add_payment_info | met | ||
Unique mobile app adds to cart | unique_action_app_custom_event.fb_mobile_add_to_cart | met | ||
Unique mobile app adds to wishlist | unique_action_app_custom_event.fb_mobile_add_to_wishlist | met | ||
Unique mobile app checkouts initiated | unique_action_app_custom_event.fb_mobile_initiated_checkout | met | ||
Unique mobile app content views | unique_action_app_custom_event.fb_mobile_content_view | met | ||
Unique mobile app credits spent | unique_action_app_custom_event.fb_mobile_spent_credits | met | ||
Unique mobile app installs | unique_action_mobile_app_install | met | ||
Unique mobile app levels completed | unique_action_app_custom_event.fb_mobile_level_achieved | met | ||
Unique mobile app purchases | unique_action_app_custom_event.fb_mobile_purchase | met | ||
Unique mobile app ratings submitted | unique_action_app_custom_event.fb_mobile_rate | met | ||
Unique mobile app registrations completed | unique_action_app_custom_event.fb_mobile_complete_registration | met | ||
Unique mobile app searches | unique_action_app_custom_event.fb_mobile_search | met | ||
Unique mobile app sessions | unique_action_app_custom_event.fb_mobile_activate_app | met | ||
Unique mobile app tutorials completed | unique_action_app_custom_event.fb_mobile_tutorial_completion | met | ||
Unique mobile app retentions | unique_action_mobile_app_retention | met | The estimated number of people who performed mobile app retention | |
Unique mobile app ROAS | unique_action_mobile_app_roas | met | The estimated number of people who generated mobile app purchase ROAS | |
Other unique mobile app actions | unique_action_app_custom_event.other | met | ||
Unique web app events | unique_action_onsite_web_app_event | met | The estimated number of people who engaged on web app | |
Unique web app adds to cart | unique_action_onsite_web_app_add_to_cart | met | The estimated number of people who added items to their cart on web app | |
Unique web app content views | unique_action_onsite_web_app_view_content | met | The estimated number of people who viewed content on web app | |
Unique web app purchases | unique_action_onsite_web_app_purchase | met | The estimated number of people who completed at least one purchase on web app | |
Unique web adds to cart | unique_action_onsite_web_add_to_cart | met | The estimated number of people who added items to their cart on web | |
Unique web content views | unique_action_onsite_web_view_content | met | The estimated number of people who viewed content on web | |
Unique web purchases | unique_action_onsite_web_purchase | met | The estimated number of people who completed at least one purchase on web | |
Unique Omni app installs | unique_action_omni_app_install | met | The estimated number of people who completed app installs across all channels | |
Unique Omni purchases | unique_action_omni_purchase | met | The estimated number of people who completed at least one purchase across all channels | |
Unique Omni adds to cart | unique_action_omni_add_to_cart | met | The estimated number of people who added items to their cart across all channels | |
Unique Omni completed registrations | unique_action_omni_complete_registration | met | The estimated number of people who completed registration across all channels | |
Unique Omni content views | unique_action_omni_view_content | met | The estimated number of people who viewed content across all channels | |
Unique Omni searches | unique_action_omni_search | met | The estimated number of people who searched across all channels | |
Unique Omni initiated checkouts | unique_action_omni_initiated_checkout | met | The estimated number of people who initiated checkout across all channels | |
Unique Omni achievement unlocks | unique_action_omni_achievement_unlocked | met | The estimated number of people who unlocked achievement across all channels | |
Unique Omni app activations | unique_action_omni_activate_app | met | The estimated number of people who activated app across all channels | |
Unique Omni level completed | unique_action_omni_level_achieved | met | The estimated number of people who completed level across all channels | |
Unique Omni rates | unique_action_omni_rate | met | The estimated number of people who rated across all channels | |
Unique Omni credit spends | unique_action_omni_spend_credits | met | The estimated number of people who spent credits across all channels | |
Unique Omni completed tutorials | unique_action_omni_tutorial_completion | met | The estimated number of people who completed tutorials across all channels | |
Unique Omni custom actions | unique_action_omni_custom | met | The estimated number of people who performed custom actions across all channels | |
UNIQUE APP ACTIONS COST | Cost per unique game play | cost_per_unique_game_play | met | |
Cost per unique mobile app action | cost_per_unique_mobile_app_action | met | ||
Cost per unique desktop app engagement | cost_per_unique_desktop_app_engagement | met | ||
Cost per unique desktop app install | cost_per_unique_desktop_app_install | met | ||
Cost per unique desktop app story engagement | cost_per_unique_desktop_app_story_engagement | met | ||
Cost per unique desktop app use | cost_per_unique_desktop_app_use | met | ||
Cost per unique credit spend action | cost_per_unique_credit_spend_action | met | ||
Cost per unique mobile app achievement unlocked | cost_per_unique_mobile_app_achievement_unlocked | met | ||
Cost per unique mobile app add to basket | cost_per_unique_mobile_app_add_to_basket | met | ||
Cost per unique mobile app add to wishlist | cost_per_unique_mobile_app_add_to_wishlist | met | ||
Cost per unique mobile app checkout initiated | cost_per_unique_mobile_app_checkout_initiated | met | ||
Cost per unique mobile app content view | cost_per_unique_mobile_app_content_view | met | ||
Cost per unique mobile app credit spent | cost_per_unique_mobile_app_credit_spent | met | ||
Cost per unique mobile app install | cost_per_unique_mobile_app_install | met | ||
Cost per unique mobile app level completed | cost_per_unique_mobile_app_level_completed | met | ||
Cost per unique mobile app payment info add | cost_per_unique_mobile_app_payment_info_add | met | ||
Cost per unique mobile app purchase | cost_per_unique_mobile_app_purchase | met | ||
Cost per unique mobile app rating submitted | cost_per_unique_mobile_app_rating_submitted | met | ||
Cost per unique mobile app registration completed | cost_per_unique_mobile_app_registration_completed | met | ||
Cost per unique mobile app search | cost_per_unique_mobile_app_search | met | ||
Cost per unique mobile app session | cost_per_unique_mobile_app_session | met | ||
Cost per unique mobile app tutorial completed | cost_per_unique_mobile_app_tutorial_completed | met | ||
Cost per other unique mobile app action | cost_per_other_unique_mobile_app_action | met | ||
APP CONVERSION VALUE | Mobile app credits spent conversion value | action_value_app_custom_event.fb_mobile_spent_credits | met | |
Mobile app purchases conversion value | action_value_app_custom_event.fb_mobile_purchase | met | ||
Mobile app checkouts conversion value | action_value_app_custom_event.fb_mobile_initiated_checkout | met | ||
Credits spent conversion value | action_value.credit_spent | met | ||
CONVERSIONS BY CONVERSION WINDOW | Conversions within 1 day of view | actions_1d_view | met | |
Conversions within 7 days of view | actions_7d_view | met | ||
Conversions within 28 days of view | actions_28d_view | met | ||
Conversions within 1 day of click | actions_1d_click | met | ||
Conversions within 7 days of click | actions_7d_click | met | ||
Conversions within 28 days of click | actions_28d_click | met | ||
Unique conversions within 1 day of view | unique_actions_1d_view | met | ||
Unique conversions within 7 days of view | unique_actions_7d_view | met | ||
Unique conversions within 28 days of view | unique_actions_28d_view | met | ||
Unique conversions within 1 day of click | unique_actions_1d_click | met | ||
Unique conversions within 7 days of click | unique_actions_7d_click | met | ||
Unique conversions within 28 days of click | unique_actions_28d_click | met | ||
Conversion value within 1 day of view | action_values_1d_view | met | ||
Conversion value within 7 days of view | action_values_7d_view | met | ||
Conversion value within 28 days of view | action_values_28d_view | met | ||
Conversion value within 1 day of click | action_values_1d_click | met | ||
Conversion value within 7 days of click | action_values_7d_click | met | ||
Conversion value within 28 days of click | action_values_28d_click | met | ||
ON FACEBOOK | On-Facebook purchases | on_facebook_purchases | met | |
On-Facebook workflow completion | on_facebook_workflow_completion | met | ||
On-Facebook leads | onsite_conversion.lead_grouped | met | ||
On-Facebook view content | on_facebook_view_content | met | The number of product views within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads | |
Phone number clicks | on_facebook_click_to_call | met | 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 | |
Get directions clicks | on_facebook_find_location | met | 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 | |
ON FACEBOOK COST | Cost per on-Facebook purchase | cost_per_on_facebook_purchase | met | |
Cost per workflow completion on Facebook | cost_per_on_facebook_workflow_completion | met | ||
Cost per on-Facebook lead | cost_per_on_facebook_lead | met | ||
Cost per on-Facebook view content | cost_per_on_facebook_view_content | met | ||
Cost per on-Facebook phone number click | cost_per_on_facebook_click_to_call | met | ||
Cost per on-Facebook get directions click | cost_per_on_facebook_find_location | met | ||
ON FACEBOOK CONVERSION VALUE | Conversion value of purchase on Facebook | on_facebook_purchase_conversion_value | met | |
Conversion value of workflow completion on Facebook | on_facebook_workflow_completion_conversion_value | met | ||
OTHER | Inline link clicks | inline_link_clicks | met | 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 |
Unique inline link clicks | unique_inline_link_clicks | met | The number of people who performed an inline link click | |
Inline post engagement | inline_post_engagement | met | The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window | |
OFFLINE | Offline leads | offline_conversions_leads | met | |
Offline purchases | offline_conversion_purchase | met | ||
Offline other conversions | offline_other_conversion | met | ||
Offline adds of payment info | offline_conversion_add_payment_info | met | ||
Offline adds to cart | offline_conversion_add_to_cart | met | ||
Offline adds to wishlist | offline_conversion_add_to_wishlist | met | ||
Offline registrations completed | offline_conversion_complete_registration | met | ||
Offline checkouts initiated | offline_conversion_initiate_checkout | met | ||
Offline searches | offline_conversion_search | met | ||
Offline content views | offline_conversion_view_content | met | ||
OFFLINE CONVERSION VALUE | Offline adds of payment info conversion value | offline_conversion_add_payment_info_action_value | met | |
Offline adds to cart conversion value | offline_conversion_add_to_cart_action_value | met | ||
Offline adds to wishlist conversion value | offline_conversion_add_to_wishlist_action_value | met | ||
Offline registrations completed conversion value | offline_conversion_complete_registration_action_value | met | ||
Offline checkouts initiated conversion value | offline_conversion_initiate_checkout_action_value | met | ||
Offline leads conversion value | offline_conversion_lead_action_value | met | ||
Offline other conversion value | offline_conversion_other_action_value | met | ||
Offline purchases conversion value | offline_conversion_purchase_action_value | met | ||
Offline searches conversion value | offline_conversion_search_action_value | met | ||
Offline content views conversion value | offline_conversion_view_content_action_value | met | ||
OMNI CONVERSION VALUE | Purchase conversion value | purchase_conversion_value | met | |
COLLABORATIVE ADS | Omni adds to cart (shared item) | omni_add_to_cart_shared_item | met | 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 |
Mobile app adds to cart (shared item) | catalog_segment_action_app_custom_event_fb_mobile_add_to_cart | met | 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 | |
Website adds to cart (shared item) | catalog_segment_action_offsite_conversion_fb_pixel_add_to_cart | met | 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 | |
Omni content view (shared item) | omni_content_view_shared_item | met | 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 | |
Mobile apps content view (shared item) | catalog_segment_action_app_custom_event_fb_mobile_content_view | met | 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 | |
Website content view (shared item) | catalog_segment_action_offsite_conversion_fb_pixel_view_content | met | 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 | |
Omni purchase (shared item) | omni_purchase_shared_item | met | 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 | |
Mobile apps purchase (shared item) | catalog_segment_action_app_custom_event_fb_mobile_purchase | met | 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 | |
Website purchase (shared item) | catalog_segment_action_offsite_conversion_fb_pixel_purchase | met | 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 | |
On-Facebook purchase (shared item) | catalog_segment_action_onsite_conversion_purchase | met | 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 | |
Omni adds to cart conversion value (shared item) | catalog_segment_value_omni_add_to_card_value | met | 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 | |
Mobile apps adds to cart conversion value (shared item) | catalog_segment_value_app_custom_event_fb_mobile_add_to_cart | met | 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 | |
Website adds to cart conversion value (shared item) | catalog_segment_value_offsite_conversion_fb_pixel_add_to_cart | met | 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 | |
Omni purchase conversion value (shared item) | catalog_segment_value_omni_purchase_value | met | 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 | |
Mobile apps purchase conversion value (shared item) | catalog_segment_value_app_custom_event_fb_mobile_purchase | met | 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 | |
Website purchase conversion value (shared item) | catalog_segment_value_offsite_conversion_fb_pixel_purchase | met | 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 | |
Omni purchase ROAS (shared item) | catalog_segment_value_omni_purchase_roas | met | 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 | |
Website purchase ROAS (shared item) | catalog_segment_value_website_purchase_roas | met | The total return on ad spend (ROAS) from the shared items contained in website purchases with shared items | |
Mobile app purchase ROAS (shared item) | catalog_segment_value_mobile_purchase_roas | met | The total return on ad spend (ROAS) from the shared items contained in mobile app purchases with shared items | |
DEPRECATED | Cost per ten-second video view | cost_per_10s_video_view | met | Please note that this field will be removed on 2019-10-29. Please note that this field will be removed on 2020-01-20 |
Cost per website checkout initiated (conversion tracking pixel) (deprecated) | cost_per_offsite_conversion.checkout | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Messaging replies | messaging_replies | met | Please note that this field will be removed on 2020-01-20 | |
Cost per website key page view (conversion tracking pixel) (deprecated) | cost_per_offsite_conversion.key_page_view | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Cost per other website conversion (deprecated) | cost_per_offsite_conversion.other | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Other website conversions (deprecated) | offsite_conversion.other | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Cost per website add to cart (conversion tracking pixel) (deprecated) | cost_per_offsite_conversion.add_to_cart | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Store visits point estimate | store_visits_point_estimate | met | This field is still being developed by Facebook and as such it might not return any data. Please note that this field will be removed on 2021-05-01 | |
Store visits high estimate | store_visits_high_estimate | met | Please note that this field will be removed on 2020-01-20 | |
Cost per lead (form) | cost_per_lead_form | met | Please note that this field will be removed on 2020-03-25 | |
Cost per store visit | cost_per_store_visit | met | This field is still being developed by Facebook and as such it might not return any data. Please note that this field will be removed on 2021-05-01 | |
Unique leads (form) | unique_action_leadgen.other | met | Please note that this field will be removed on 2020-03-25 | |
Leads (form) | action_leadgen.other | met | Please note that this field will be removed on 2020-03-25 | |
Messaging conversations started | messaging_conversations_started | met | Please note that this field will be removed on 2019-08-08 | |
Store visits low estimate | store_visits_low_estimate | met | Please note that this field will be removed on 2020-01-20 | |
Relevance score | relevance_score_number | met | 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. Please note that this field will be removed on 2020-03-25 | |
Deeplink clicks | deeplink_clicks | met | Please note that this field will be removed on 2020-01-20 | |
Website registrations (conversion tracking pixel) (deprecated) | offsite_conversion.registration | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
App store clicks | app_store_clicks | met | Please note that this field will be removed on 2020-01-20 | |
Website checkouts initiated (conversion tracking pixel) (deprecated) | offsite_conversion.checkout | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Call-to-action clicks (deprecated) | call_to_action_clicks | met | The number of times people clicked the call-to-action button on your ad. Please note that this field will be removed on 2020-01-20 | |
Cost per website lead (conversion tracking pixel) (deprecated) | cost_per_offsite_conversion.lead | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Card views | card_views | met | Please note that this field will be removed on 2020-01-20 | |
Cost per website registration (conversion tracking pixel) (deprecated) | cost_per_offsite_conversion.registration | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Website adds to cart (conversion tracking pixel) (deprecated) | offsite_conversion.add_to_cart | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Cost per mobile app action (deprecated) | cost_per_mobile_app_action | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Mobile app actions (deprecated) | app_custom_event | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Ten-second video views | video_10_sec_watched_actions | met | 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. Please note that this field will be removed on 2019-10-29. Please note that this field will be removed on 2020-01-20 | |
Website key page views (conversion tracking pixel) (deprecated) | offsite_conversion.key_page_view | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 | |
Video average percentage watched | video_average_watched | met | The average percentage of your video that people watched. Please note that this field will be removed on 2020-01-20 | |
Website leads (conversion tracking pixel) (deprecated) | offsite_conversion.lead | met | Please note that this field will be removed on 2019-05-13. Please note that this field will be removed on 2020-01-20 |