Phiên bản API Đồ thị
Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 11 tháng 9
Đã cập nhật bằng Tiếng Việt: 26 tháng 10, 2018

Page Insights

Represents insights for Facebook Pages and Page posts. Refer to our Pages API documentation.

On March 14, 2024, a number of the Page Insights metrics were deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics. Read our blog to learn more.

Đọc

Get metrics for Pages or Page posts.

New Page Experience

This endpoint is supported for New Page Experience.

Limitations

  • Page Insights data is only available on Pages with 100 or more likes.
  • Most metrics will update once every 24 hours.
  • Only the last two years of insights data is available.
  • The values for period are calculated from the initial collection of the data point.
  • "Period" in the tables below only refers to the time frame for which the metric can be accessed in an aggregated form.
  • The value "lifetime" means the time period for which the insights data is available. By default, this time period is 2 years or shorter.
  • Only 90 days of insights can be viewed at one time when using the since and until parameters.
  • When using since and until, the since date data will be included in the first value returned.
  • Unique impression insights values are calculated independently.
    • Total page reach may not always be exactly equal to the sum of paid and non-paid unique values.
    • Total page reach may not always be exactly equal to the sum of viral_unique and organic_unique.
  • When an organic post is boosted, metrics for paid post impressions will include both organic and paid reach.
  • Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
  • Breakdown metrics for Page post and Page view insights will only return non-zero values.
  • Several video related metrics only return accurate values if the person requesting the metric is the Page video post creator.
  • If you reshare a video post of another Page and retrieve its insights, the metrics return a value of 0. Metrics that return 0 for resharers are denoted with "Returns 0 for reshared videos" in their description.
  • If you neglect to indicate a specific metric or metrics for the endpoint, you will receive an error response with code 3001, with subcode 1504028 and an error message that states: "No metric was specified to be fetched. Please specify one or more metrics to be fetched and try again."
  • Interactions on Reels are not included.

Requirements

TypeDescription

Access Tokens

A Page access token requested by a person who can perform the ANALYZE task on the Page.

Features

Not applicable.

Permissions

read_insights, pages_read_engagement

Page Tasks

ANALYZE

Example

Single Metric Sample Request

Graph API Explorer
GET v21.0/{object-id}/insights/{metric} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights/{metric}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "{object-id}/insights/{metric}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights/{metric}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights/{metric}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Nếu bạn muốn tìm hiểu cách sử dụng API Đồ thị, hãy đọc Hướng dẫn sử dụng API Đồ thị của chúng tôi.

Multiple Metric Sample Request

NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.

Graph API Explorer
GET v21.0/{object-id}/insights?metric={metric-1},{metric-2},{metric-3},... HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},..."
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Nếu bạn muốn tìm hiểu cách sử dụng API Đồ thị, hãy đọc Hướng dẫn sử dụng API Đồ thị của chúng tôi.

Metrics

Metric names indicate whether a metric is for a Page or a Page post.

SuffixDescription

_unique

Indicates that the metric shows the number of unique users who performed a specific action, for example page_impressions_unique. Metrics generated with the _unique suffix are approximate and may not be 100% accurate.

_login

Indicates whether a person was logged into Facebook, for example, page_tab_views_login_top.

_logout

Indicates whether a person is logged out of Facebook, for example page_views_logout.

_source

Indicates that the metric will be broken down into a list of referral sources, for example page_fans_by_like_source. External referrals are broken down by domain. Internal referrals are broken down by Facebook-specific features such as Profile, Search, Requests, Suggestions, Stream, etc. In these cases the value returned will be an object containing a series of key-value pairs where the key is the source name and the value is the metric for that source.

*

Indicates that a metric is refreshed several times during the day, for example page_impressions_unique*.

Page Content

Most of the metrics below can be retrieved using post_activity_by_action_type, post_clicks_by_type, and page_consumptions_by_consumption_type.

Metric Name Description Values for `period`
page_tab_views_login_top_unique

Số người dùng đã đăng nhập Facebook và xem tab trên Trang của bạn. (See possible types)

day, week

page_tab_views_login_top

Số lần người dùng đăng nhập Facebook xem các tab trên Trang của bạn. (See possible types)

day, week

page_tab_views_logout_top

Số lần người dùng (không đăng nhập Facebook) đã xem tab trên Trang của bạn. (See possible types)

day

Tab Types

Tab types for Page content metrics.

Name Description
allactivity

Administrative tab

app

Custom created tab

info

About tab view

insights

Insights tab

likes

Likes tab

locations

Map tab

photos

Photos tab

photos_albums

Photos tab

photos_stream

Photos tab

profile

Pages timeline

profile_info

Info tab

profile_likes

Likes tab

profile_photos

Photos tab

timeline

Pages timeline

events

Events tab

videos

Videos tab

wall

Timeline

Page CTA Clicks

Metric Name Description Values for `period`
page_total_actions

Số lượt click vào nút kêu gọi hành động và thông tin liên hệ của Trang.

day, week, days_28

Page Engagement

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
page_post_engagements*

Lượt tương tác với bài viết của bạn bằng cách bày tỏ cảm xúc, bình luận, chia sẻ, v.v.

day, week, days_28

page_fan_adds_by_paid_non_paid_unique

Số tài khoản trong Trung tâm tài khoản thích Trang của bạn lần đầu tiên, chia nhỏ dựa trên việc liệu lượt thích Trang đó có được là nhờ nội dung trả phí hay tự nhiên. Đây là số liệu ước tính.

day

page_lifetime_engaged_followers_unique*

Người theo dõi Trang của bạn, cùng những người mà trong 14 ngày qua đã xem một hoặc nhiều video trực tiếp/đã ghi hình của bạn trong tối thiểu 1 phút và/hoặc tương tác với nội dung video ít nhất một lần, bằng cách bình luận, chia sẻ, bày tỏ cảm xúc hoặc thích.

page_daily_follows*

Số lần trang cá nhân hoặc Trang Facebook của bạn được theo dõi trong khoảng thời gian đã chọn.

day

page_daily_follows_unique*

Số tài khoản trong Trung tâm tài khoản đã theo dõi Trang của bạn trong khoảng thời gian đã chọn. Đây là số liệu ước tính.

day, week, days_28

page_daily_unfollows_unique*

Số tài khoản trong Trung tâm tài khoản đã bỏ theo dõi Trang của bạn trong khoảng thời gian đã chọn. Đây là số liệu ước tính.

day, week, days_28

page_follows*

Số người theo dõi trang cá nhân hoặc Trang Facebook của bạn. Số liệu này được tính bằng cách lấy số lượt theo dõi trừ đi số lượt bỏ theo dõi trong suốt thời gian từ khi bạn tạo trang cá nhân hoặc Trang Facebook cho đến nay.

day

Page Impressions

Metric Name Description Values for `period`
page_impressions*

Số lần nội dung bất kỳ từ/về Trang của bạn hiển thị trên màn hình của một người. Đó có thể là bài viết, tin, quảng cáo hoặc nội dung/thông tin khác trên Trang của bạn.

day, week, days_28

page_impressions_unique*

Số người nhìn thấy bất kỳ nội dung nào thuộc về hoặc nói về Trang của bạn trên màn hình của họ. Nội dung này bao gồm bài viết, lượt check in, quảng cáo, thông tin xã hội của những người tương tác với Trang của bạn, v.v. Đây là số liệu ước tính.

day, week, days_28

page_impressions_paid*

Số lần bài viết hoặc tin bất kỳ từ/về Trang của bạn hiển thị trên màn hình của một người thông qua hình thức phân phối trả phí, chẳng hạn như quảng cáo.

day, week, days_28

page_impressions_paid_unique*

Số tài khoản trong Trung tâm tài khoản đã nhìn thấy quảng cáo của bạn ít nhất một lần. Số người tiếp cận khác với lượt hiển thị ở chỗ lượt hiển thị có thể bao gồm nhiều lượt xem quảng cáo của cùng một tài khoản trong Trung tâm tài khoản. Đây là số liệu ước tính.

day, week, days_28

page_impressions_viral*

Số lần nội dung bất kỳ từ/về Trang của bạn hiển thị trên màn hình của một người kèm theo thông tin xã hội. Loại thông tin này hiển thị thời điểm bạn bè của một người tương tác với Trang, bài viết hoặc tin của bạn. Thông tin này bao gồm thời điểm bạn bè của người nào đó thích hoặc theo dõi Trang, tương tác với bài viết, chia sẻ ảnh của Trang và check in trên Trang của bạn. Đây là số liệu đang phát triển.

day, week, days_28

page_impressions_viral_unique*

Số liệu này tính số người tiếp cận được nhờ hoạt động phân phối Trang Facebook và nội dung Trang của bạn theo hình thức tự nhiên hoặc trả phí, khi Trang và nội dung Trang hiển thị kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Số người tiếp cận chỉ được tính một lần nếu diễn ra ở cả hoạt động phân phối tự nhiên lẫn trả phí. Đây là số liệu ước tínhđang phát triển.

day, week, days_28

page_impressions_nonviral*

Số lần Trang Facebook và nội dung Trang của bạn hiển thị trên màn hình, trừ trường hợp kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Đây là số liệu đang phát triển.

day, week, days_28

page_impressions_nonviral_unique*

Số liệu này tính số người tiếp cận được nhờ hoạt động phân phối Trang Facebook và nội dung Trang của bạn theo hình thức tự nhiên hoặc trả phí, trừ trường hợp Trang và nội dung Trang hiển thị kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Số người tiếp cận chỉ được tính một lần nếu diễn ra ở cả hoạt động phân phối tự nhiên lẫn trả phí. Đây là số liệu ước tínhđang phát triển.

day, week, days_28

Page Posts

Metric Name Description Values for `period`
page_posts_impressions*

Số lần bài viết từ Trang của bạn hiển thị trên màn hình của một người. Bài viết bao gồm trạng thái, ảnh, liên kết, video, v.v.

day, week, days_28

page_posts_impressions_unique*

Số người nhìn thấy bất kỳ bài viết nào từ Trang của bạn trên màn hình của họ. Bài viết bao gồm trạng thái, ảnh, liên kết, video, v.v.

day, week, days_28

page_posts_impressions_paid*

Số lần Trang Facebook và nội dung Trang của bạn hiển thị trên màn hình, được ghi nhận cho quảng cáo của bạn.

day, week, days_28

page_posts_impressions_paid_unique*

Số tài khoản trong Trung tâm tài khoản đã nhìn thấy bài viết bất kỳ trên Trang của bạn ít nhất một lần, được ghi nhận cho quảng cáo bạn chạy.

day, week, days_28

page_posts_impressions_organic_unique*

Số người nhìn thấy bất kỳ bài viết nào từ Trang của bạn trên màn hình của họ thông qua phân phối không trả phí.

day, week, days_28

page_posts_served_impressions_organic_unique

Số người được phân phối bài viết của Trang trong Bảng feed của họ cho dù bài viết đó có hiển thị trên màn hình của họ hay không. Bài viết bao gồm trạng thái, ảnh, liên kết, video, v.v.

day, week, days_28

page_posts_impressions_viral*

Số lần bài viết từ Trang của bạn hiển thị trên màn hình của một người có kèm thông tin xã hội. Thông tin xã hội hiển thị thời điểm bạn bè của một người tương tác với Trang hoặc bài viết của bạn. Thông tin này bao gồm thời điểm bạn bè của ai đó thích hoặc theo dõi Trang, tương tác với bài viết, chia sẻ ảnh của Trang và truy cập Trang.

day, week, days_28

page_posts_impressions_viral_unique*

Số người hiển thị bất kỳ bài viết nào từ Trang của bạn trên màn hình của họ có kèm thông tin xã hội. Là một dạng phân phối tự nhiên, thông tin xã hội hiển thị thời điểm bạn bè của một người tương tác với Trang hoặc bài viết của bạn. Thông tin này bao gồm thời điểm bạn bè của ai đó thích hoặc theo dõi Trang, tương tác với bài viết, chia sẻ ảnh của Trang và truy cập Trang.

day, week, days_28

page_posts_impressions_nonviral*

Số lần bài viết từ Trang của bạn hiển thị trên màn hình của một người. Phần hiển thị này không bao gồm nội dung về Trang của bạn có kèm thông tin xã hội. Thông tin xã hội hiển thị khi bạn bè của một người tương tác với Trang hoặc bài viết của bạn. Thông tin này bao gồm thời điểm bạn bè của ai đó thích hoặc theo dõi Trang, tương tác với bài viết, chia sẻ ảnh của Trang và truy cập Trang.

day, week, days_28

page_posts_impressions_nonviral_unique*

Số người hiển thị bất kỳ bài viết nào từ Trang của bạn trên màn hình của họ. Nội dung này không bao gồm nội dung về Trang của bạn có kèm thông tin xã hội. Là một dạng phân phối tự nhiên, thông tin xã hội hiển thị thời điểm bạn bè của một người tương tác với Trang hoặc bài viết của bạn. Thông tin này bao gồm thời điểm bạn bè của ai đó thích hoặc theo dõi Trang, tương tác với bài viết, chia sẻ ảnh của Trang và truy cập Trang.

day, week, days_28

Page Post Engagement

Metric Name Description Values for `period`
post_clicks*

Số lần mọi người nhấp vào vị trí bất kỳ trong các bài viết của bạn mà không tạo tin.

lifetime

post_clicks_by_type*

Số lần mọi người nhấp vào vị trí bất kỳ trong các bài viết của bạn mà không tạo tin, theo loại tiêu dùng.

lifetime

Negative Feedback Types

Negative feedback types for page_negative_feedback_by_type metrics.

Name Description
hide_clicks

Hide this story

hide_all_clicks

Hide all posts from this page

report_spam_clicks

Report an object as a spam

unlike_page_clicks

Unlike a page

Page Post Impressions

Metric Name Description Values for `period`
post_impressions*

Số lần bài viết từ Trang của bạn hiển thị trên màn hình của một người. Bài viết bao gồm trạng thái, ảnh, liên kết, video, v.v.

lifetime

post_impressions_unique*

Số người hiển thị bài viết từ Trang của bạn trên màn hình của họ. Bài viết bao gồm trạng thái, ảnh, liên kết, video, v.v. Đây là số liệu ước tính.

lifetime

post_impressions_paid*

Số lần nội dung Trang của bạn hiển thị trên màn hình, được ghi nhận cho quảng cáo của bạn.

lifetime

post_impressions_paid_unique*

Số tài khoản trong Trung tâm tài khoản đã nhìn thấy bài viết bất kỳ của bạn ít nhất một lần, được ghi nhận cho quảng cáo bạn chạy. Đây là số liệu ước tính.

lifetime

post_impressions_fan*

Số lần nội dung Trang của bạn hiển thị trên màn hình cho những tài khoản đã theo dõi hoặc thích Trang đó.

lifetime

post_impressions_fan_unique*

Số tài khoản trong Trung tâm tài khoản đã theo dõi hoặc thích Trang của bạn. Đây là số liệu ước tính.

lifetime

post_impressions_organic*

Số lần bài viết của bạn hiển thị trên màn hình thông qua hoạt động phân phối tự nhiên.

lifetime

post_impressions_organic_unique*

Số liệu này tính số người tiếp cận thu hút được nhờ cách phân bổ tự nhiên nội dung của bạn trên Facebook, bao gồm bài viết, tin và quảng cáo. Số người tiếp cận thu hút được từ lượt chia sẻ chỉ ghi nhận cho nội dung tự nhiên. Cách tính này bao gồm cả những trường hợp nội dung của bạn được chia sẻ dưới dạng tin hoặc bài đăng lại. Đây là số liệu ước tính.

lifetime

post_impressions_viral*

Số lần nội dung Trang của bạn hiển thị trên màn hình kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Đây là số liệu đang phát triển.

lifetime

post_impressions_viral_unique*

Số liệu này tính số người tiếp cận khi nội dung của bạn trên Facebook được chia sẻ dưới dạng nội dung đăng lại hoặc tin. Số người tiếp cận từ nội dung chia sẻ chỉ tính vào mức phân bổ tự nhiên. Đây là số liệu ước tínhđang phát triển.

lifetime

post_impressions_nonviral*

Số lần nội dung Trang của bạn hiển thị trên màn hình, trừ trường hợp kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Đây là số liệu đang phát triển.

lifetime

post_impressions_nonviral_unique*

Số liệu này tính số người tiếp cận được nhờ hoạt động phân phối nội dung Trang của bạn theo hình thức tự nhiên hoặc trả phí, trừ trường hợp nội dung hiển thị kèm theo thông tin xã hội. Loại thông tin này hiển thị trên Bảng feed sau khi có người tương tác với Trang, bài viết hoặc tin của bạn. Số người tiếp cận chỉ được tính một lần nếu diễn ra ở cả hoạt động phân phối tự nhiên lẫn trả phí. Đây là số liệu ước tínhđang phát triển.

lifetime

Page Post Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
post_reactions_like_total

Tổng số lượt bày tỏ cảm xúc "thích" của một bài viết.

lifetime

post_reactions_love_total

Tổng số lượt bày tỏ cảm xúc "yêu thích" của một bài viết.

lifetime

post_reactions_wow_total

Tổng số lượt bày tỏ cảm xúc "wow" của một bài viết.

lifetime

post_reactions_haha_total

Tổng số lượt bày tỏ cảm xúc "haha" của một bài viết.

lifetime

post_reactions_sorry_total

Tổng số lượt bày tỏ cảm xúc "buồn" của một bài viết.

lifetime

post_reactions_anger_total

Tổng số lượt bày tỏ cảm xúc "phẫn nộ" của một bài viết.

lifetime

post_reactions_by_type_total

Tổng số lượt bày tỏ cảm xúc về bài viết theo loại.

lifetime

Page Reactions

The "like" reaction counts include both "like" and "care" reactions.

Metric Name Description Values for `period`
page_actions_post_reactions_like_total*

Hàng ngày: Tổng số lượt bày tỏ cảm xúc là "thích" của một trang.

day, week, days_28

page_actions_post_reactions_love_total*

Hàng ngày: tổng số lượt bày tỏ cảm xúc là "yêu thích" của một trang.

day, week, days_28

page_actions_post_reactions_wow_total*

Hàng ngày: tổng số lượt bày tỏ cảm xúc là "wow" của một trang.

day, week, days_28

page_actions_post_reactions_haha_total*

Tổng số cảm xúc là "haha" của một trang (hàng ngày).

day, week, days_28

page_actions_post_reactions_sorry_total*

Tổng số lượt bày tỏ cảm xúc "rất tiếc" của một trang mỗi ngày.

day, week, days_28

page_actions_post_reactions_anger_total*

Tổng số lượt bày tỏ cảm xúc "phẫn nộ" của một trang mỗi ngày.

day, week, days_28

page_actions_post_reactions_total

Tổng số lượt bày tỏ cảm xúc về bài viết của một trang mỗi ngày, chia theo loại.

day

Page User Demographics

Metric Name Description Values for `period`
page_fans

Tổng số người đã thích Trang của bạn.

day

page_fans_locale

Dữ liệu ngôn ngữ tổng hợp về những người thích Trang của bạn dựa trên thiết lập ngôn ngữ mặc định đã chọn khi truy cập Facebook.

day

page_fans_city

Dữ liệu vị trí tổng hợp của Facebook về những người thích Trang của bạn, sắp xếp theo tỉnh/thành phố.

day

page_fans_country

Số người thích Trang của bạn, tổng hợp theo từng quốc gia. Chỉ tính 45 quốc gia có nhiều người thích Trang của bạn nhất.

day

page_fan_adds

Số người mới đã thích Trang của bạn.

day

page_fan_adds_unique

Số tài khoản trong Trung tâm tài khoản đã thích Trang của bạn lần đầu tiên. Đây là số liệu ước tính.

day, week, days_28

page_fan_removes

Số lượt bỏ thích Trang của bạn.

day

page_fan_removes_unique*

Số lượt bỏ thích Trang của bạn.

day, week, days_28

Page Like Sources

Source types for page_fans_by_like_source and page_fans_by_like_source_unique metrics.

Name Description
Ads

Page likes that came from people who saw your Page or post in an ad.

News Feed

Page likes that came from people who saw content posted by your Page or about your Page in News Feed.

Page Suggestions

Page likes that came from people saw your Page in a list of suggested Pages.

Restored Likes from Reactivated Accounts

Page likes that came from people who reactivated their Facebook profile.

Search

Page likes that came from people who saw you Page or post in search.

Your Page

Page likes that came from people who visited your Page.

Page Video Views

Metric Name Description Values for `period`
page_video_views

Số lượt phát video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_by_uploaded_hosted*

Lượt xem video hàng ngày ở cấp độ trang được chia nhỏ theo tất cả phiên bản được tải lên hoặc lưu trữ trên trang.

day, week, days_28

page_video_views_paid

Số lượt phát video quảng cáo của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại.

day, week, days_28

page_video_views_organic

Số lượt phát video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây, tính theo số người xem tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_by_paid_non_paid*

Số lượt phát video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây, chia theo tổng số, trả phí và không trả phí. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_autoplayed

Số lượt tự động phát video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_click_to_play

Số lượt phát video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_unique

Số người xem video của Trang trong tối thiểu 3 giây hoặc xem gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_repeat_views

Số lượt phát lại video của Trang trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây.

day, week, days_28

page_video_complete_views_30s

Lượt phát video của Trang trong tối thiểu 30 giây hoặc gần hết tổng thời lượng nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_paid

Số lượt phát video quảng cáo của Trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_organic

Số lượt phát video của Trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây, tính theo số người xem tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_autoplayed

Số lượt tự động phát video của Trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_click_to_play

Số lượt phát video của Trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_unique

Số người đã xem video của Trang trong tối thiểu 30 giây hoặc xem gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_complete_views_30s_repeat_views

Số lượt phát lại video của Trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây.

day, week, days_28

post_video_complete_views_30s_autoplayed

Số lượt phát video tự động trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Trả về 0 đối với các video được chia sẻ lại.

lifetime

post_video_complete_views_30s_clicked_to_play

Số lượt phát video trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_30s_organic

Số lượt phát video trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây, tính theo số người xem tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Trả về 0 đối với các video được chia sẻ lại.

lifetime

post_video_complete_views_30s_paid

Số lượt phát video quảng cáo của trang trong tối thiểu 30 giây hoặc phát gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_30s_unique

Số người xem video trong tối thiểu 30 giây hoặc xem gần hết nếu video ngắn hơn 30 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

page_video_views_10s

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video trên Trang của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_paid

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video quảng cáo trên Trang của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem video và không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_organic

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video trên Trang của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây, tính theo số người tiếp cận tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_autoplayed

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt tự động phát video trên Trang của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_click_to_play

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video trên Trang của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_unique

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số người xem video trên Trang của bạn trong tối thiểu 10 giây hoặc xem gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, week, days_28

page_video_views_10s_repeat

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát lại video trên Trang của bạn trong tối thiểu 10 giây hoặc phát lại gần hết nếu video ngắn hơn 10 giây.

day, week, days_28

page_video_view_time

Tổng thời gian (tính bằng mili giây) mà mọi người xem video của Trang.

day

page_uploaded_3s_to_15s_views_rate*

Tỷ lệ xem video từ 3 - 15 giây. Số liệu này được đo lường trên tất cả tài sản video đã tải lên, bao gồm mọi hoạt động trên bài viết/bài viết đăng chéo hoặc nội dung chia sẻ của các bài viết đó.

page_uploaded_views_15s_count*

Tổng số lượt xem video của những người đã xem ít nhất 15 giây video trên Trang của bạn.

page_uploaded_views_60s_excludes_shorter_unique_count_by_is_60s_returning_viewer*

Daily video 60-second unique views on a page for uploaded videos by 60-second returning viewers. This metric counts only for videos that are 60 seconds or longer. 60-second returning viewers are the users who had 60-second view last week and a 60-second view this week.

Page Views

Metric Name Description Values for `period`
page_views_total*

Số lượt xem Trang từ những người đã đăng nhập và đăng xuất.

day, week, days_28

Page Video Posts

Metric Name Description Values for `period`
post_video_avg_time_watched

Thời gian trung bình (tính bằng mili giây) mà mọi người xem video của bạn. Chỉ hiển thị với video được tạo sau ngày 25/8/2016. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_organic

Số lần video của bạn được phát từ đầu đến ít nhất 97% thời lượng, tính theo số người tiếp cận tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_organic_unique

Số người đã xem video của bạn từ đầu đến ít nhất 97% thời lượng, tính theo số người tiếp cận tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_paid

Số lần video quảng cáo của bạn được phát từ đầu đến ít nhất 97% thời lượng. Đối với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại. Trả về 0 đối với video được chia sẻ lại.

lifetime

post_video_complete_views_paid_unique

Số người đã xem video quảng cáo của bạn từ đầu đến ít nhất 97% thời lượng. Đối với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại.

lifetime

post_video_retention_graph*

Số lượt phát video tại từng quãng, biểu thị bằng tỷ lệ phần trăm trên tổng số lượt xem. Video được chia thành 40 quãng bằng nhau. Số liệu này không tính lượt hiển thị trong khi video phát trực tiếp. Đồ thị về tỷ lệ giữ chân có thể cho thấy đoạn sau của video có nhiều lượt hiển thị hơn so với đoạn đầu. Mọi người có thể bắt đầu từ giữa video, tua nhanh, lưu và xem lại video từ điểm đó hoặc làm những việc tương tự.

lifetime

post_video_retention_graph_clicked_to_play

Số lượt phát video tại từng quãng, biểu thị bằng tỷ lệ phần trăm trên tổng số lượt xem, tính từ thời điểm mọi người nhấp vào nút phát. Video được chia thành 40 quãng bằng nhau. Số liệu này không tính lượt hiển thị trong khi video phát trực tiếp. Đồ thị về tỷ lệ giữ chân có thể cho thấy đoạn sau của video có nhiều lượt hiển thị hơn so với đoạn đầu. Mọi người có thể bắt đầu từ giữa video, tua nhanh, lưu và xem lại video từ điểm đó hoặc làm những việc tương tự.

lifetime

post_video_retention_graph_autoplayed

Số lượt tự động phát video tại từng quãng, biểu thị bằng tỷ lệ phần trăm trên tổng số lượt xem tự động. Video được chia thành 40 quãng bằng nhau. Số liệu này không tính lượt hiển thị trong khi video phát trực tiếp. Đồ thị về tỷ lệ giữ chân có thể cho thấy đoạn sau của video có nhiều lượt hiển thị hơn so với đoạn đầu. Mọi người có thể bắt đầu từ giữa video, tua nhanh, lưu và xem lại video từ điểm đó hoặc làm những việc tương tự.

lifetime

post_video_views_organic

Số lượt phát video trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây, tính theo số người xem tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime, day

post_video_views_organic_unique

Số người xem video trong tối thiểu 3 giây hoặc xem gần hết nếu video ngắn hơn 3 giây, tính theo số người xem tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_paid

Số lượt phát video quảng cáo của bạn trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại.

lifetime, day

post_video_views_paid_unique

Số người xem video quảng cáo của bạn trong tối thiểu 3 giây hoặc xem gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem và không tính thời gian phát lại.

lifetime

post_video_length

Thời lượng (mili giây) của một bài viết video.

lifetime

post_video_views

Lượt phát video trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại. Số liệu này bao gồm lượt xem trực tiếp.

lifetime, day

post_video_views_unique

Số người xem video trong tối thiểu 3 giây hoặc xem gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

day, lifetime

post_video_views_autoplayed

Số lượt tự động phát video trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_clicked_to_play

Số lượt phát video trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_15s*

Lượt phát video trong tối thiểu 15 giây hoặc gần hết tổng thời lượng nếu video ngắn hơn 15 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_60s_excludes_shorter*

Lượt phát video trong tối thiểu 60 giây. Số liệu này chỉ tính các video dài tối thiểu 60 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime, day

post_video_views_10s

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime, day

post_video_views_10s_unique

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số người xem video của bạn trong tối thiểu 10 giây hoặc xem gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem video và không tính thời gian phát lại.

lifetime

post_video_views_10s_autoplayed

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt tự động phát video của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_10s_clicked_to_play

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây, sau khi mọi người nhấp vào nút phát. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_10s_organic

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây, tính theo số người tiếp cận tự nhiên. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_10s_paid

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video quảng cáo của bạn trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt hiển thị video, chúng tôi sẽ tính riêng lượt xem video và không tính thời gian phát lại.

lifetime, day

post_video_views_10s_sound_on

Ngừng sử dụng sau API Đồ thị phiên bản 18: Số lượt phát video của bạn có bật âm thanh trong tối thiểu 10 giây hoặc phát gần hết nếu video ngắn hơn 10 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_views_sound_on

Lượt phát video có bật tiếng trong tối thiểu 3 giây hoặc phát gần hết nếu video ngắn hơn 3 giây. Với mỗi lượt phát video, chúng tôi sẽ không tính thời gian phát lại.

lifetime

post_video_view_time

Tổng thời gian phát video của bạn (tính bằng mili giây), tính cả số lượt phát dưới 3 giây và những lần phát lại. Trả về 0 đối với video chia sẻ lại.

lifetime, day

post_video_view_time_organic

Tổng thời gian phát video (mili giây) theo số người xem tự nhiên. Trả về 0 đối với video được chia sẻ lại.

lifetime, day

post_video_view_time_by_age_bucket_and_gender

Tổng thời gian (mili giây) phát video cho Đối tượng hàng đầu, độ tuổi và giới tính.

lifetime

post_video_view_time_by_region_id

Tổng thời gian (tính bằng mili giây) mà video của bạn phát cho 45 vị trí hàng đầu, Khu vực - Quốc gia.

lifetime, day

post_video_views_by_distribution_type

Lượt phát video của bạn theo loại phân phối: page_owned và shared.

lifetime

post_video_view_time_by_distribution_type

Tổng thời gian phát video (tính bằng mili giây) theo loại phân phối: page_owned và shared.

lifetime

post_video_view_time_by_country_id

Tổng thời gian (bằng phút) mà video của bạn phát cho 45 vị trí hàng đầu; Quốc gia.

lifetime

post_video_views_live*

Trọn đời: Số người đã xem video của bạn trong tối thiểu 3 giây khi video phát trực tiếp.

lifetime

post_video_social_actions_count_unique*

Lượt hành động xã hội duy nhất (bày tỏ cảm xúc, bình luận, chia sẻ) về một bài viết video.

lifetime, day

post_video_live_current_viewers*

Số người đang xem video trực tiếp. Số liệu này chỉ áp dụng với bài viết chứa video đang phát trực tiếp và sẽ hiển thị là 0 đối với bài viết chứa video đã phát trực tiếp.

post_video_15s_to_60s_excludes_shorter_views_rate*

Tỷ lệ xem video trong 15 - 60 giây. Số liệu này chỉ tính những video có thời lượng từ 60 giây trở lên.

post_video_views_by_live_status*

Lifetime 3S Video Views broken down by live status: live or VOD

Stories

Page and Post Stories and "People talking about this".

Metric Name Description Values for `period`
post_activity_by_action_type*

Số tin đã tạo về bài viết trên Trang, theo loại hành động.

lifetime

post_activity_by_action_type_unique*

Số người tạo tin về bài viết trên Trang của bạn, theo loại hành động.

lifetime

Page Story Types

Name Description
checkin

Page checkins

coupon

Offer claims

event

RSVPing to event

fan

Page likes

mention

Page mentions

page post

Posts by a Page

question

Question answers

user post

Posts by people on a Page

other

Other types

Video Ad Breaks

Metric Name Description Values for period

page_daily_video_ad_break_ad_impressions_by_crosspost_status

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

day

page_daily_video_ad_break_cpm_by_crosspost_status

The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook.

day

page_daily_video_ad_break_earnings_by_crosspost_status

An estimate of the amount you earned from ad breaks in a crossposted videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.

day

post_video_ad_break_ad_impressions

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

day, lifetime

post_video_ad_break_earnings

An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments.

day, lifetime

post_video_ad_break_ad_cpm

The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook.

day, lifetime

creator_monetization_qualified_views

The number of views of your videos that will receive a payout. To qualify for payout, your Page or profile must generate ad revenue in the current earning period. You must also be following the Partner Monetization Policies and Content Monetization Policies. There are additional factors which may disqualify a view for payout.

day,lifetime

Thông số

Thông sốMô tả
breakdown
list<A valid breakdown for an insights endpoint>

breakdown for marketing messages metrics. This is currently in development.

date_preset
enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}

Preset a date range, like lastweek, yesterday. If since or until presents, it does not work.

metric
list<A valid metric for an insights endpoint>

The list of metrics that needs to be fetched

period
enum {day, week, days_28, month, lifetime, total_over_range}

The aggregation period

show_description_from_api_doc
boolean
Giá trị mặc định: false

If set to true, then an additional description of the metric, retrieved from the API doc(https://developers.facebook.com/docs/graph-api/reference/insights) will be included in the returned data

since
datetime

Lower bound of the time range to consider

until
datetime

Upper bound of the time range to consider

Trường

Đọc từ cạnh này sẽ trả về một kết quả JSON đã định dạng:

{ "data": [], "paging": {} }

data

Danh sách nút InsightsResult.

paging

Để biết thêm chi tiết về chia trang, hãy xem hướng dẫn về API Đồ thị.

Mã lỗi

LỗiMô tả
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
3001Invalid query
104Incorrect signature
368The action attempted has been deemed abusive or is otherwise disallowed
2500Error parsing graph query

Tạo

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Cập nhật

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Xóa

Bạn không thể thực hiện thao tác này trên điểm cuối này.

See Also