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.
Get metrics for Pages or Page posts.
period
are calculated from the initial collection of the data point.since
and until
parameters. since
and until
, the since
date data will be included in the first value
returned.viral_unique
and organic_unique
.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."Type | Description |
---|---|
A Page access token requested by a person who can perform the ANALYZE task on the Page. | |
Not applicable. | |
| |
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
}];
NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.
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
}];
Metric names indicate whether a metric is for a Page or a Page post.
Suffix | Description |
---|---|
| Indicates that the metric shows the number of unique users who performed a specific action, for example |
| Indicates whether a person was logged into Facebook, for example, |
| Indicates whether a person is logged out of Facebook, for example |
| Indicates that the metric will be broken down into a list of referral sources, for example |
| Indicates that a metric is refreshed several times during the day, for example |
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 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 |
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 |
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 |
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 và đ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 và đang phát triển. | day, week, days_28 |
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 |
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 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 |
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 và đ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 và đang phát triển. | lifetime |
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 |
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 |
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 |
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. |
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. |
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 |
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 |
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 |
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 |
Metric Name | Description | Values for period |
---|---|---|
| The total number of times an ad was shown during ad breaks in crossposted videos. | day |
| 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 |
| 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 |
| The total number of times an ad was shown during ad breaks in your videos. | day, lifetime |
| 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 |
| 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 |
| 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ố | 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 |
Đọc từ cạnh này sẽ trả về một kết quả JSON đã định dạng:
{ "
data
": [], "paging
": {} }
data
paging
Lỗi | Mô tả |
---|---|
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
200 | Permissions error |
80001 | There 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. |
3001 | Invalid query |
104 | Incorrect signature |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
2500 | Error parsing graph query |