Facebook Public Page: Most-used fields

Facebook Public Page: Most-used fields#

The table below gives information about most-used fields that you can import from Facebook Public Page. 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

application

application

Information about the application used to publish the post. This is equivalent to ‘post.application’.

dimension

caption

caption

The caption associated with a link included in the post. This is equivalent to ‘post.caption’.

dimension

checkins

checkins

Number of check-ins recorded at the Page’s location. This is equivalent to ‘page.checkins’.

dimension

comments

comments

A summary or count of comments on a post. This is equivalent to ‘post.comments’.

metric

country_page_likes

country_page_likes

Likes for a specific country Page within a global brand. This is equivalent to ‘page.country_page_likes’.

dimension

created_date

created_date

The calendar date when the post was created. This is equivalent to ‘post.created_date’.

dimension

created_time

created_time

The exact time when the post was created. This is equivalent to ‘post.created_time’.

dimension

date

date

A generic date field, typically indicating the creation date of an entity such as a post or comment.

dimension

description

description

A descriptive text for a link or attached content within the post. This is equivalent to ‘post.description’.

dimension

fan_count

fan_count

The total number of users who have liked the Facebook Page. This is equivalent to ‘page.fan_count’.

dimension

from

from

The identifier of the user or page that published the post. This is equivalent to ‘post.from’.

dimension

global_brand_page_name

global_brand_page_name

The name of the Page within a global brand structure. This is equivalent to ‘page.global_brand_page_name’.

dimension

global_brand_root_id

global_brand_root_id

The global root ID for a brand’s pages. This is equivalent to ‘page.global_brand_root_id’.

dimension

icon

icon

A URL to an icon representing the post’s type. This is equivalent to ‘post.icon’.

dimension

id

id

A unique identifier for an entity, which could be a page, post, or comment.

dimension

likes

likes

The total count of ‘like’ reactions on a post. This is equivalent to ‘post.likes’.

metric

link

link

The URL of an external link shared in the post. This is equivalent to ‘post.link’.

dimension

message

message

The main text content of the post. This is equivalent to ‘post.message’.

dimension

name

name

The name of the Facebook Page or the name of a link within a post.

dimension

new_like_count

new_like_count

The number of new likes for a Page since the last login. This is equivalent to ‘page.new_like_count’.

dimension

object_id

object_id

The ID of an attached photo or video in a post. This is equivalent to ‘post.object_id’.

dimension

overall_star_rating

overall_star_rating

The overall star rating of a Facebook Page. This is equivalent to ‘page.overall_star_rating’.

dimension

page

page

Represents the Facebook Page entity from which data is collected, including various page-level metrics.

dimension

page.checkins

page.checkins

Number of check-ins recorded at the physical location represented by the Facebook Page.

metric

page.country_page_likes

page.country_page_likes

If the Page is part of a Global Pages hierarchy, this is the number of people directed to this specific country Page.

dimension

page.fan_count

page.fan_count

The total number of users who have liked the Facebook Page. For Global Pages, this is the aggregated count across all Pages in the brand hierarchy. For New Page Experience Pages, this value represents the followers_count.

metric

page.global_brand_page_name

page.global_brand_page_name

The name of the Page, including country codes appended for Pages within a Global Pages hierarchy. This field is typically visible only to the Page admin.

dimension

page.global_brand_root_id

page.global_brand_root_id

The unique identifier for the root Page in a Global Pages brand hierarchy.

dimension

page.id

page.id

The unique identifier for the Facebook Page.

metric

page.name

page.name

The official name of the Facebook Page.

dimension

page.new_like_count

page.new_like_count

The number of new likes the Page has received since the last login by a Page admin. This field is only visible to a Page admin.

dimension

page.overall_star_rating

page.overall_star_rating

The Page’s overall star rating, derived from user surveys on a scale of 1-5. This is a normalized value and may not be a direct average of all user ratings.

dimension

page.rating_count

page.rating_count

The total number of publicly accessible ratings submitted for the Page.

dimension

page.talking_about_count

page.talking_about_count

The number of unique users who are talking about the Page, reflecting engagement like mentions, comments, and shares.

metric

page.username

page.username

The custom alias or vanity URL for the Page, e.g., ‘platform’ for facebook.com/platform.

dimension

page.were_here_count

page.were_here_count

The number of times users have indicated they were at the Page’s physical location.

metric

parent_id

parent_id

The ID of a parent post if the current post is a reply or related to another. This is equivalent to ‘post.parent_id’.

dimension

permalink_url

permalink_url

The permanent URL to the post on Facebook. This is equivalent to ‘post.permalink_url’.

dimension

picture

picture

The main image or thumbnail associated with the post. This is equivalent to ‘post.picture’.

dimension

place

place

The place or location associated with the post. This is equivalent to ‘post.place’.

dimension

post.angry

post.angry

The total count of ‘Angry’ reactions on the post. This is equivalent to ‘post.reactions_angry’.

metric

post.application

post.application

Information about the application used to publish the post.

dimension

post.caption

post.caption

The caption associated with a link included in the post, typically displayed beneath the link’s name.

dimension

post.comment_comment_count

post.comment_comment_count

The total number of replies (sub-comments) to a specific comment on the post.

metric

post.comment_id

post.comment_id

The unique identifier for a specific comment on the post.

dimension

post.comment_like_count

post.comment_like_count

The total number of likes received by a specific comment on the post.

dimension

post.comment_message

post.comment_message

The text content of a specific comment made on the post.

dimension

post.comments

post.comments

Details about comments made on the post, including text and other attributes.

metric

post.created_date

post.created_date

The calendar date when the post was originally published.

dimension

post.created_time

post.created_time

The exact time (as a UNIX timestamp) when the post was originally published.

dimension

post.description

post.description

A descriptive text for a link or attached content within the post.

dimension

post.from

post.from

The identifier of the user, page, group, or event that created and published the post.

dimension

post.haha

post.haha

The total count of ‘Haha’ reactions on the post. This is equivalent to ‘post.reactions_haha’.

metric

post.icon

post.icon

A URL to an icon that visually represents the type or nature of the post.

dimension

post.id

post.id

The unique identifier for the post.

dimension

post.likes

post.likes

A summary of the ‘like’ reactions on the post.

metric

post.link

post.link

The URL of any external link included in the post.

dimension

post.love

post.love

The total count of ‘Love’ reactions on the post. This is equivalent to ‘post.reactions_love’.

metric

post.message

post.message

The primary text content or message written by the publisher of the post.

dimension

post.object_id

post.object_id

The ID of any photo or video attachment associated with the post.

dimension

post.parent_id

post.parent_id

The identifier of a parent post if the current post is a reply or otherwise related to another post.

dimension

post.permalink_url

post.permalink_url

The permanent and static URL that directs users to the post on www.facebook.com.

dimension

post.picture

post.picture

The URL of the main image or thumbnail associated with the post.

dimension

post.place

post.place

The identifier of the physical place or location associated with the post.

dimension

post.promotable_id

post.promotable_id

The ID of the post designated for promotion, especially for stories that cannot be promoted directly.

dimension

post.reactions_angry

post.reactions_angry

The total count of ‘Angry’ reactions on the post.

metric

post.reactions_haha

post.reactions_haha

The total count of ‘Haha’ reactions on the post.

metric

post.reactions_love

post.reactions_love

The total count of ‘Love’ reactions on the post.

metric

post.reactions_sad

post.reactions_sad

The total count of ‘Sad’ reactions on the post.

metric

post.reactions_thankful

post.reactions_thankful

The total count of ‘Thankful’ reactions on the post.

metric

post.reactions_wow

post.reactions_wow

The total count of ‘Wow’ reactions on the post.

metric

post.sad

post.sad

The total count of ‘Sad’ reactions on the post. This is equivalent to ‘post.reactions_sad’.

metric

post.shares

post.shares

The total number of times the post has been shared by users.

metric

post.source

post.source

The URL to any Flash movie or video file attached to the post.

dimension

post.status_type

post.status_type

A categorical description of the type of status update represented by the post (e.g., mobile_status_update, shared_story).

dimension

post.story

post.story

Automatically generated text for stories not directly created by users, such as friendship announcements.

dimension

post.story_tags

post.story_tags

A list of tags, such as mentions of users or pages, present within the post’s story text.

dimension

post.to

post.to

A list of profiles (users or pages) that were mentioned or specifically targeted in the post.

dimension

post.type

post.type

A string indicating the object type of the post (e.g., photo, video, link, status).

dimension

post.with_tags

post.with_tags

Indicates if the post contains tags or mentions of other profiles or pages.

dimension

post.wow

post.wow

The total count of ‘Wow’ reactions on the post. This is equivalent to ‘post.reactions_wow’.

metric

post_id

post_id

The unique identifier for a Facebook post. This is equivalent to ‘post.id’.

dimension

rating_count

rating_count

The total number of publicly accessible ratings for a Facebook Page. This is equivalent to ‘page.rating_count’.

dimension

shares

shares

The total number of times a post has been shared. This is equivalent to ‘post.shares’.

metric

source

source

The URL to any Flash movie or video file attached to the post. This is equivalent to ‘post.source’.

dimension

status_type

status_type

A categorical description of the type of status update for a post. This is equivalent to ‘post.status_type’.

dimension

story

story

Automatically generated text for stories not directly created by users. This is equivalent to ‘post.story’.

dimension

story_tags

story_tags

A list of tags within the post’s story text. This is equivalent to ‘post.story_tags’.

dimension

talking_about_count

talking_about_count

The number of unique users talking about the Page. This is equivalent to ‘page.talking_about_count’.

dimension

timestamp

timestamp

A generic timestamp field, likely representing the creation or last update time of an object.

dimension

timestamp_report_created

timestamp_report_created

The time the report was created.

dimension

to

to

A list of profiles mentioned or targeted in a post. This is equivalent to ‘post.to’.

dimension

type

type

A string indicating the object type of a page or post.

dimension

username

username

The custom alias or vanity URL for the Page. This is equivalent to ‘page.username’.

dimension

were_here_count

were_here_count

The number of visits to the Page’s physical location. This is equivalent to ‘page.were_here_count’.

dimension

with_tags

with_tags

Indicates if content, such as a post or story, includes tags or mentions of other entities.

dimension