Facebook Page Insights: Most-used fields

Facebook Page Insights: Most-used fields#

The table below gives information about most-used fields that you can import from Facebook Page Insights. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name

Adverity UI name

Description

Use in Adverity

Actions Post Reactions (Total)

The total number of reactions (like, love, haha, wow, sad, angry) on your posts.

metric

Actions Post Reactions: ANGER (Total)

The total number of ‘Angry’ reactions on your posts.

metric

Actions Post Reactions: HAHA (Total)

The total number of ‘Haha’ reactions on your posts.

metric

Actions Post Reactions: LIKE (Total)

The total number of ‘Like’ reactions on your posts.

metric

Actions Post Reactions: LOVE (Total)

The total number of ‘Love’ reactions on your posts.

metric

Actions Post Reactions: SORRY (Total)

The total number of ‘Sad’ reactions on your posts.

metric

Actions Post Reactions: WOW (Total)

The total number of ‘Wow’ reactions on your posts.

metric

Age

Age

The age demographic of the users.

dimension

Age/Gender

Gender Age

Demographic breakdown of users by age and gender, typically for insights like video view time.

dimension

Answers

metric

Answers (Unique)

metric

Breakdown Type

Breakdown Type

The category used to segment insights data, such as age, gender, or country.

dimension

Breakdown Value

Breakdown Value

The specific value within a breakdown category (e.g., ‘18-24’ for age, ‘Male’ for gender).

dimension

COMMENT

Reel Social Actions (COMMENT)

dimension

CTA Clicks by Age and Gender (Logged In) (Unique)

CTA Clicks by Age and Gender (Logged In) (Unique)

dimension

CTA Clicks by City (Logged In) (Unique)

CTA Clicks by City (Logged In) (Unique)

The unique number of clicks on your Page’s call-to-action buttons by users logged into Facebook, broken down by city.

dimension

CTA Clicks by Country (Logged In) (Unique)

CTA Clicks by Country (Logged In) (Unique)

The unique number of clicks on your Page’s call-to-action buttons by users logged into Facebook, broken down by country.

dimension

CTA Clicks by Site (Logged In) (Unique)

CTA Clicks by Site (Logged In) (Unique)

dimension

Call Phone Clicks by Age and Gender (Logged In) (Unique)

Call Phone Clicks by Age and Gender (Logged In) (Unique)

dimension

Call Phone Clicks by City (Logged In) (Unique)

Call Phone Clicks by City (Logged In) (Unique)

dimension

Call Phone Clicks by Country (Logged In) (Unique)

Call Phone Clicks by Country (Logged In) (Unique)

dimension

Call Phone Clicks by Site (Logged In) (Unique)

Call Phone Clicks by Site (Logged In) (Unique)

dimension

Check-Ins

Check-Ins

The number of check-ins to your Page’s location or an event associated with your Page.

dimension

Check-Ins (Unique)

Check-Ins (Unique)

The number of unique people who checked into your Page’s location or an event associated with your Page.

dimension

City

City

Demographic breakdown of users or fans by city.

dimension

Clicks

The total number of clicks on your Page or its content, including links, photos, videos, and call-to-action buttons.

metric

Clicks (Unique)

Clicks (Unique)

The number of unique people who clicked on your posts without generating a story.

metric

Comments

The total number of comments on your Page’s posts.

metric

Comments (Unique)

The number of unique users who commented on your Page’s posts.

metric

Consumptions

Consumptions

The total number of clicks on your posts, including link clicks, photo views, video plays, and other clicks.

metric

Consumptions (Unique)

Consumptions (Unique)

The number of unique users who performed any type of click on your posts, including link clicks, photo views, video plays, and other clicks.

metric

Country

Country

Demographic breakdown of users or fans by country.

dimension

Country Name

Country Name

The name of the country.

dimension

Coupon (Offer Claims)

Coupon (Offer Claims)

The total number of times an offer or coupon associated with your page was claimed.

dimension

Coupon (Offer Claims) (Unique)

Coupon (Offer Claims) (Unique)

The number of unique users who claimed an offer or coupon associated with your page.

dimension

Datasource

Datasource

The origin of the data, indicating which API or system provided the information.

dimension

Date

Date

The date for which the insights data is reported.

dimension

Demographic Followers

Demographic Followers

Demographic information about your page followers, such as age, gender, and location.

metric

Engaged Users

Engaged Users

The number of people who have engaged with your content.

metric

Engagements

Engagements

The total number of times people engaged with your posts through reactions, comments, shares, and other actions.

dimension

Event (RSVP)

Event (RSVP)

The number of RSVPs to events associated with your Page.

dimension

Event (RSVP) (Unique)

Event (RSVP) (Unique)

The number of unique people who RSVP’d to events associated with your Page.

dimension

Fan (Page likes)

Fan (Page likes)

The total number of users who have liked your Facebook Page.

metric

Fan (Page likes) (Unique)

Fan (Page likes) (Unique)

The total number of unique users who have liked your Facebook Page. This is equivalent to the total number of fans.

dimension

Fan Adds

Fan Adds

The number of new users who liked your Facebook Page within the reporting period.

metric

Fan Adds (Unique)

Fan Adds (Unique)

The number of unique new users who liked your Facebook Page within the reporting period.

metric

Fan Adds by Paid/Non Paid (Unique)

The number of unique new users who liked your Facebook Page, categorized by whether the like originated from paid or unpaid (organic) efforts.

metric

Fan Removes

Fan Removes

The number of users who unliked your Facebook Page within the reporting period.

metric

Fan Removes (Unique)

Fan Removes (Unique)

The number of unique users who unliked your Facebook Page within the reporting period.

metric

Fans

Fans

The total number of people who have liked your Page.

metric

Fans Locale

Fans Locale

The geographical location (locale) of your Facebook Page followers.

metric

Fans by City

The distribution of your Facebook Page followers by city.

metric

Fans by Country

The distribution of your Facebook Page followers by country.

metric

Fans by Gender and Age

Fans by Gender and Age

metric

Fans by Like Source

Fans by Like Source

Aggregated data showing the number of people who liked your Page, broken down by the source from which the like originated (e.g., Ads, News Feed, Search).

metric

Fans by Like Source (Unique)

Fans by Like Source (Unique)

The number of unique users who liked your Facebook Page, broken down by the source of the like (e.g., organic, paid).

metric

Follows

The total number of users who follow your Facebook Page.

metric

Gender

Gender

The gender demographic of the users.

dimension

Geolocations

Geolocations

Geographical data related to your page’s audience or content interactions.

dimension

Get Directions Clicks by Age and Gender (Logged In) (Unique)

Get Directions Clicks by Age and Gender (Logged In) (Unique)

dimension

Get Directions Clicks by City (Logged In) (Unique)

Get Directions Clicks by City (Logged In) (Unique)

dimension

Get Directions Clicks by Country (Logged In) (Unique)

Get Directions Clicks by Country (Logged In) (Unique)

dimension

Get Directions Clicks by Site (Logged In) (Unique)

Get Directions Clicks by Site (Logged In) (Unique)

dimension

Hidden all posts (Unique)

Hidden all posts (Unique)

The unique number of users who chose to hide all posts from your Page.

metric

ID

id

A unique identifier for an object or entity.

dimension

Impressions

The total number of times any content from your Facebook Page, or content about your Page, was displayed on someone’s screen.

metric

Impressions (Nonviral)

The number of times your Page content was displayed on screen, excluding impressions generated through social actions by friends (viral).

metric

Impressions (Nonviral) (Unique)

The number of unique users who had your Page content displayed on their screen, excluding impressions generated through social actions by friends (viral).

metric

Impressions (Organic)

The number of times your Page content or content about your Page was displayed on screen through unpaid distribution.

metric

Impressions (Organic) (Unique)

Impressions (Organic) (Unique)

The number of unique users who had your Page content or content about your Page displayed on their screen through unpaid distribution.

metric

Impressions (Organic) Unique

The number of unique users who had your Page content or content about your Page displayed on their screen through unpaid distribution.

metric

Impressions (Paid)

The number of times your Page content or content about your Page was displayed on screen through paid distribution, such as advertisements.

metric

Impressions (Paid) (Unique)

The number of unique users who had your Page content or content about your Page displayed on their screen through paid distribution.

metric

Impressions (Paid) Unique

The number of unique users who had your Page content or content about your Page displayed on their screen through paid distribution.

metric

Impressions (Unique)

The number of unique users who had any content from your Facebook Page, or content about your Page, displayed on their screen.

metric

Impressions (Viral)

The number of times your Page content was displayed on screen due to social actions by friends, such as a friend liking or sharing your content.

metric

Impressions Fan

The total number of times any of your Page’s fans saw your posts on Facebook.

metric

Impressions Fan (Paid)

Impressions Fan (Paid)

The number of times your Page’s fans saw your paid content or advertisements.

metric

Impressions Fan (Paid) (Unique)

Impressions Fan (Paid) (Unique)

The number of unique fans who saw your Page’s paid content or advertisements.

metric

Impressions Fan (Unique)

The number of unique fans who saw any of your Page’s posts on Facebook.

metric

Impressions Viral (Unique)

The number of unique users who had your Page content displayed on their screen due to social actions by friends.

metric

Impressions through Check-Ins

Impressions through Check-Ins

The number of times your Page content was displayed on screen because users checked into your location or a related place.

dimension

Impressions through Mentions

Impressions through Mentions

The number of times your Page content was displayed on screen because your Page was mentioned or tagged in posts.

dimension

Impressions through Mentions (Unique)

Impressions through Mentions (Unique)

The number of unique users who had your Page content displayed on their screen because your Page was mentioned or tagged in posts.

dimension

Impressions through Offer Claims (Unique)

Impressions through Offer Claims (Unique)

The number of unique users who saw content about your Page because they claimed an offer associated with it.

dimension

Impressions through Page Other

Impressions through Page Other

The number of times your Page content was displayed on screen through other unspecified sources directly related to your Page.

metric

Impressions through Page likes

Impressions through Page likes

The number of times your Page content was displayed on screen due to users liking your Page or a friend liking your Page.

dimension

Impressions through Posts

Impressions through Posts

The number of times your individual Page posts were displayed on someone’s screen.

dimension

Impressions through RSVP

Impressions through RSVP

The number of times your Page content was displayed on screen because users RSVP’d to an event associated with your Page.

dimension

Interactions

Interactions

The total number of times people interacted with your content.

metric

Like Source

Like Source

The source from which a Page like originated (e.g., Ads, News Feed, Search).

dimension

Likes

The total number of ‘Like’ reactions on your Page’s posts, photos, or videos.

metric

Likes (Unique)

The number of unique users who applied a ‘Like’ reaction to your Page’s posts, photos, or videos.

metric

Link Clicks

The total number of times users clicked on links in your Page’s posts or on the Page itself.

metric

Link Clicks (Unique)

Link Clicks (Unique)

The unique number of users who clicked on links within your posts.

metric

Links

The total number of clicks on links shared in your Page’s posts.

metric

Links (Unique)

The number of unique users who clicked on links shared in your Page’s posts.

metric

Media_Type

Media_Type

The type of media associated with the content (e.g., photo, video, link).

dimension

Mentions

Mentions

The number of times your Page was tagged or mentioned in posts.

dimension

Mentions (Unique)

Mentions (Unique)

The number of unique people who tagged or mentioned your Page in posts.

dimension

Month

Month

The month of the data point.

metric

Name

name

The name of an object or entity.

dimension

Negative Feedback

Negative Feedback

The number of negative feedback actions, such as hiding posts or reporting spam.

metric

New Follows

The number of new users who started following your Facebook Page within the reporting period.

metric

New Follows (Unique)

The number of unique new users who started following your Facebook Page within the reporting period.

metric

New Unfollows

The number of users who unfollowed your Facebook Page within the reporting period.

metric

New Unfollows (Unique)

The number of unique users who unfollowed your Facebook Page within the reporting period.

metric

Offer Claims

Offer Claims

The number of times users claimed an offer associated with your Page.

dimension

Offer Claims (Unique)

Offer Claims (Unique)

The number of unique people who claimed an offer associated with your Page.

dimension

Offer claim

The total number of times an offer associated with your page was claimed.

metric

Offer claim (Unique)

The number of unique users who claimed an offer associated with your page.

metric

Other Actiontypes

Other Actiontypes

The total number of various actions taken on your Page or its content that are not categorized under specific metrics like likes, comments, or shares.

metric

Other Actiontypes (Unique)

Other Actiontypes (Unique)

The number of unique users who performed various actions on your Page or its content that are not categorized under specific metrics.

metric

Other Clicks

The total number of clicks on your Page content that are not categorized as link clicks, photo views, or video plays.

metric

Other Clicks (Unique)

Other Clicks (Unique)

The unique number of users who clicked on elements within your posts other than links, reactions, or shares.

metric

Page Id

Page Id

The unique identifier of the Facebook Page.

metric

Page Name

Page Name

The name of the Facebook Page.

dimension

Page Unlikes

Page Unlikes

The total number of times users unliked your Facebook Page.

dimension

Page Unlikes (Unique)

Page Unlikes (Unique)

The number of unique users who unliked your Facebook Page.

dimension

Page Views (Logout)

Page Views (Logout)

metric

Page Views (Total)

The total number of times your Facebook Page was viewed by users, including both logged-in and logged-out individuals.

metric

Page Views by External Referrals

Page Views by External Referrals

The number of times your Page was viewed by users coming from external websites or sources outside of Facebook.

metric

Page Views by Profile Tab (Logged In) (Unique)

Page Views by Profile Tab (Logged In) (Unique)

The unique number of times users logged into Facebook viewed your Page’s profile tab.

metric

Page Views by Profile Tab (Total)

Page Views by Profile Tab (Total)

The total number of times users logged into Facebook viewed your Page’s profile tab.

metric

Page level videos CPM (Crossposted)

The average cost per thousand impressions for ads displayed within videos that were crossposted to your Page.

metric

Page level videos CPM (Owned)

The average cost per thousand impressions for ads displayed within videos that are owned and published directly on your Page.

metric

Page level videos ad impression (Crossposted)

The number of times ads displayed within videos that were crossposted to your Page were shown.

metric

Page level videos ad impression (Owned)

The number of times ads displayed within videos that are owned and published directly on your Page were shown.

metric

Page level videos revenue (Crossposted)

The estimated revenue generated from ads displayed within videos that were crossposted to your Page.

metric

Page level videos revenue (Owned)

The estimated revenue generated from ads displayed within videos that are owned and published directly on your Page.

metric

Photo Views

The total number of times photos on your Page or in your posts were viewed.

metric

Places Checkin (Mobile)

Places Checkin (Mobile)

metric

Places Checkin (Mobile) (Unique)

Places Checkin (Mobile) (Unique)

metric

Places Checkins by Age and Gender

Places Checkins by Age and Gender

The number of times users checked into your Page’s physical location, broken down by age and gender.

dimension

Places Checkins by Country

Places Checkins by Country

The number of times users checked into your Page’s physical location, broken down by country.

dimension

Places Checkins by Locale

Places Checkins by Locale

The number of times users checked into your Page’s physical location, broken down by locale (language setting).

dimension

Post Engagements

The total number of actions taken on your posts, including reactions, comments, shares, and clicks.

metric

Post Impressions

The total number of times your Page’s posts were displayed on someone’s screen.

metric

Post Impressions (Nonviral)

The number of times your Page’s posts were displayed on screen, excluding impressions generated through social actions by friends (viral).

metric

Post Impressions (Nonviral) (Unique)

The number of unique users who had your Page’s posts displayed on their screen, excluding impressions generated through social actions by friends (viral).

metric

Post Impressions (Paid)

The number of times your Page’s posts were displayed on screen through paid distribution.

metric

Post Impressions (Paid) (Unique)

The number of unique users who had your Page’s posts displayed on their screen through paid distribution.

metric

Post Impressions (Unique)

The number of unique users who had your Page’s posts displayed on their screen.

metric

Post Impressions (Viral)

The number of times your Page’s posts were displayed on screen due to social actions by friends.

metric

Post Impressions Viral (Unique)

The number of unique users who had your Page’s posts displayed on their screen due to social actions by friends.

metric

Posts Served Impressions Organic (Unique)

The number of unique users who saw your Page’s posts displayed on their screen through unpaid (organic) distribution.

metric

Posts hidden

Posts hidden

The total number of times posts from your Page were hidden by users.

metric

Posts hidden (Unique)

Posts hidden (Unique)

The unique number of users who chose to hide a specific post from your Page.

metric

Profile Tab Total

Profile Tab Total

The total number of times your Page’s profile tab was viewed.

dimension

Question answers

Question answers

The number of answers to questions posted on your Page.

dimension

Question answers (Unique)

Question answers (Unique)

The number of unique people who answered questions posted on your Page.

dimension

REACTION_ANGER

Reel Likes (ANGER)

dimension

REACTION_HAHA

Reel Likes (HAHA)

dimension

REACTION_LIKE

Reel Likes (LIKE)

Total ‘like’ reactions on a Reel.

dimension

REACTION_LOVE

Reel Likes (LOVE)

dimension

REACTION_SORRY

Reel Likes (SORRY)

dimension

REACTION_WOW

Reel Likes (WOW)

dimension

RSVP

The total number of responses (Yes, Maybe, No) to events associated with your Facebook Page.

metric

RSVP (Unique)

The number of unique users who responded (Yes, Maybe, No) to events associated with your Facebook Page.

metric

RSVPs

RSVPs

The number of RSVPs to events.

dimension

RSVPs (Unique)

RSVPs (Unique)

The number of unique people who RSVP’d to events.

dimension

Reactions Total

Reactions Total

The total number of reactions (like, love, wow, haha, sorry, anger) received on your content.

dimension

Reactions: ANGER (Total)

The total number of ‘Angry’ reactions on your posts.

metric

Reactions: HAHA (Total)

The total number of ‘Haha’ reactions on your posts.

metric

Reactions: LIKE (Total)

The total number of ‘Like’ reactions on your posts.

metric

Reactions: LOVE (Total)

The total number of ‘Love’ reactions on your posts.

metric

Reactions: SORRY (Total)

The total number of ‘Sad’ reactions on your posts.

metric

Reactions: WOW (Total)

The total number of ‘Wow’ reactions on your posts.

metric

Report spam Clicks

Report spam Clicks

The number of times users clicked to report an object as spam.

dimension

Reported as spam

Reported as spam

The total number of times posts from your Page were reported as spam by users.

dimension

Reported as spam (Unique)

Reported as spam (Unique)

The unique number of users who reported a post from your Page as spam.

dimension

SHARE

Reel Social Actions (SHARE)

metric

Shares

The total number of times your Page’s posts were shared by users.

metric

Shares (Unique)

The number of unique users who shared your Page’s posts.

metric

Timestamp

Timestamp

The specific point in time for which the data is recorded.

dimension

Total Actions

The sum of all actions taken on your Facebook Page or its content, including likes, comments, shares, and other interactions.

metric

Total Video 10s Views

The total number of times your Page’s videos were played for at least 10 seconds.

metric

Total Video 10s Views (Unique)

The number of unique users who viewed your Page’s videos for at least 10 seconds.

metric

Total Video 10s Views Auto Played

The total number of times your Page’s videos were played for at least 10 seconds due to autoplay, without a user initiating the play.

metric

Total Video 10s Views Clicked To Play

The total number of times your Page’s videos were played for at least 10 seconds because a user explicitly clicked to play them.

metric

Total Video 10s Views Organic

The total number of times your Page’s videos were played for at least 10 seconds through unpaid (organic) distribution.

metric

Total Video 10s Views Paid

The total number of times your Page’s videos were played for at least 10 seconds through paid distribution.

metric

Total Video 10s Views Sound On

The total number of times your Page’s videos were played for at least 10 seconds with the sound turned on.

metric

Total Video Ad Break Ad Cpm

The average cost per thousand impressions for ads displayed during ad breaks within your videos.

metric

Total Video Ad Break Ad Impressions

The total number of times ads displayed during ad breaks within your videos were shown.

metric

Total Video Ad Break Earnings

The estimated earnings generated from ads displayed during ad breaks within your videos.

metric

Total Video Avg Time Watched

The average amount of time users spent watching your Page’s videos.

metric

Total Video Complete Views

The total number of times your Page’s videos were watched to completion, or nearly their total length.

metric

Total Video Complete Views (Unique)

The number of unique users who watched your Page’s videos to completion, or nearly their total length.

metric

Total Video Complete Views Auto Played

The total number of times your Page’s videos were watched to completion when initiated by autoplay.

metric

Total Video Complete Views Clicked To Play

The total number of times your Page’s videos were watched to completion when initiated by a user click.

metric

Total Video Complete Views Organic

The total number of times your Page’s videos were watched to completion through unpaid (organic) distribution.

metric

Total Video Complete Views Organic (Unique)

The number of unique users who watched your Page’s videos to completion through unpaid (organic) distribution.

metric

Total Video Complete Views Paid

The total number of times your Page’s videos were watched to completion through paid distribution.

metric

Total Video Complete Views Paid (Unique)

The number of unique users who watched your Page’s videos to completion through paid distribution.

metric

Total Video Reactions By Type Total

The total count of reactions on your videos, broken down by reaction type (e.g., Like, Love, Haha).

metric

Total Video Retention Graph

Data representing the percentage of viewers who continue watching your video at each point in its duration.

metric

Total Video Retention Graph Autoplayed

Data representing viewer retention for videos that were initiated by autoplay.

metric

Total Video Retention Graph Clicked To Play

Data representing viewer retention for videos that were initiated by a user click.

metric

Total Video Stories By Action Type

metric

Total Video View Time By Age Bucket And Gender

The total time users spent watching your videos, broken down by their age range and gender.

metric

Total Video View Time By Distribution Type

The total time users spent watching your videos, categorized by how the video was distributed (e.g., organic, paid, shared).

metric

Total Video View Time By Region Id

The total time users spent watching your videos, broken down by geographical region.

metric

Total Video View Total Time

The aggregate amount of time users spent watching your Page’s videos.

metric

Total Video View Total Time Organic

The aggregate amount of time users spent watching your Page’s videos through unpaid (organic) distribution.

metric

Total Video View Total Time Paid

The aggregate amount of time users spent watching your Page’s videos through paid distribution.

metric

Total Video Views

The total number of times your Page’s videos were viewed.

metric

Total Video Views (Unique)

The number of unique users who viewed your Page’s videos.

metric

Total Video Views Autoplayed

The total number of times your Page’s videos were viewed due to autoplay.

metric

Total Video Views By Distribution Type

The total number of times your Page’s videos were viewed, categorized by how the video was distributed.

metric

Total Video Views Clicked To Play

The total number of times your Page’s videos were viewed because a user explicitly clicked to play them.

metric

Total Video Views Organic

The total number of times your Page’s videos were viewed through unpaid (organic) distribution.

metric

Total Video Views Organic (Unique)

The number of unique users who viewed your Page’s videos through unpaid (organic) distribution.

metric

Total Video Views Paid

The total number of times your Page’s videos were viewed through paid distribution.

metric

Total Video Views Paid (Unique)

The number of unique users who viewed your Page’s videos through paid distribution.

metric

Total Video Views Sound On

The total number of times your Page’s videos were viewed with the sound turned on.

metric

Unlike Page Clicks

Unlike Page Clicks

The number of times users clicked the ‘Unlike Page’ button.

dimension

Unlike Source

Unlike Source

dimension

Users Posts

Users Posts

The number of posts made by users on your Page.

dimension

Users Posts (Unique)

Users Posts (Unique)

The number of unique users who made posts on your Page.

dimension

Video Complete Views 30s

The total number of times your videos were watched for at least 30 seconds, or to completion if shorter.

metric

Video Complete Views 30s (Autoplayed)

The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by autoplay.

metric

Video Complete Views 30s (Click To Play)

The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by a user click.

metric

Video Complete Views 30s (Clicked to Play)

The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by a user click.

metric

Video Complete Views 30s (Organic)

The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) through unpaid (organic) distribution.

metric

Video Complete Views 30s (Paid)

The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) through paid distribution.

metric

Video Complete Views 30s (Repeat Views)

The number of times users watched your videos for at least 30 seconds (or to completion if shorter) more than once within the reporting period.

metric

Video Complete Views 30s (Unique)

The number of unique users who watched your videos for at least 30 seconds, or to completion if shorter.

metric

Video Length

The duration of the video content.

metric

Video Plays

The total number of times a video started playing on your Page.

metric

Video Repeat Views

The number of times users watched your videos more than once within the reporting period.

metric

Video View Time

The total aggregate time users spent watching your Page’s videos.

metric

Video View Time by Age Bucket and Gender

The total time users spent watching your videos, broken down by their age range and gender.

metric

Video View Time by Country Id

The total time users spent watching your videos, broken down by country.

metric

Video View Time by Distribution Type (Page Owned)

The total time users spent watching videos owned and published directly on your Page, categorized by distribution type (e.g., organic, paid).

metric

Video View Time by Distribution Type (Shared)

The total time users spent watching videos shared to your Page, categorized by distribution type.

metric

Video View Time by Region Id

The total time users spent watching your videos, broken down by geographical region.

metric

Video Views

The total number of times your Page’s videos were viewed.

metric

Video Views (Autoplayed)

The total number of times your Page’s videos were viewed due to autoplay.

metric

Video Views (Click To Play)

The total number of times your Page’s videos were viewed because a user explicitly clicked to play them.

metric

Video Views (Clicked to Play)

The total number of times your Page’s videos were viewed because a user explicitly clicked to play them.

metric

Video Views (Organic)

The total number of times your Page’s videos were viewed through unpaid (organic) distribution.

metric

Video Views (Organic) (Unique)

The number of unique users who viewed your Page’s videos through unpaid (organic) distribution.

metric

Video Views (Paid)

The total number of times your Page’s videos were viewed through paid distribution.

metric

Video Views (Paid) (Unique)

The number of unique users who viewed your Page’s videos through paid distribution.

metric

Video Views (Unique)

The number of unique users who viewed your Page’s videos.

metric

Video Views 10s

Video Views 10s

The number of times a video played for at least 10 seconds, or nearly its total length if shorter than 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Autoplayed)

Video Views 10s (Autoplayed)

The number of times a video automatically played for at least 10 seconds, or nearly its total length if shorter than 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Click To Play)

Video Views 10s (Click To Play)

The number of times a video played for at least 10 seconds after people clicked play. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Clicked to Play)

Video Views 10s (Clicked to Play)

The number of times your videos played for at least 10 seconds after people clicked play. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Organic)

Video Views 10s (Organic)

The number of times a video played for at least 10 seconds through organic reach. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Paid)

Video Views 10s (Paid)

The number of times a promoted video played for at least 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Repeat)

Video Views 10s (Repeat)

The number of times a video was replayed for at least 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Sound On)

Video Views 10s (Sound On)

The number of times a video played with sound on for at least 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 10s (Unique)

Video Views 10s (Unique)

The number of unique people who viewed a video for at least 10 seconds. This metric is deprecated above Graph API v18.

metric

Video Views 15s

The total number of times your videos were viewed for at least 15 seconds.

metric

Video Views 60s (excluding videos shorter than 60s)

The total number of times your videos were viewed for at least 60 seconds, excluding videos with a total length shorter than 60 seconds.

metric

Video Views Avg Time Watched

The average amount of time users spent watching your Page’s videos.

metric

Video Views Complete Views (Organic)

The total number of times your Page’s videos were watched to completion through unpaid (organic) distribution.

metric

Video Views Complete Views (Organic) (Unique)

The number of unique users who watched your Page’s videos to completion through unpaid (organic) distribution.

metric

Video Views Complete Views (Paid)

The total number of times your Page’s videos were watched to completion through paid distribution.

metric

Video Views Complete Views (Paid) (Unique)

The number of unique users who watched your Page’s videos to completion through paid distribution.

metric

Video Views Graph

Data representing the viewership trend of your videos over time.

metric

Video Views Graph (Autoplayed)

Data representing the viewership trend of your videos over time, specifically for those initiated by autoplay.

metric

Video Views Graph Clicked To Play

Data representing the viewership trend of your videos over time, specifically for those initiated by a user click.

metric

Video Views Sound On

The total number of times your Page’s videos were viewed with the sound turned on.

metric

Video Views Time

The total aggregate time users spent watching your Page’s videos.

metric

Video Views Time (Organic)

The total aggregate time users spent watching your Page’s videos through unpaid (organic) distribution.

metric

Video Views by Distribution Type (Page Owned)

The total number of times videos owned and published directly on your Page were viewed, categorized by distribution type.

metric

Video Views by Distribution Type (Shared)

The total number of times videos shared to your Page were viewed, categorized by distribution type.

metric

Video Views by Paid/Non Paid

The total number of times your videos were viewed, categorized by whether the views originated from paid or unpaid (organic) distribution.

metric

Website Clicks by Age and Gender (Logged In) (Unique)

Website Clicks by Age and Gender (Logged In) (Unique)

dimension

Website Clicks by City (Logged In) (Unique)

Website Clicks by City (Logged In) (Unique)

dimension

Website Clicks by Country (Logged In) (Unique)

Website Clicks by Country (Logged In) (Unique)

dimension

Website Clicks by Site (Logged In) (Unique)

Website Clicks by Site (Logged In) (Unique)

dimension

Year

Year

The year of the data point.

metric

about

About

The ‘About’ section text of the Facebook Page.

dimension

account_id

account_id

The unique identifier for the Facebook account associated with the Page.

dimension

account_name

account_name

The name of the Facebook account associated with the Page.

dimension

blue_reels_play_count

Blue Reels Play Count

dimension

business id

business id

metric

business_id

Business ID

The unique identifier for the business associated with the Facebook Page.

dimension

business_name

Business Name

The name of the business associated with the Facebook Page.

dimension

call_to_action_link

Call to Action Link

The URL linked to the call-to-action button on the Facebook Page or a post.

dimension

call_to_action_type

Call to Action Type

The type of call-to-action button configured for the Facebook Page or a post (e.g., ‘Shop Now’, ‘Learn More’).

dimension

channel

channel

dimension

clicks

clicks

The total number of times people clicked on anywhere in your posts without generating a story.

metric

comment

Comments

The total number of comments on your Page’s posts.

metric

comments

comments

The number of comments on posts, including nested replies.

metric

content_category

Content Category

The category assigned to the content, which helps in classification and analysis.

dimension

content_type

content_type

The type or category of the content posted (e.g., photo, video, link, status).

dimension

country name

country name

The name of the country.

dimension

created

Created

The date and time when the content or object was created.

dimension

crossposted

Page level videos revenue (Crossposted)

Revenue generated from videos that have been crossposted to other Pages.

metric

daily impressions

daily impressions

The number of times any content from your Page or about your Page entered a person’s screen on a daily basis.

metric

date

date

The date associated with the data point.

dimension

description

Description

A textual description of the content, object, or Page.

dimension

end_date

end_date

The end date for the period during which the data was collected.

dimension

engagement

engagement

The total number of times people engaged with your content.

metric

engagement_paid

engagement_paid

The number of times people engaged with your content through paid distribution such as ads.

metric

engagement_rate

engagement_rate

metric

engagements

engagements

The total number of times people engaged with your posts through reactions, comments, shares, and other actions.

metric

fanadds

fanadds

The number of new users who liked your Facebook Page within the reporting period.

dimension

fanremoves

fanremoves

The number of users who unliked your Facebook Page within the reporting period.

dimension

fans

fans

The total number of people who have liked your Page.

metric

followers_count

Page Followers

The total number of users who follow the Facebook Page.

dimension

follows

follows

The number of times your Facebook Page or profile was followed.

dimension

from_field.id

From Id

The unique identifier of the user or Page that created the content.

dimension

from_field.name

From Name

The name of the user or Page that created the content.

dimension

full_picture

Full Picture

The URL to the full-sized image associated with a post or object.

dimension

icon

Icon

The URL to an icon associated with the post type or object.

dimension

id

ID

The unique identifier for a Facebook object, such as a Page, post, or video.

dimension

impressions

impressions

The number of times any content from your Page or about your Page entered a person’s screen.

metric

impressions (organic)

impressions (organic)

The number of times your Page content or content about your Page was displayed on screen through unpaid distribution.

metric

impressions (organic) (unique)

impressions (organic) (unique)

The number of unique users who had your Page content or content about your Page displayed on their screen through unpaid distribution.

metric

impressions (paid)

impressions (paid)

The number of times your Page content or content about your Page was displayed on screen through paid distribution, such as advertisements.

metric

impressions (paid) (unique)

impressions (paid) (unique)

The number of unique users who had your Page content or content about your Page displayed on their screen through paid distribution.

metric

impressions (viral)

impressions (viral)

The number of times your Page content was displayed on screen due to social actions by friends, such as a friend liking or sharing your content.

metric

impressions_organic

impressions_organic

The number of times your Page content or content about your Page was displayed on screen through unpaid distribution.

dimension

instagram_eligibility

Instagram Eligibility

Indicates whether the content or Page is eligible for features related to Instagram integration.

dimension

interactions

interactions

The total number of times people interacted with your content.

metric

is_crosspost_video

Is Crosspost Video

A boolean indicating if the video was crossposted from another Page.

dimension

is_inline_created

Is Inline Created

dimension

is_published

Is Published

A boolean indicating if the content or object is currently published and visible.

dimension

length

Length

The duration of the video content in seconds.

dimension

like

Likes

The total number of ‘Like’ reactions on your Page’s posts, photos, or videos.

metric

likes

likes

The total number of ‘like’ reactions on content.

metric

link

Link

The URL of the primary link associated with a post or object.

dimension

link clicks

Link Clicks

The total number of times users clicked on links in your Page’s posts or on the Page itself.

metric

link_clicks

link_clicks

The number of times people clicked on links within your posts.

dimension

message

Message

The textual content of a post or comment.

dimension

month

month

The month of the data point.

metric

name

Name

The name of the Page, object, or entity.

dimension

object_id

Object Id

The unique identifier for a specific object within a post, such as a photo or video.

dimension

other clicks

Other Clicks

The total number of clicks on your Page content that are not categorized as link clicks, photo views, or video plays.

metric

owned

Page level videos revenue (Owned)

Revenue generated from videos that are owned and published directly by your Page.

metric

page id

page id

A unique identifier for a Facebook Page.

metric

page name

page name

The name of the Facebook Page.

dimension

page posts

page posts

Represents the collection of content published on the Facebook Page.

metric

page views (total)

page views (total)

The number of times a Page’s profile has been viewed by both logged-in and logged-out people.

metric

page_actions_post_reactions_anger_total

Actions Post Reactions: ANGER (Total)

Daily total ‘anger’ reactions on a Page’s posts.

metric

page_actions_post_reactions_haha_total

Actions Post Reactions: HAHA (Total)

Daily total ‘haha’ reactions on a Page’s posts.

metric

page_actions_post_reactions_like_total

Actions Post Reactions: LIKE (Total)

Daily total ‘like’ reactions on a Page’s posts. This includes both ‘like’ and ‘care’ reactions.

metric

page_actions_post_reactions_love_total

Actions Post Reactions: LOVE (Total)

Daily total ‘love’ reactions on a Page’s posts.

metric

page_actions_post_reactions_sorry_total

Actions Post Reactions: SORRY (Total)

Daily total ‘sad’ reactions on a Page’s posts.

metric

page_actions_post_reactions_total

Actions Post Reactions (Total)

The daily total count of all reactions (like, love, wow, haha, sorry, anger) to posts on your Page.

metric

page_actions_post_reactions_wow_total

Actions Post Reactions: WOW (Total)

Daily total ‘wow’ reactions on a Page’s posts.

metric

page_call_phone_clicks_logged_in_by_country_unique

country

The unique number of clicks on a ‘Call Phone’ call-to-action button by users logged into Facebook, broken down by country.

dimension

page_daily_follows

New Follows

The daily number of times your Facebook Page or profile was followed.

metric

page_daily_follows_unique

New Follows (Unique)

The number of unique Accounts Center accounts that followed your Page in the selected time period.

metric

page_daily_unfollows

New Unfollows

The daily number of times your Facebook Page or profile was unfollowed.

metric

page_daily_unfollows_unique

New Unfollows (Unique)

The number of unique Accounts Center accounts that unfollowed your Page in the selected time period.

metric

page_fan_adds

Fan Adds

The number of new people who have liked your Page.

metric

page_fan_adds_by_paid_non_paid_unique

Fan Adds by Paid/Non Paid (Unique)

The unique number of accounts that liked your Page for the first time, broken down by whether the like was attributed to paid or organic content.

metric

page_fan_adds_unique

Fan Adds (Unique)

The unique number of accounts that liked your Page for the first time.

metric

page_fan_removes

Fan Removes

The number of unlikes of your Page.

metric

page_fan_removes_unique

Fan Removes (Unique)

The unique number of accounts that unfollowed or unliked your Page.

metric

page_fans_city

Fans by City

Aggregated Facebook location data, sorted by city, about the people who like your Page.

metric

page_fans_country

Fans by Country

The number of people, aggregated per country, that like your Page.

metric

page_fans_locale

Fans Locale

Aggregated language data about the people who like your Page based on their default language setting.

metric

page_follows

Follows

The total number of followers for your Facebook Page or profile, calculated as follows minus unfollows over the lifetime.

metric

page_follows_city

Fans by City

Aggregated Facebook location data, sorted by city, about the people who like your Page.

metric

page_follows_country

Fans by Country

The number of people, aggregated per country, that like your Page.

metric

page_impressions_paid_unique

Impressions (Paid) (Unique)

The number of unique Accounts Center accounts that saw your ads at least once.

metric

page_owned

Video View Time by Distribution Type (Page Owned)

Indicates that video view time is attributed to content directly owned and published by the Page.

dimension

page_post_engagements

Post Engagements

The number of times people have engaged with your posts through reactions, comments, shares, and more.

metric

page_posts_impressions

Post Impressions

The number of times your Page’s posts entered a person’s screen.

metric

page_posts_impressions_nonviral

Post Impressions (Nonviral)

The number of times your Page’s posts entered a person’s screen, excluding when they were shown with social information attached.

metric

page_posts_impressions_nonviral_unique

Post Impressions (Nonviral) (Unique)

The number of unique people who had any posts by your Page enter their screen, excluding when they were shown with social information attached.

metric

page_posts_impressions_paid

Post Impressions (Paid)

The number of times your Facebook Page and Page content was on screen, attributed to your ads.

metric

page_posts_impressions_paid_unique

Post Impressions (Paid) (Unique)

The number of unique Accounts Center accounts that saw any posts from your Page at least once, attributed to your ads.

metric

page_posts_impressions_unique

Post Impressions (Unique)

The number of unique people who had any of your Page’s posts enter their screen.

metric

page_posts_impressions_viral

Post Impressions (Viral)

The number of times your Page’s posts entered a person’s screen with social information attached.

metric

page_posts_impressions_viral_unique

Post Impressions Viral (Unique)

The number of unique people who had any of your Page’s posts enter their screen with social information attached.

metric

page_posts_served_impressions_organic_unique

Posts Served Impressions Organic (Unique)

The number of unique people who were served your Page’s posts in their Feed, regardless of whether it entered their screen.

metric

page_total_actions

Total Actions

The number of clicks on your Page’s contact information and call-to-action button.

metric

page_url

page_url

The URL of the Facebook Page.

dimension

page_video_complete_views_30s

Video Complete Views 30s

The number of times your Page’s videos played for at least 30 seconds, or nearly their total length if shorter.

metric

page_video_complete_views_30s_click_to_play

Video Complete Views 30s (Click To Play)

The number of times your Page’s videos played for at least 30 seconds after people clicked play.

metric

page_video_complete_views_30s_repeat_views

Video Complete Views 30s (Repeat Views)

The number of times your Page’s videos were replayed for at least 30 seconds.

metric

page_video_repeat_views

Video Repeat Views

The number of times your Page’s videos were replayed for at least 3 seconds, or nearly their total length if shorter.

metric

page_video_view_time

Video View Time

The total time, in milliseconds, people viewed your Page’s video.

metric

page_video_views_by_paid_non_paid

Video Views by Paid/Non Paid

The number of times your Page’s videos played for at least 3 seconds, broken down by total, paid, and non-paid views.

metric

page_video_views_click_to_play

Video Views (Click To Play)

The number of times your Page’s videos played for at least 3 seconds after people clicked play.

metric

page_views_total

Page Views (Total)

The number of times a Page’s profile has been viewed by both logged-in and logged-out users.

metric

paid_actions.comment

paid_actions.comment

The number of comments on your content that are attributed to paid distribution.

metric

paid_actions.like

paid_actions.like

The number of likes on your content that are attributed to paid distribution.

dimension

paid_actions.link_click

paid_actions.link_click

The number of link clicks on your content that are attributed to paid distribution.

dimension

paid_actions.post_engagement

paid_actions.post_engagement

The number of engagements with your posts that are attributed to paid distribution.

dimension

paid_actions.post_reaction

paid_actions.post_reaction

The number of reactions to your posts that are attributed to paid distribution.

metric

paid_actions.video_view

paid_actions.video_view

The number of video views on your content that are attributed to paid distribution.

dimension

paid_clicks

paid_clicks

The total number of clicks on your content that are attributed to paid distribution.

metric

paid_impressions

paid_impressions

The number of times any content from your Page or about your Page entered a person’s screen through paid distribution such as an ad.

dimension

paid_reach

paid_reach

The number of unique people who saw your content through paid distribution.

dimension

parent_id

Parent Id

The unique identifier of the parent object, such as the post ID for a comment, or a parent comment ID for a reply.

dimension

period

Period

The aggregation period for the insights data (e.g., day, week, lifetime).

dimension

permalink_url

PermalinkUrl

The permanent URL for the Facebook post or object.

dimension

photo view

Photo Views

The total number of times photos on your Page or in your posts were viewed.

metric

picture

Picture

The URL to a thumbnail or preview image associated with a post or object.

dimension

platform

platform

dimension

post_clicks

Clicks

The total number of clicks on your Page’s posts, including links, photos, and video plays.

metric

post_impressions

Impressions

The number of times your Page’s post entered a person’s screen.

metric

post_impressions_fan

Impressions Fan

The number of times your Page content was on screen for accounts that followed or liked your Page.

metric

post_impressions_fan_unique

Impressions Fan (Unique)

The number of unique Accounts Center accounts that followed or liked your Page and saw your content.

metric

post_impressions_nonviral

Impressions (Nonviral)

The number of times your Page content was on screen, excluding when it was shown with social information attached.

metric

post_impressions_nonviral_unique

Impressions (Nonviral) (Unique)

The number of unique people who had content from your Page on screen, excluding social information.

metric

post_impressions_organic

Impressions (Organic)

The number of times your post was on screen through organic distribution.

metric

post_impressions_organic_unique

Impressions (Organic) Unique

The number of unique people who had your Facebook content enter their screen through organic distribution.

metric

post_impressions_paid

Impressions (Paid)

The number of times your Page content was on screen, attributed to your ads.

metric

post_impressions_paid_unique

Impressions (Paid) Unique

The number of unique Accounts Center accounts that saw your post at least once, attributed to your ads.

metric

post_impressions_unique

Impressions (Unique)

The number of unique people who had your Page’s post enter their screen.

metric

post_impressions_viral

Impressions (Viral)

The number of times your Page content was on screen with social information attached, meaning a friend interacted with your Page, post or story.

metric

post_impressions_viral_unique

Impressions Viral (Unique)

The number of unique people who had your Facebook content enter their screen with social information attached.

metric

post_media_view

Impressions

The total number of times your Page’s posts or media content were displayed on someone’s screen.

metric

post_media_view:is_from_ads:0

Impressions (Organic)

The number of times your Page’s posts or media content were displayed on screen through unpaid (organic) distribution.

metric

post_media_view:is_from_ads:1

Impressions (Paid)

The number of times your Page’s posts or media content were displayed on screen through paid distribution, such as advertisements.

metric

post_media_view:is_from_followers:1

Impressions Fan

The number of times your content was played or displayed by Accounts Center accounts that followed or liked your Page.

metric

post_reactions_anger_total

Reactions: ANGER (Total)

Total ‘anger’ reactions on a post.

metric

post_reactions_haha_total

Reactions: HAHA (Total)

Total ‘haha’ reactions on a post.

metric

post_reactions_like_total

Reactions: LIKE (Total)

Total ‘like’ reactions on a post. This includes both ‘like’ and ‘care’ reactions.

metric

post_reactions_love_total

Reactions: LOVE (Total)

Total ‘love’ reactions on a post.

metric

post_reactions_sorry_total

Reactions: SORRY (Total)

Total ‘sad’ reactions on a post.

metric

post_reactions_wow_total

Reactions: WOW (Total)

Total ‘wow’ reactions on a post.

metric

post_video_avg_time_watched

Video Views Avg Time Watched

The average time, in milliseconds, people viewed your videos.

metric

post_video_complete_views_30s_autoplayed

Video Complete Views 30s (Autoplayed)

The number of times a video automatically played for at least 30 seconds, or nearly its total length if shorter.

metric

post_video_complete_views_30s_clicked_to_play

Video Complete Views 30s (Clicked to Play)

The number of times a video played for at least 30 seconds after people clicked play, or nearly its total length if shorter.

metric

post_video_complete_views_30s_organic

Video Complete Views 30s (Organic)

The number of times a video played for at least 30 seconds, or nearly its total length if shorter, through organic reach.

metric

post_video_complete_views_30s_paid

Video Complete Views 30s (Paid)

The number of times a promoted video played for at least 30 seconds, or nearly its total length if shorter.

metric

post_video_complete_views_30s_unique

Video Complete Views 30s (Unique)

The number of unique people who viewed a video for at least 30 seconds, or nearly its total length if shorter.

metric

post_video_complete_views_organic

Video Views Complete Views (Organic)

The number of times a video played from the beginning to 97% or more of its length, through organic reach.

metric

post_video_complete_views_organic_unique

Video Views Complete Views (Organic) (Unique)

The number of unique people who viewed a video from the beginning to 97% or more of its length, through organic reach.

metric

post_video_complete_views_paid

Video Views Complete Views (Paid)

The number of times a promoted video played from the beginning to 97% or more of its length.

metric

post_video_complete_views_paid_unique

Video Views Complete Views (Paid) (Unique)

The number of unique people who viewed a promoted video from the beginning to 97% or more of its length.

metric

post_video_length

Video Length

The length of a video post, in milliseconds.

metric

post_video_retention_graph

Video Views Graph

The number of times your videos played at each interval as a percentage of all views. Videos are divided into 40 equal intervals.

dimension

post_video_retention_graph_autoplayed

Video Views Graph (Autoplayed)

The number of times your videos automatically played at each interval as a percentage of all automatic views.

dimension

post_video_retention_graph_clicked_to_play

Video Views Graph Clicked To Play

The number of times your videos played at each interval as a percentage of all views, after people clicked play.

dimension

post_video_view_time

Video Views Time

The total time, in milliseconds, your videos played, including views shorter than 3 seconds and replays.

metric

post_video_view_time_by_age_bucket_and_gender

Video View Time by Age Bucket and Gender

The total time, in milliseconds, your videos played for your Top Audiences, broken down by age and gender.

dimension

post_video_view_time_by_country_id

Video View Time by Country Id

The total number of minutes your videos played for your Top 45 Locations, broken down by Country.

metric

post_video_view_time_by_region_id

Video View Time by Region Id

The total time, in milliseconds, your videos played for your Top 45 Locations, broken down by Region - Country.

dimension

post_video_view_time_organic

Video Views Time (Organic)

The total time, in milliseconds, your videos played by organic reach.

metric

post_video_views

Video Views

The number of times a video played for at least 3 seconds, or nearly its total length if shorter than 3 seconds.

metric

post_video_views_15s

Video Views 15s

The number of times your videos played for at least 15 seconds, or nearly their total length if shorter than 15 seconds.

metric

post_video_views_60s_excludes_shorter

Video Views 60s (excluding videos shorter than 60s)

The number of times your videos played for at least 60 seconds. This metric is counted only for videos that are 60 seconds or longer.

metric

post_video_views_autoplayed

Video Views (Autoplayed)

The number of times a video automatically played for at least 3 seconds, or nearly its total length if shorter.

metric

post_video_views_clicked_to_play

Video Views (Clicked to Play)

The number of times your videos played for at least 3 seconds after people clicked play, or nearly their total length if shorter.

metric

post_video_views_organic

Video Views (Organic)

The number of times a video played for at least 3 seconds, or nearly its total length if shorter, through organic reach.

metric

post_video_views_organic_unique

Video Views (Organic) (Unique)

The number of unique people who viewed a video for at least 3 seconds, or nearly its total length if shorter, through organic reach.

metric

post_video_views_paid

Video Views (Paid)

The number of times a promoted video played for at least 3 seconds, or nearly its total length if shorter.

metric

post_video_views_paid_unique

Video Views (Paid) (Unique)

The number of unique people who viewed a promoted video for at least 3 seconds, or nearly its total length if shorter.

metric

post_video_views_sound_on

Video Views Sound On

The number of times a video played with sound on for at least 3 seconds, or nearly its total length if shorter.

metric

post_video_views_unique

Video Views (Unique)

The number of unique people who viewed a video for at least 3 seconds, or nearly its total length if shorter.

metric

privacy

Privacy

The privacy settings of the content or object.

dimension

promotable_id

Promotable Id

The unique identifier for an object that can be promoted via advertising.

dimension

promotion_status

Promotion Status

The current promotion status of a post or object (e.g., ‘not_promotable’, ‘promotable’).

dimension

public_engagement

public_engagement

The total number of public engagements with your Page content, including reactions, comments, and shares.

metric

public_engagement_paid

public_engagement_paid

The total number of public engagements with your Page content that originated from paid distribution, including reactions, comments, and shares.

metric

published

Published

A boolean indicating if the content or object has been published.

dimension

publisher_platform

publisher_platform

dimension

rsvp

RSVP (Unique)

The number of unique people who RSVP’d to an event.

dimension

share

Shares

The number of times content from your Page has been shared.

metric

shared

Video View Time by Distribution Type (Shared)

Indicates that video view time is attributed to content shared by others.

dimension

shares

shares

The total number of times content from your Page has been shared.

metric

sponsored

sponsored

Indicates if the content or activity is attributed to paid or sponsored promotion.

dimension

start_date

start_date

The start date for the period during which the data was collected.

dimension

sum_reactions

sum_reactions

The total sum of all reactions received on your content.

metric

target.id

Target Id

The unique identifier for the target audience or specific entity.

dimension

target.name

Target Name

The name of the target audience or specific entity.

dimension

target.url

Target Url

The URL associated with the target entity.

dimension

targeting

Targeting

Detailed information about the audience targeting applied to a post or ad.

dimension

timestamp

timestamp

The date and time when the data point was recorded.

dimension

total_video_10s_views

Total Video 10s Views

The total number of times videos played for at least 10 seconds. This is an aggregated metric.

metric

total_video_10s_views_auto_played

Total Video 10s Views Auto Played

The total number of times videos automatically played for at least 10 seconds. This is an aggregated metric.

metric

total_video_10s_views_clicked_to_play

Total Video 10s Views Clicked To Play

The total number of times videos played for at least 10 seconds after being clicked to play. This is an aggregated metric.

metric

total_video_10s_views_organic

Total Video 10s Views Organic

The total number of times videos played for at least 10 seconds through organic reach. This is an aggregated metric.

metric

total_video_10s_views_paid

Total Video 10s Views Paid

The total number of times promoted videos played for at least 10 seconds. This is an aggregated metric.

metric

total_video_10s_views_sound_on

Total Video 10s Views Sound On

The total number of times videos played with sound on for at least 10 seconds. This is an aggregated metric.

metric

total_video_10s_views_unique

Total Video 10s Views (Unique)

The total number of unique people who viewed videos for at least 10 seconds. This is an aggregated metric.

metric

total_video_ad_break_ad_cpm

Total Video Ad Break Ad Cpm

The average amount paid by advertisers for 1,000 impressions of their ads in your videos.

dimension

total_video_ad_break_ad_impressions

Total Video Ad Break Ad Impressions

The total number of times an ad was shown during ad breaks in your videos.

dimension

total_video_ad_break_earnings

Total Video Ad Break Earnings

An estimate of the amount earned from ad breaks in your videos, based on impressions and CPM of ads shown.

dimension

total_video_avg_time_watched

Total Video Avg Time Watched

The total average time, in milliseconds, people watched videos.

metric

total_video_complete_views

Total Video Complete Views

The total number of times videos played from the beginning to 97% or more of their length.

metric

total_video_complete_views_auto_played

Total Video Complete Views Auto Played

The total number of times videos automatically played from the beginning to 97% or more of their length.

metric

total_video_complete_views_clicked_to_play

Total Video Complete Views Clicked To Play

The total number of times videos played from the beginning to 97% or more of their length after being clicked to play.

metric

total_video_complete_views_organic

Total Video Complete Views Organic

The total number of times videos played from the beginning to 97% or more of their length through organic reach.

metric

total_video_complete_views_organic_unique

Total Video Complete Views Organic (Unique)

The total number of unique people who viewed videos from the beginning to 97% or more of their length through organic reach.

metric

total_video_complete_views_paid

Total Video Complete Views Paid

The total number of times promoted videos played from the beginning to 97% or more of their length.

metric

total_video_complete_views_paid_unique

Total Video Complete Views Paid (Unique)

The total number of unique people who viewed promoted videos from the beginning to 97% or more of their length.

metric

total_video_complete_views_unique

Total Video Complete Views (Unique)

The total number of unique people who viewed videos from the beginning to 97% or more of their length.

metric

total_video_impressions

Total Video Impressions

The total number of times video content from your Page or about your Page entered a person’s screen.

metric

total_video_impressions_fan

Total Video Impressions Fan

The total number of times video content was on screen for accounts that followed or liked your Page.

metric

total_video_impressions_fan_paid

Total Video Impressions Fan Paid

metric

total_video_impressions_fan_paid_unique

Total Video Impressions Fan Paid (Unique)

metric

total_video_impressions_fan_unique

Total Video Impressions Fan (Unique)

The total number of unique accounts that followed or liked your Page and saw your video content.

metric

total_video_impressions_organic

Total Video Impressions Organic

The total number of times video content was on screen through organic distribution.

metric

total_video_impressions_organic_unique

Total Video Impressions Organic (Unique)

The total number of unique people who had organic video content enter their screen.

metric

total_video_impressions_paid

Total Video Impressions Paid

The total number of times video content was on screen, attributed to your ads.

metric

total_video_impressions_paid_unique

Total Video Impressions Paid (Unique)

The total number of unique accounts that saw your video content at least once, attributed to your ads.

metric

total_video_impressions_unique

Total Video Impressions (Unique)

The total number of unique people who had any video content from your Page or about your Page enter their screen.

metric

total_video_impressions_viral

Total Video Impressions Viral

The total number of times video content was on screen with social information attached.

metric

total_video_impressions_viral_unique

Total Video Impressions Viral (Unique)

The total number of unique people who had video content enter their screen with social information attached.

metric

total_video_reactions_by_type_total

Total Video Reactions By Type Total

The total number of reactions (like, love, wow, haha, sorry, anger) to your videos, broken down by reaction type.

dimension

total_video_retention_graph

Total Video Retention Graph

The number of times your videos played at each interval as a percentage of all views.

metric

total_video_retention_graph_autoplayed

Total Video Retention Graph Autoplayed

The number of times your videos automatically played at each interval as a percentage of all automatic views.

metric

total_video_retention_graph_clicked_to_play

Total Video Retention Graph Clicked To Play

The number of times your videos played at each interval as a percentage of all views, after people clicked play.

metric

total_video_stories_by_action_type

Total Video Stories By Action Type

The total number of stories created about your videos, broken down by action type (e.g., checkin, mention, share).

dimension

total_video_view_time_by_age_bucket_and_gender

Total Video View Time By Age Bucket And Gender

The total time, in milliseconds, videos played for audiences, broken down by age and gender. This is an aggregated metric.

metric

total_video_view_time_by_distribution_type

Total Video View Time By Distribution Type

The total time, in milliseconds, your videos played, broken down by distribution type (e.g., page-owned or shared).

metric

total_video_view_time_by_region_id

Total Video View Time By Region Id

The total time, in milliseconds, your videos played for your top 45 locations, broken down by region or country ID.

dimension

total_video_view_total_time

Total Video View Total Time

The total time, in milliseconds, videos were viewed.

metric

total_video_view_total_time_organic

Total Video View Total Time Organic

The total time, in milliseconds, organic videos were viewed.

metric

total_video_view_total_time_paid

Total Video View Total Time Paid

metric

total_video_views

Total Video Views

The total number of times videos played for at least 3 seconds, or nearly their total length if shorter.

metric

total_video_views_autoplayed

Total Video Views Autoplayed

The total number of times videos automatically played for at least 3 seconds, or nearly their total length if shorter.

metric

total_video_views_by_distribution_type

Total Video Views By Distribution Type

The number of times your videos played, broken down by distribution type (e.g., page-owned or shared).

dimension

total_video_views_clicked_to_play

Total Video Views Clicked To Play

The total number of times videos played for at least 3 seconds after being clicked to play.

metric

total_video_views_organic

Total Video Views Organic

The total number of times videos played for at least 3 seconds through organic reach.

metric

total_video_views_organic_unique

Total Video Views Organic (Unique)

The total number of unique people who viewed videos for at least 3 seconds through organic reach.

metric

total_video_views_paid

Total Video Views Paid

The total number of times promoted videos played for at least 3 seconds.

metric

total_video_views_paid_unique

Total Video Views Paid (Unique)

The total number of unique people who viewed promoted videos for at least 3 seconds.

metric

total_video_views_sound_on

Total Video Views Sound On

The total number of times videos played with sound on for at least 3 seconds.

metric

total_video_views_unique

Total Video Views (Unique)

The total number of unique people who viewed videos for at least 3 seconds.

metric

type

Type

The type of the Facebook object or content (e.g., ‘photo’, ‘video’, ‘link’, ‘status’).

dimension

updated_time

Updated time

The date and time when the content or object was last updated.

dimension

video play

Video Plays

The number of times a video was played.

dimension

video_plays

video_plays

The number of times your videos played for at least 3 seconds, or for nearly their total length if they’re shorter than 3 seconds.

dimension

watchtime

watchtime

The total time, in milliseconds, that your videos were viewed.

dimension

year

year

The year of the data point.

metric