API Documentation
This section provides you with an overview of our available metrics and KPIs in Boolee.
Mailchimp Metrics & KPI's
Click rate: clicks.click_rate - The number of unique clicks divided by the total number of successful deliveries.
Hard bounces: bounces.hard_bounces - The total number of hard bounced email addresses.
Number of opens: opens.opens_total - The total number of opens for a campaign.
Number of total clicks: clicks.clicks_total - The total number of clicks for the campaign.
Number of unique clicks: clicks.unique_clicks - The total number of unique clicks for links across a campaign.
Number of unique opens: opens.unique_opens - The total number of unique opens.
Open rate: opens.open_rate - The number of unique opens divided by the total number of successful deliveries.
Unsubscribed: unsubscribed - The total number of unsubscribed members for this campaign.
Google Ads Metrics & KPI's
All conversions from interactions rate: all_conversions_from_interactions_rate - All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level)
All conversions from location asset store visits: all_conversions_from_location_asset_store_visits - Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. (Campaign Level)
All conversions from order: all_conversions_from_order - The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. (Campaign Level)
All conversions from store website: all_conversions_from_store_website - The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.(Campaign Level)
All conversions from location asset order: all_conversions_from_location_asset_order - Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. (Campaign Level)
Average cart size: average_cart_size - Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Average cost: average_cost - The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. (Keyword Level).
Average cost per interaction: average_cost - The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. The average cost metric is reported in the currency of your account. (Campaign Level, Ad Level, Ad Group Level).
Average CPA (cost per Aquisition): average_cpa - The average amount you pay for each conversion. (Campaign Level, Ad Level, Ad Group Level, Keyword Level).
Average page views: average_page_views - Average number of pages viewed per session. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Average time on site: average_time_on_site - Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Content budget lost impression share: content_budget_lost_impression_share - The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. (Campaign Level).
Content impression share: content_impression_share - The impressions you have received on the Display Network divided by the estimated number of impressions you were eligible to receive. (Campaign Level, Ad Level, Keyword Level).
Content rank lost impression share: content_rank_lost_impression_share - The estimated percentage of impressions on the Display Network that your ads did not receive due to poor Ad Rank. (Campaign Level, Ad Level).
Conversion value: conversions_value - The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Cost: cost_micros - The total cost of all interactions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Cost per Lead: cost_per_lead: The amount an advertiser pays to generate a single lead, calculated by dividing the total campaign cost by the number of leads acquired. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Cost per conversion: cost_per_conversion - The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Co-viewed Impressions: co-viewed_impressions - Refers to ad impressions that are seen by users who have also viewed related or similar content, helping identify audience overlap and content affinity. (Campaign Level)
CPC: average_cpc - The total cost per click of all clicks divided by the total number of clicks received. The average CPC metric is reported in the currency of your account. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
CPM: average_cpm - The average cost for 1,000 impressions. The average CPM metric is reported in the currency of your account. (Campaign Level, Ad Level, Ad Group Level).
CTR: ctr - The Click Through Rate shows the percentage of times people saw your ad and performed a click (all). (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Current model attributed conversions: current_model_attributed_conversions - Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Current model attributed conversions from interactions rate: current_model_attributed_conversions_from_interactions_rate - Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). (Campaign Level).
Current model attributed conversions from interactions value per interaction: current_model_attributed_conversions_from_interactions_value_per_interaction - The value of current model attributed conversions from interactions divided by the number of ad interactions. (Campaign Level).
Current model attributed conversions value: current_model_attributed_conversions_value - The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Current model attributed conversions value per cost: current_model_attributed_conversions_value_per_cost - The value of current model attributed conversions divided by the cost of ad interactions. (Campaign Level).
Historical ad relevance: historical_ad_relevance - The last known ad relevance in the reporting time frame. (Keyword Level).
Historical expected CTR: historical_expected_ctr - Expected CTR is one of the three core components of Quality Score and is based on historical data and the relevance of your keyword to users' search queries. (Keyword Level).
Historical landing page experience: (Keyword Level).
Historical quality score: historical_quality_score - The historical quality score. (Keyword Level)
Invalid Clicks: invalid_clicks: Clicks on your ad that Google detects as illegitimate, such as from bots or accidental clicks, and filters out to protect your budget. (Campaign Level)
Invalid Click Rate: invalid_click_rate: The percentage of all ad clicks that were identified as invalid and excluded by Google’s automated systems. (Campaign Level)
Number of ad clicks: clicks - The number of times people clicked your ad. Note: If you're using manual bidding, you may see more clicks than conversions. (Campaign Level, Ad Level, Ad Group Level).
Number of all conversions: all_conversions - The number of all conversions. (Keyword Level).
Number of conversions: conversions - The number of times people took a desired action after seeing your ad. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Number of impressions: impressions - The number of times your ads were on screen. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Number of interactions: interactions - The number of interactions. An interaction is the main user action associated with an ad format—clicks for text and shopping ads, views for video ads, and so on. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Number of order clicks on any location surface after a chargeable ad event (click or impression): all_conversions_from_location_asset_order - Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. (Campaign Level).
Number of times people placed an order at a store after clicking an ad. This metric applies to feed items only: all_conversions_from_order - The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. (Campaign Level).
Number of unique users: unique_users - The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for the following campaign types—Display, Video, Discovery, and App. (Campaign Level).
Number of visits to the store after a chargeable ad event (click or impression): all_conversions_from_location_asset_store_visits - Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location. (Campaign Level).
Number of website URL clicks on any location surface after a chargeable ad event (click or impression): all_conversions_from_location_asset_website - Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. (Campaign Level).
Number of website URL clicks on any location surface after a chargeable ad event (click or impression): all_conversions_from_store_website - The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. (Campaign Level).
Location Orders: location_orders - The number of purchases made after a user views a location-based ad, helping measure the impact of local advertising. (Campaign Level)
Relative CTR: relative_ctr - Your clickthrough rate (CTR) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. (Campaign Level, Ad Level).
Return on ad spend (ROAS): conversions_value,cost_micros - The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). It is expressed as a ratio. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Search absolute top impression share: search_absolute_top_impression_share - The percentage of the customers Shopping or Search ad impressions that are shown in the most prominent Shopping position. (Campaign Level, Ad Level, Keyword Level).
Search budget lost absolute top impression share: search_budget_lost_absolute_top_impression_share - The number estimating how often your ad was not the very first ad above the organic search results due to a low budget. (Campaign Level, Ad Level, Keyword Level).
Search budget lost impression share: search_budget_lost_impression_share - The estimated percent of times that your ad was eligible to show on the Search Network but did not because your budget was too low. (Campaign Level).
Search budget lost top impression share: search_budget_lost_top_impression_share - The number estimating how often your ad did not show anywhere above the organic search results due to a low budget. (Campaign Level, Ad Level, Keyword Level).
Search click share: search_click_share - The number of clicks you have received on the Search Network divided by the estimated number of clicks you were eligible to receive. (Campaign Level, Keyword Level).
Search exact match impression share: search_exact_match_impression_share - The impressions you have received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. (Campaign Level, Ad Level, Keyword Level).
Search impression share: search_impression_share - The impressions you have received on the Search Network divided by the estimated number of impressions you were eligible to receive. (Campaign Level, Ad Level).
Search rank lost absolute top impression share: search_rank_lost_absolute_top_impression_share - The number estimating how often your ad was not the very first ad above the organic search results due to poor Ad Rank. (Campaign Level, Ad Level, Keyword Level).
Search rank lost impression share: search_rank_lost_impression_share - The estimated percentage of impressions on the Search Network that your ads did not receive due to poor Ad Rank. (Campaign Level, Ad Level).
Search rank lost top impression share: search_rank_lost_top_impression_share - The number estimating how often your ad did not show anywhere above the organic search results due to poor Ad Rank. (Campaign Level, Ad Level, Keyword Level).
Store Visits: store_visits - An estimated number of users who visited your physical store after interacting with your online ads. (Campaign Level)
The total value of all conversions: all_conversions_value - The total value of all conversions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Value per current model attributed conversion: value_per_current_model_attributed_conversion - The value of current model attributed conversions divided by the number of the conversions. (Campaign Level, Ad Level, Keyword Level, Ad Group Level).
Video Completion Rate: video_completion_rate: The percentage of video ad views that were watched all the way to the end. (Campaign Level, Ad Level, Ad Group Level).
Video First Quartile Rate: video_first_quartile_rate: The percentage of times your video ad was watched through the first 25% of its duration. (Campaign Level, Ad Level, Ad Group Level).
Video Midpoint Rate: video_midpoint_rate: The percentage of video ad impressions that were watched through 50% of the ad. (Campaign Level, Ad Level, Ad Group Level).
Video Third Quartile Rate: video_third_quartile_rate: The percentage of viewers who watched 75% of your video ad. (Campaign Level, Ad Level, Ad Group Level).
Video View Rate: video_view_rate: The percentage of people who saw your video ad and chose to watch it (views divided by impressions). (Campaign Level, Ad Level, Ad Group Level).
Video Views: video_views: The number of times your video ad was watched, typically counted when a user views for at least 30 seconds or to completion (whichever comes first). (Campaign Level, Ad Level, Ad Group Level).
Linkedin Metrics & KPIs
Action Clicks: action_clicks) - Number of clicks on the call-to-action button in Sponsored Messaging ads. (Campaing Level,
Ad Unit Clicks: ad_unit_clicks - Number of clicks on the ad unit itself. (Campaign Level,
Audience Penetration: audience_penetration - Percentage of your target audience reached by your ads. Calculated as (Members Reached / Audience Size) × 100. (Campaign Level, Campaign Group Level, Account Level)
Average Dwell Time: average_dwell_time - The average time (in seconds) users spend with more than 50% of the ad in view. (Campaign Level, Campaign Group Level, Account Level)
Click Conversions: click_conversions – Total number of times users took a desired action after clicking on your ad. (Account Insights, Campaign Insights, Campaign Group Insights)
Clicks: clicks – The count of chargeable clicks. (Campaign Level, Campaign Group Level, Account Level)
Comment Likes: comment_likes – The count of likes on comments. (Campaign Level)
Comments: comments – The count of comments. Sponsored Content only. (Campaign Level)
Company Page Clicks: company_page_clicks – The count of clicks to view the company page. (Campaign Level)
Conversions: conversions – Total number of times users took a desired action after clicking on or seeing your ad.
Conversion Value: conversion_value – Value of the conversions in the account's local currency based on rules defined by the advertiser. (Campaign Level, Campaign Group Level, Account Level)
Cost per 1,000 Impressions: cost_per_1000_impressions – Average cost per 1,000 impressions. Calculated as (spend / impressions) * 1000. (Campaign Level, Campaign Group Level, Account Level)
Cost per Click: cost_per_click – Average cost per click. Calculated as spend divided by clicks. (Campaign Level, Campaign Group Level, Account Level)
Cost per Conversion: cost_per_conversion – Average cost per conversion. Calculated as spend divided by conversions. (Campaign Level, Campaign Group Level)
Costs per Qualified Lead: costs_per_qualified_lead - Average cost per qualified lead. (Campaign Level, Campaign Group Level, Account Level)
CPM: cpm - Cost per thousand impressions. (Campaign Level, Campaign Group Level, Account Level)
CTR: ctr - Click-through rate: Clicks divided by impressions. (Campaign Level, Campaign Group Level)
Document Completions: document_completions) - Number of times a document was viewed in full. (Campaign Level)
Document First Quartile Completions: document_first_quartile_completions - Number of views reaching 25% of the document. (Campaign Level)
Document Midpoint Completions: document_midpoint_completions - Number of views reaching 50% of the document. (Campaign Level)
Document Third Quartile Completions: document_third_quartile_completions - Number of views reaching 75% of the document. (Campaign Level)
Download Clicks: download_clicks - Number of clicks on the document download link. (Campaign Level)
Engagement Rate: engagement_rate - Engagements divided by impressions. (Campaign Level, Campaign Group Level, Account Level)
Follows: follows - Number of new followers gained. (Campaign Level)
Follower Gains: follower_gains - Net increase in followers over a time period. (Organization Level)
Full Screen Plays: full_screen_plays - Number of times users clicked to view a video ad in full-screen mode. (Campaign Level)
Headline Clicks: headline_clicks - Clicks on the ad’s headline. (Campaign Level)
Headline Impressions: headline_impressions - Number of times the ad’s headline was shown. (Campaign Level)
Impressions: impressions - This is the count of "impressions" for Sponsored Content and "sends" for Sponsored Messaging. (Campaign Level, Campaign Group Level, Account Level)
Job Applications: job_applications - Number of job applications submitted via your job ad. (Campaign Level)
Job Apply Clicks: job_apply_clicks - Clicks on the "Apply" button in job ads. (Campaign Level)
Landing Page Clicks: landing_page_clicks - The count of clicks which take the user to the creative landing page. (Campaign Level)
Lead Form Opens: lead_form_opens - Number of times a lead gen form was opened. (Campaign Level, Campaign Group Level, Account Level)
Lead Generation Mail Contact Info Shares: lead_generation_mail_contact_info_shares - Number of times contact info was shared via Sponsored Messaging. (Campaign Level)
Lead Generation Mail Interested Clicks: lead_generation_mail_interested_clicks - Number of "interested" clicks on lead gen messages. (Campaign Level)
Likes: likes - The count of likes. Sponsored Content only. (Campaign Level)
Member Reach: member_reach – Number of unique members who saw your ad. (Campaign Level, Campaign Group Level, Account Level)
One Click Leads: one_click_leads – Leads submitted with one click using pre-filled information. (Campaign Level, Campaign Group Level, Account Level)
Opens: opens – Total number of opens for messages or content. (Campaign Level)
Organization Button Clicks: organization_button_clicks – Clicks on buttons on your organization page. (Organization Level)
Organization Page Views: organization_page_views – Total views of your LinkedIn organization page. (Organization Level)
Other Engagements: other_engagements – The count of user interactions with the ad unit that do not fit into any other more specific category. (Campaign Level, Campaign Group Level, Account Level)
Post Click Job Applications: post_click_job_applications – Job applications after clicking on an ad. (Campaign Level)
Post Click Job Apply Clicks: post_click_job_apply_clicks – Clicks on the job apply button after clicking an ad. (Campaign Level)
Post Click Registrations: post_click_registrations – Registrations completed after clicking on the ad. (Campaign Level, Campaign Group Level, Account Level)
Post View Job Applications: post_view_job_applications – Job applications after only viewing (not clicking) the ad. (Campaign Level)
Post-View Job Apply Clicks: post_view_job_apply_clicks – Job apply button clicks after viewing an ad. (Campaign Level)
Post-View Registrations: post_view_registrations – Registrations after viewing an ad (without clicking). (Campaign Level, Campaign Group Level, Account Level)
Qualified Leads: qualified_leads – Leads that meet predefined qualification criteria. (Campaign Level, Campaign Group Level, Account Level)
Reactions: reactions – The count of positive reactions on Sponsored Content which can capture like, interest, praise, and other responses. (Campaign Level)
Registrations: registrations – Total number of user sign-ups or registrations. (Campaign Level, Campaign Group Level, Account Level)
Sends: sends – Number of direct sends. (Campaign Level)
Shares: shares – The count of shares. Sponsored Content only. (campaign Level)
Spend: costInLocalCurrency – Cost in the account's local currency. (Campaign Level, Campaign Group Level, Account Level)
Spend (USD): costInUsd – Cost in USD based on the pivot and time Granularity. (Campaign Level, Campaign Group Level, Account Level)
Subscriptions Clicks: subscriptions_clicks – Clicks on subscription-related CTAs. (Campaign Level, Campaign Group Level)
Talent Leads: talent_leads – Leads generated for talent solutions. (Campaign Level, Campaign Group Level, Account Level)
Text URL Clicks: text_url_clicks – Clicks on URLs embedded in the ad text. (Campaign Level)
Total Engagements: total_engagements – Sum of all user engagements with the ad. (Campaign Level, Campaign Group Level)
Unique Organization Page Views: unique_organization_page_views – Unique views of your LinkedIn organization page. (Organization Level)
Valid Work Email Leads: valid_work_email_leads – Leads with verified work email addresses. (Campaign Level, Campaign Group Level)
Video Completion Rate: video_completion_rate – The percentage of video ads that were watched until the end. (Campaign Level)
Viral Card Clicks: viral_card_clicks – The number of clicks on interactive cards in shared posts. (Campaign Level, Campaign Group Level, Account Level)
Viral Card Impressions: viral_card_impressions – The number of impressions of card content in shared posts. (Campaign Level, Campaign Group Level, Account Level)
Viral Clicks: viral_clicks – The total number of clicks on shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Comment Likes: viral_comment_likes – The number of likes on comments in shared posts. (Campaign Level, Campaign Group Level, Account Level)
Viral Comments: viral_comments – The number of comments on shared posts. (Campaign Level, Campaign Group Level, Account Level)
Viral Company Page Clicks: viral_company_page_clicks – The number of clicks from shared posts to the company page. (Campaign Level, Campaign Group Level, Account Level)
Viral Document Completions: viral_document_completions – The number of documents in shared posts that were viewed completely. (Campaign Level, Campaign Group Level, Account Level)
Viral Document First Quartile Completions: viral_document_first_quartile_completions – Number of users who viewed the first quarter of a document in a shared post. (Campaign Level, Campaign Group Level, Account Level)
Viral Document Midpoint Completions: viral_document_midpoint_completions – Number of users who viewed half of a document in a shared post. (Campaign Level, Campaign Group Level, Account Level)
Viral Document Third Quartile Completions: viral_document_third_quartile_completions – Number of users who viewed three quarters of a document in a shared post. (Campaign Level, Campaign Group Level, Account Level)
Viral Download Clicks: viral_download_clicks – Number of clicks on download buttons in shared posts. (Campaign Level, Campaign Group Level, Account Level)
Viral External Website Conversions: viral_external_website_conversions – Number of conversions on external websites via shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral External Website Post-Click Conversions: viral_external_website_post_click_conversions – Conversions that occurred after a click on shared content, on external websites. (Campaign Level, Campaign Group Level, Account Level)
Viral External Website Post-View Conversions: viral_external_website_post_view_conversions – Conversions on external websites that occurred after viewing (not clicking) shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Follows: viral_follows – Number of new followers generated via shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Full Screen Plays: viral_full_screen_plays – Number of times videos in shared content were played in full screen. (Campaign Level, Campaign Group Level, Account Level)
Viral Impressions: viral_impressions – Number of impressions generated by shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Job Applications: viral_job_applications – Number of job applications initiated through shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Job Apply Clicks: viral_job_apply_clicks – Number of clicks on job apply CTAs via shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Landing Page Clicks: viral_landing_page_clicks – Clicks on landing pages from shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Likes: viral_likes – Number of likes on shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral One Click Lead Form Opens: viral_one_click_lead_form_opens – Lead form opens triggered by shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral One Click Leads: viral_one_click_leads – Number of leads generated directly from shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Other Engagements: viral_other_engagements – All other interactions with shared content. (Campaign Level, Campaign Group Level, Account Level)´
Viral Post-Click Job Applications: viral_post_click_job_applications – Job applications that occurred after clicking shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Post-Click Job Apply Clicks: viral_post_click_job_apply_clicks – Clicks on job apply buttons after clicking shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Post-Click Registrations: viral_post_click_registrations – Registrations following clicks on shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Post-View Job Applications: viral_post_view_job_applications – Job applications triggered by viewing (not clicking) shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Post-View Job Apply Clicks: viral_post_view_job_apply_clicks – Clicks on job apply buttons after viewing shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Post-View Registrations: viral_post_view_registrations – Registrations after viewing shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Reactions: viral_reactions – All reactions to shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Registrations: viral_registrations – Total number of registrations via shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Shares: viral_shares – Number of times content was shared. (Campaign Level, Campaign Group Level, Account Level)
Viral Subscription Clicks: viral_subscription_clicks – Clicks on subscription or follow buttons in shared content. (Campaign Level, Campaign Group Level, Account Level)
Viral Total Engagements: total_engagements – Total number of user interactions with the ad. (Campaign Level, Campaign Group Level, Account Level)
Valid Work Email Leads: valid_work_email_leads – Number of leads with a valid work email address. (Account Level)
Viral Video Completions: video_completions – Number of video ads in shared content that were watched 97–100%. (Campaign Level, Campaign Group Level, Account Level)
Viral Video First Quartile Completions: video_first_quartile_completions – Number of shared videos that were watched up to the first quartile. (Campaign Level, Campaign Group Level, Account Level)
Viral Video Midpoint Completions: video_midpoint_completions – Number of shared videos that were watched up to the midpoint. (Campaign Level, Campaign Group Level, Account Level)
Viral Video Starts: video_starts – Number of video ads in shared content that were started. (Campaign Level, Campaign Group Level, Account Level)
Viral Video Third Quartile Completions: video_third_quartile_completions – Number of shared videos that were watched up to the third quartile. (Campaign Level, Campaign Group Level, Account Level)
Video View Rate: video_view_rate – Ratio of video views to impressions. (Campaign Level)
Viral Video Views: video_views – A video ad is considered viewed if it plays at least 2 seconds with 50% visibility or is activated by clicking the CTA. (Campaign Level, Campaign Group Level, Account Level)
View Conversions: view_conversions – Number of desired actions that occurred after viewing an ad. (Campaign Level, Campaign Group Level, Account Level)
Facebook/Instagram Metrics & KPI's
Action values: action_values - The total value of all conversions attributed to your ads.
Actions: actions - The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.
Ad clicks: ad_clicks - The number of clicks on your ads.
Ad frequency: ad_frequency - The average number of times each person saw your ad. This metric is estimated.
Ad impressions: ad_impressions - The number of times your ads were on screen.
Ad reach: ad_reach - The number of unique accounts that have viewed your content at least once (including in ads).
Ad spend: ad_spend - The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.
Clicks: clicks - The number of clicks on your ads.
Cost per 15 second video view: cost_per_15_sec_video_view - The average cost for each 15-second video view.
Cost per action type: cost_per_action_type - The average cost of a relevant action.
Cost Per incline link click: cost_per_inline_link_click - The average cost of each inline link click.
Cost per inline post engagement: cost_per_inline_post_engagement - The average cost of each inline post engagement.
Cost per outbound click: cost_per_outbound_click - The average cost for each outbound click.
Cost per thruplay: cost_per_thruplay - The average cost for each ThruPlay. This metric is in development.
Cost per unique action type: cost_per_unique_action_type - The average cost of each unique action. This metric is estimated.
Cost per unique click: cost_per_unique_click - The average cost for each unique click (all). This metric is estimated.
Cost per unique outbound click: cost_per_unique_outbound_click - The average cost for each unique outbound click. This metric is estimated.
Cost per unique inline link click: cost_per_unique_inline_link_click - The average cost of each unique inline link click. This metric is estimated.
CPC: cpc - The average cost for each click (all).
CPM: cpm - The average cost for 1,000 impressions (all).
CPP: cpp - The average cost to reach 1,000 people. This metric is estimated.
CTR: ctr - The percentage of times people saw your ad and performed a click (all).
Full view impressions: full_view_impressions - The number of Full Views on your Page's posts as a result of your ad.
Full view reach: full_view_reach - The number of people who performed a Full View on your Page's post as a result of your ad.
Impressions: impressions - The number of times your ads were on screen.
Inline link CPC: inline_link_cpc - The average cost of each unique inline link click. This metric is estimated.
reach - The number of unique accounts that have viewed your content at least once (including in ads).
Inline link click CTR: inline_link_click_ctr - The percentage of time people saw your ads and performed an inline link click.
Inline link clicks: inline_link_clicks - 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.
Inline post engagement: inline_post_engagement - The total number of actions that people take involving your ads. Inline post engagements use a fixed 1-day-click attribution window.
Negative page action: page_negative_feedback_by_type - The number of times people took a negative action (e.g., un-liked or hid a post).
New page fans: page_fan_adds_by_paid_non_paid_unique - The number of new people who have liked your Page, broken down by paid and non-paid.
Number of engaged users on page: page_engaged_users - The number of people who engaged with your Page. Engagement includes any click.
Number of post engagements: page_post_engagements - The number of times people have engaged with your posts through reactions, comments, shares, and more.
Outbound clicks: outbound_clicks - The number of clicks on links that take people off Facebook-owned properties.
Outbound clicks CTR: outbound_clicks_ctr - The percentage of times people saw your ad and performed an outbound click.
Page fans: page_fans - The total number of people who have liked your Page.
Page fans by country: page_fans_country - The number of people, aggregated per country, that like your Page. Only the 45 countries with the most people that like your Page are included.
Positive page action: page_positive_feedback_by_type - The number of times people took a positive action, broken down by type.
Post likes of page: page_actions_post_reactions_like_total - Daily total post "like" reactions of a page
Purchase ROAS: purchase_roas - The total return on ad spend (ROAS) from purchases. This is based on information received from one or more of your connected Facebook Business Tools and attributed to your ads.
Social spend: social_spend - The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).
Spend: spend - The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.
Video 30 sec watched actions: video_30_sec_watched_actions - The number of times your video played for at least 30 seconds, or for nearly its total length if it's shorter than 30 seconds. For each impression of a video, the video views are counted separately and exclude any time spent replaying the video.
Video average time watched actions: video_avg_time_watched_actions - The average time a video was played, including any time spent replaying the video for a single impression.
Video 100% watched actions: video_p100_watched_actions - The number of times your video was played at 100% of its length, including plays that skipped to this point.
Video 25% watched actions: video_p25_watched_actions - The number of times your video was played at 25% of its length, including plays that skipped to this point.
Video 30% watched actions:
Video 50% watched actions: video_p50_watched_actions - The number of times your video was played at 50% of its length, including plays that skipped to this point.
Video 75% watched actions: video_p75_watched_actions - The number of times your video was played at 75% of its length, including plays that skipped to this point.
Video 95% watched actions: video_p95_watched_actions - The number of times your video was played at 95% of its length, including plays that skipped to this point.
Video average time watched actions:
Video play actions: video_play_actions - The number of times your video starts to play. This is counted for each impression of a video, and excludes replays. This metric is in development.
Website CTR: website_ctr - The percentage of times people saw your ad and performed a link click.
Website purchase ROAS: website_purchase_roas - The total return on ad spend (ROAS) from website purchases. This is based on the value of all conversions recorded by the Facebook pixel on your website and attributed to your ads.
Instagram Page Creatives:
Clips Replays: clips_replays - The number of times your clips were replayed.
Comments: comments - The number of comments on your content.
Engagement: engagement - The total number of times people engaged with your content through likes, comments, saves, and shares.
Follows: follows - The number of follows from your content.
IG reels aggregated all plays count: ig_reels_aggregated_all_plays_count - The total number of times your reels were played.
IG reels average watch time: ig_reels_avg_watch_time - The average amount of time users spent watching your reels.
IG reels video view total time: ig_reels_video_view_total_time - The total amount of time users spent viewing your reels.
Impressions: impressions - The number of times your content was seen.
Navigation: navigation - The number of navigations from your content.
Plays: plays - The number of times your content was played.
Profile activity: profile_activity - The number of profile activities from your content.
Profile visits: profile_visits - The number of profile visits from your content.
Reach: reach - The number of unique accounts that saw your content.
Replies: replies - The number of replies to your content.
Saved: saved - The number of times your content was saved.
Shares: shares - The number of times your content was shared.
Total interactions: total_interactions - The total number of all interactions with your content.
Video Views: video_views - The number of times your video was viewed.
Views: views - The number of views of your content.
Instagram Page Insights:
Account engaged: accounts_engaged - The number of accounts that have interacted with your content, including in ads. Content includes posts, stories, reels, videos and live videos. Interactions can include actions such as likes, saves, comments, shares or replies.
Comments: comments - The number of comments on your posts, reels, videos and live videos. engaged_audience_demographics - The demographic characteristics of the engaged audience, including countries, cities and gender distribution. Only total time increment is possible.
Follower demographics: follower_demographics - The demographic characteristics of followers, including countries, cities and gender distribution.
Follows Count: follows_count - The number of people you follow.
Impressions: impressions - The number of times your posts, stories, reels, videos and live videos were seen on screen, including in ads.
Likes: likes - The number of likes on your posts, reels, and videos.
Net followers: net_followers - The net followers: the sum of new followers and the sum of people that unfollowed you at the end of the period.
Net unfollowers: new_unfollowers - The number of people that unfollowed you at the end of the period.
Number of interactions: total_interactions - The number of times your posts, stories, reels, videos and live videos were on screen, including in ads.
Profile Views: profile_views - The number of times your profile was visited.
Reach: reach - The number of unique accounts that have seen your content, at least once, including in ads. Content includes posts, stories, reels, videos and live videos. Reach is different from impressions, which may include multiple views of your content by the same accounts.
Reached audience demographics: reached_audience_demographics - The demographic characteristics of the reached audience, including countries, cities and gender distribution.
Saves: saves - The number of saves of your posts, reels, and videos.
Shares: shares - The number of shares of your posts, stories, reels, videos and live videos.
Total follower count: total_follower_count - The total of all followers.
Total interactions: total_interactions - The number of times your posts, stories, reels, videos and live videos were on screen, including in ads.
Views: views - The number of times your content was played or displayed. Content includes reels, posts, stories.
Website Clicks: website_clicks - Total number of clicks on the website link through the IG User's profile.
Google Analytics Metrics & KPI's
Active 7 Day Users: active7DayUsers - The number of users who have engaged with the website or app in the past 7 days.
Active Users: activeUsers - The number of users who have engaged with the website or app in the selected time period.
Add To Carts: addToCarts - The number of times items have been added to shopping carts.
Advertiser ad clicks: advertiserAdClicks - The number of times users have clicked on advertisements.
Advertiser ad cost: advertiserAdCost - The total cost of advertisements.
Advertiser ad cost per click: advertiserAdCostPerClick - The average cost of each advertisement click.
Advertiser Ad Cost Per Conversion: advertiserAdCostPerConversion - The average cost of each conversion from advertisements. Deprecation warning: This metric is deprecated and will be removed in the future. Please use the metric advertiserAdCostPerKeyEvent instead.
Advertiser ad cost per key event: advertiserAdCostPerKeyEvent - Cost per key event is ad cost divided by key events.
Advertiser ad impressions: advertiserAdImpressions - The number of times advertisements have been viewed.
Average engagement time: averageSessionDuration - Average engagement time calculated based on session durations.
Average purchase revenue: averagePurchaseRevenue - The average revenue generated from each purchase.
Average purchase revenue per user: averagePurchaseRevenuePerUser - The average revenue generated from each user through purchases.
Average revenue per user: averageRevenuePerUser - Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings.
Bounce rate: bounceRate - The percentage of sessions that were not engaged.
Checkouts: checkouts - The number of completed checkouts.
Conversion (deprecated): conversions - Conversion events. You can mark any event as a conversion in Google Analytics. Deprecation warning: This metric is deprecated. Use "keyEvents" instead.
Ecommerce purchases: ecommercePurchases - The number of times users completed a purchase. This metric counts purchase events; this metric does not count in_app_purchase and subscription events.
Engaged sessions: engagedSessions - The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
Engagement rate: engagementRate - The percentage of engaged sessions (Engaged sessions divided by Sessions). This metric is returned as a fraction; for example, 0.7239 means 72.39% of sessions were engaged sessions.
Item list click events: itemListClickEvents - The number of times users clicked on a list of items.
Item refund amount: itemRefundAmount - The total amount refunded for items.
Item revenue: itemRevenue - The total revenue generated from items.
Items added to cart: itemsAddedToCart - The number of items added to the shopping cart.
Items purchased: itemsPurchased - The number of items that have been purchased.
Key events: keyEvents - The count of key events. Marking an event as a key event affects reports from the time of creation. It doesn't change historical data. You can mark any event as key in Google Analytics, and some events (such as 'first_open' or 'purchase') are marked as key events by default.
New users: newUsers - The number of new users that have registered or visited the site.
Organic google search average position: organicGoogleSearchAveragePosition - The average position of the site in organic Google search results.
Organic Google Search Click Through Rate: organicGoogleSearchClickThroughRate - The click-through rate for organic Google search results.
Organic google search clicks: organicGoogleSearchClicks - The number of clicks from organic Google search results.
Percent scrolled: percentScrolled - The percentage down the page that the user has scrolled (for example, 90). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter percent_scrolled.Publisher Ad Clicks: publisherAdClicks - The number of clicks on publisher ads.
Publisher ad impressions: publisherAdImpressions - The number of impressions of publisher ads.
Purchaser conversion rate (deprecated): purchaserConversionRate - The conversion rate of purchasers. Deprecation warning: This metric is deprecated and will be removed in the future. Use the "conversionRate" metric instead.
Return on ad spend: returnOnAdSpend - The return on ad spend.
Scrolled users: scrolledUsers - The number of users who scrolled.
Session conversion rate (deprecated): sessionConversionRate - The conversion rate of sessions. Deprecation warning: This metric is deprecated and will be removed in the future. Use the "sessionKeyEventRate" metric instead.
Session key event rate: sessionKeyEventRate - The percentage of sessions in which any key event was triggered.
Session key event rate (click): sessionKeyEventRate:click - The percentage of sessions in which a click event was triggered.Session key event rate (formStart): sessionKeyEventRate:form_start - The percentage of sessions in which a formStart event was triggered.Session key event rate (purchase): sessionKeyEventRate:purchase - The percentage of sessions in which a purchase event was triggered.Sessions: sessions - Number of sessions.
Total ad revenue: totalAdRevenue - The total advertising revenue from both Admob and third-party sources.
Total purchasers: totalPurchasers - The number of users that logged purchase events for the time period selected.
Total revenue: totalRevenue - The total revenue.
Total users: totalUsers - The number of distinct users who have logged at least one event, regardless of whether the site or app was in use when that event was logged.
Transactions: transactions - The count of transaction events with purchase revenue. Transaction events are in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, and refund.
User conversion rate (deprecated): userConversionRate - The conversion rate of users. Deprecation warning: This metric is deprecated and will be removed in the future. Use the "userKeyEventRate" metric instead.
User engagement: userEngagementDuration - The total amount of time (in seconds) your website or app was in the foreground of users' devices.
Views: screenPageViews - The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events).
Last updated
Was this helpful?