圖形 API 版本

這份文件已更新。
中文(台灣) 的翻譯尚未完成。

英文更新時間：9月11日
中文(台灣) 更新時間：2018年10月26日

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.

閱讀中

Get metrics for Pages or Page posts.

新粉絲專頁體驗

This endpoint is supported for 新粉絲專頁體驗.

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

Type	Description
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
}];

如果想瞭解如何使用圖形 API，請參閱我們的使用圖形 API 指南。

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
}];

如果想瞭解如何使用圖形 API，請參閱我們的使用圖形 API 指南。

Metrics

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

Suffix	Description
`_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`	登入 Facebook 後瀏覽你粉絲專頁頁籤的用戶人數。 (See possible types)	day, week
`page_tab_views_login_top`	登入 Facebook 的用戶在你粉絲專頁上看過頁籤的次數。 (See possible types)	day, week
`page_tab_views_logout_top`	未登入 Facebook 的用戶瀏覽你粉絲專頁頁籤的次數。 (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`	你粉絲專頁聯絡資料和行動呼籲按鈕的點擊次數。	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*`	用戶透過傳達心情、留言、分享等方式與你的貼文互動的次數。	day, week, days_28
`page_fan_adds_by_paid_non_paid_unique`	第一次對你的粉絲專頁按讚的帳號管理中心帳號數量，依粉絲專頁按讚動作是來自付費或自主內容細分。此衡量指標為估計值。	day
`page_lifetime_engaged_followers_unique*`	追蹤你的粉絲專頁，且過去 14 天看過你的一或多段直播或預錄影片至少 1 分鐘，並／或透過留言、分享、傳達心情或按讚與你的影片內容互動過至少一次的用戶。
`page_daily_follows*`	在所選時間範圍內追蹤你 Facebook 粉絲專頁或個人檔案的次數。	day
`page_daily_follows_unique*`	在所選時間範圍內追蹤你粉絲專頁的帳號管理中心帳號數量。此衡量指標為估計值。	day, week, days_28
`page_daily_unfollows_unique*`	在所選時間範圍內取消追蹤你粉絲專頁的帳號管理中心帳號數量。此衡量指標為估計值。	day, week, days_28
`page_follows*`	你 Facebook 粉絲專頁或個人檔案的追蹤者人數。計算方式為 Facebook 粉絲專頁或個人檔案整體期間內的追蹤人數減去取消追蹤的人數。	day

Page Impressions

Metric Name	Description	Values for `period`
`page_impressions*`	任何來自你粉絲專頁或有關你專頁的內容（包括貼文、限時動態、廣告，以及你專頁上的其他內容或資訊）進入用戶瀏覽畫面的次數。	day, week, days_28
`page_impressions_unique*`	任何來自你粉絲專頁或有關你專頁的內容（包括貼文、打卡、廣告、曾與你專頁互動用戶的社交資訊和其他內容）進入其瀏覽畫面的用戶人數。此衡量指標為估計值。	day, week, days_28
`page_impressions_paid*`	任何來自你粉絲專頁或有關你專頁的貼文或限時動態內容透過付費散播（例如廣告）進入用戶瀏覽畫面的次數。	day, week, days_28
`page_impressions_paid_unique*`	看到你的廣告至少一次的帳號管理中心帳號數量。觸及人數與曝光次數不同，後者會納入同一個帳號管理中心帳號重複看到廣告的次數。此衡量指標為估計值。	day, week, days_28
`page_impressions_viral*`	你粉絲專頁或有關你專頁的內容與社交資訊一同進入用戶瀏覽畫面的次數。社交資訊會在用戶的朋友與你專頁、貼文或限時動態互動時顯示，包括用戶的朋友說你專頁讚或追蹤你的專頁、與貼文互動、分享你專頁的相片、在你的專頁打卡等。此衡量指標為調整中。	day, week, days_28
`page_impressions_viral_unique*`	此衡量指標會計算你附有社交資訊的 Facebook 粉絲專頁和專頁內容透過自主或付費散播所觸及的人數。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。如果內容透過自主和付費散播觸及同一人，則只會計入一人。此衡量指標為估計值和調整中。	day, week, days_28
`page_impressions_nonviral*`	你的 Facebook 粉絲專頁和專頁內容出現在畫面中的次數（不包括附有社交資訊的內容）。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。此衡量指標為調整中。	day, week, days_28
`page_impressions_nonviral_unique*`	此衡量指標會計算你的 Facebook 粉絲專頁和專頁內容透過自主或付費散播所觸及的人數（不包括附有社交資訊的內容）。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。如果內容透過自主和付費散播觸及同一人，則只會計入一人。此衡量指標為估計值和調整中。	day, week, days_28

Page Posts

Metric Name	Description	Values for `period`
`page_posts_impressions*`	你粉絲專頁的貼文（包括近況更新、相片、連結、影片和其他內容）進入用戶瀏覽畫面的次數。	day, week, days_28
`page_posts_impressions_unique*`	任何你粉絲專頁的貼文進入其瀏覽畫面的用戶人數。貼文包括近況、相片、連結、影片等等。	day, week, days_28
`page_posts_impressions_paid*`	你的 Facebook 粉絲專頁和專頁內容因為廣告而出現在畫面中的次數。	day, week, days_28
`page_posts_impressions_paid_unique*`	因你的廣告至少看過你粉絲專頁任何貼文一次的帳號管理中心帳號數量。	day, week, days_28
`page_posts_impressions_organic_unique*`	任何你粉絲專頁貼文透過未付費散播進入其瀏覽畫面的用戶人數。	day, week, days_28
`page_posts_served_impressions_organic_unique`	在其動態消息看過你粉絲專頁貼文的用戶人數（不論是否出現在瀏覽畫面）。貼文包括近況、相片、連結、影片等等。	day, week, days_28
`page_posts_impressions_viral*`	你粉絲專頁的貼文與社交資訊一同進入用戶瀏覽畫面的次數。社交資訊會在用戶的朋友與你專頁或貼文互動時顯示，包括用戶的朋友說你專頁讚或追蹤你的專頁、與貼文互動、分享你專頁的相片、在你的專頁打卡等。	day, week, days_28
`page_posts_impressions_viral_unique*`	你粉絲專頁的貼文與社交資訊一同進入其瀏覽畫面的用戶人數。社交資訊也是自主散播的一種形式，會在用戶的朋友與你的專頁或貼文互動時出現，包括用戶的朋友說你專頁讚或追蹤你的專頁、與貼文互動、分享你專頁的相片、在你的專頁打卡等。	day, week, days_28
`page_posts_impressions_nonviral*`	你的粉絲專頁貼文（不包括有關你專頁且附有社交資訊的內容）進入用戶瀏覽畫面的次數。社交資訊會在用戶的朋友與你專頁或貼文互動時顯示，包括用戶的朋友說你專頁讚或追蹤你的專頁、與貼文互動、分享你專頁的相片、在你的專頁打卡等。	day, week, days_28
`page_posts_impressions_nonviral_unique*`	你粉絲專頁內容（不包括有關你專頁且附有社交資訊的內容）進入其瀏覽畫面的用戶人數。社交資訊也是自主散播的一種形式，會在用戶的朋友與你的專頁或貼文互動時出現，包括用戶的朋友說你專頁讚或追蹤你的專頁、與貼文互動、分享你專頁的相片、在你的專頁打卡等。	day, week, days_28

Page Post Engagement

Metric Name	Description	Values for `period`
`post_clicks*`	用戶點擊你貼文任一處但未產生動態的次數。	lifetime
`post_clicks_by_type*`	用戶點擊你貼文任一處但未產生動態的次數（以使用類型區分）。	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*`	你粉絲專頁的貼文（包括近況更新、相片、連結、影片和其他內容）進入用戶瀏覽畫面的次數。	lifetime
`post_impressions_unique*`	你粉絲專頁的貼文（包括近況更新、相片、連結、影片和其他內容）進入其瀏覽畫面的用戶人數。此衡量指標為估計值。	lifetime
`post_impressions_paid*`	你的粉絲專頁內容因為廣告而出現在畫面中的次數。	lifetime
`post_impressions_paid_unique*`	因你的廣告至少看過你的貼文一次的帳號管理中心帳號數量。此衡量指標為估計值。	lifetime
`post_impressions_fan*`	追蹤你粉絲專頁或對其按讚的帳號看到你專頁內容的次數。	lifetime
`post_impressions_fan_unique*`	追蹤你粉絲專頁或對其按讚的帳號管理中心帳號數量。此衡量指標為估計值。	lifetime
`post_impressions_organic*`	你的貼文透過自主散播出現在畫面中的次數。	lifetime
`post_impressions_organic_unique*`	此衡量指標會計算你的 Facebook 內容（包括貼文、限時動態和廣告）透過自主散播所觸及的人數。來自分享的觸及人數只會計入自主內容，這包括你的內容透過限時動態或轉發分享的情況。此衡量指標為估計值。	lifetime
`post_impressions_viral*`	你附有社交資訊的粉絲專頁內容出現在畫面中的次數。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。此衡量指標為調整中。	lifetime
`post_impressions_viral_unique*`	當你的 Facebook 內容以轉發或限時動態形式分享時，此衡量指標會計算觸及人數。來自分享的觸及人數只會計入自主散播。此衡量指標為估計值和調整中。	lifetime
`post_impressions_nonviral*`	你的粉絲專頁內容出現在畫面中的次數（不包括附有社交資訊的內容）。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。此衡量指標為調整中。	lifetime
`post_impressions_nonviral_unique*`	此衡量指標會計算你的粉絲專頁內容透過自主或付費散播所觸及的人數（不包括附有社交資訊的內容）。用戶與你的專頁、貼文或限時動態互動後，便會在動態消息看到社交資訊。如果內容透過自主和付費散播觸及同一人，則只會計入一人。此衡量指標為估計值和調整中。	lifetime

Page Post Reactions

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

Metric Name	Description	Values for `period`
`post_reactions_like_total`	貼文收到的「讚」心情總數。	lifetime
`post_reactions_love_total`	貼文收到的「大心」心情總數。	lifetime
`post_reactions_wow_total`	貼文收到的「哇」心情總數。	lifetime
`post_reactions_haha_total`	貼文收到的「哈」心情總數。	lifetime
`post_reactions_sorry_total`	貼文收到的「嗚」心情總數。	lifetime
`post_reactions_anger_total`	貼文收到的「怒」心情總數。	lifetime
`post_reactions_by_type_total`	貼文收到的心情總數（依類型區分）。	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*`	每日粉絲專頁的貼文「讚」心情總計。	day, week, days_28
`page_actions_post_reactions_love_total*`	粉絲專頁的每日貼文「大心」心情總數。	day, week, days_28
`page_actions_post_reactions_wow_total*`	粉絲專頁的每日貼文「哇」心情總數。	day, week, days_28
`page_actions_post_reactions_haha_total*`	粉絲專頁的每日貼文「哈」心情總數。	day, week, days_28
`page_actions_post_reactions_sorry_total*`	每日：粉絲專頁的貼文「嗚」心情總計。	day, week, days_28
`page_actions_post_reactions_anger_total*`	每日粉絲專頁的貼文「怒」心情總計。	day, week, days_28
`page_actions_post_reactions_total`	粉絲專頁的每日貼文心情總數（以類型區分）。	day

Page User Demographics

Metric Name	Description	Values for `period`
`page_fans`	說你粉絲專頁讚的總人數。	day
`page_fans_locale`	根據存取 Facebook 時所選預設語言設定，對你的粉絲專頁說讚的人的相關彙總語言資料。	day
`page_fans_city`	依照城市顯示對專頁說讚的用戶整合 Facebook 地點資料。	day
`page_fans_country`	對你粉絲專頁按讚的用戶人數（每個國家／地區的彙總人數）。僅包含對你專頁按讚的用戶人數最多的 45 個國家／地區。	day
`page_fan_adds`	說你的粉絲專頁讚的新用戶人數。	day
`page_fan_adds_unique`	首次對你的粉絲專頁按讚的帳號管理中心帳號數量。此衡量指標為估計值。	day, week, days_28
`page_fan_removes`	對你的粉絲專頁收回讚的次數。	day
`page_fan_removes_unique*`	對你的粉絲專頁收回讚的次數。	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`	你的粉絲專頁影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_by_uploaded_hosted*`	粉絲專頁層級的每日影片觀看次數，依粉絲專頁上傳和代管的所有影片區分。	day, week, days_28
`page_video_views_paid`	你粉絲專頁的推廣影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	day, week, days_28
`page_video_views_organic`	用戶自主觸及你的粉絲專頁影片並播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_by_paid_non_paid*`	你的粉絲專頁影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數（依總數、付費和非付費區分）。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_autoplayed`	你的粉絲專頁影片自動播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_click_to_play`	用戶點擊播放後，你的粉絲專頁影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_unique`	觀看你的粉絲專頁影片至少 3 秒或接近完整播放（若影片短於 3 秒）的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_repeat_views`	你的粉絲專頁影片重播至少 3 秒或接近完整重播（若影片短於 3 秒）的次數。	day, week, days_28
`page_video_complete_views_30s`	你的粉絲專頁影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_paid`	你粉絲專頁的推廣影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_organic`	用戶自主觸及你的粉絲專頁影片並播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_autoplayed`	你粉絲專頁的影片自動播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_click_to_play`	用戶點擊播放後，你的粉絲專頁影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_unique`	觀看你的粉絲專頁影片至少 30 秒或接近完整播放（若影片短於 30 秒）的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_complete_views_30s_repeat_views`	你的粉絲專頁影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。	day, week, days_28
`post_video_complete_views_30s_autoplayed`	你的影片自動播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_30s_clicked_to_play`	用戶點擊播放之後，你的影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_30s_organic`	用戶自主觸及你的影片並播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_30s_paid`	你的推廣影片播放至少 30 秒或接近完整播放（若影片短於 30 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_30s_unique`	觀看你的影片至少 30 秒或接近完整播放（若影片短於 30 秒）的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`page_video_views_10s`	針對圖形 API v18 以上版本停用：你的粉絲專頁影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_paid`	針對圖形 API v18 以上版本停用：你粉絲專頁的推廣影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_organic`	針對圖形 API v18 以上版本停用：用戶自主觸及你的粉絲專頁影片並播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_autoplayed`	針對圖形 API v18 以上版本停用：你的粉絲專頁影片自動播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_click_to_play`	針對圖形 API v18 以上版本停用：用戶點擊播放後，你的粉絲專頁影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_unique`	針對圖形 API v18 以上版本停用：觀看你的粉絲專頁影片至少 10 秒或接近完整播放（若影片短於 10 秒）的用戶人數。針對影片的每次曝光，我們將會扣除重播影片的所有時間。	day, week, days_28
`page_video_views_10s_repeat`	針對圖形 API v18 以上版本停用：你的粉絲專頁影片重播至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。	day, week, days_28
`page_video_view_time`	每位用戶觀看你粉絲專頁影片的總時間（毫秒）。	day
`page_uploaded_3s_to_15s_views_rate*`	影片觀看 3 秒到 15 秒的比率。衡量的範圍是所有上傳的影片素材，而且計算內容包括貼文／多文發佈貼文或其分享貼文上的任何動態。
`page_uploaded_views_15s_count*`	用戶觀看你粉絲專頁影片至少 15 秒的次數總計。
`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*`	已登入用戶和未登入用戶查看粉絲專頁個人檔案的次數。	day, week, days_28

Page Video Posts

Metric Name	Description	Values for `period`
`post_video_avg_time_watched`	用戶觀看你影片的平均時間（毫秒）。只適用於 2016 年 8 月 25 日以後建立的影片。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_organic`	用戶自主觸及你的影片並從頭播放至總長度 97% 以上的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_organic_unique`	自主觸及你的影片並從頭觀看至總長度 97% 以上的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_paid`	你的推廣影片從頭播放至總長度 97% 以上的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。轉貼影片的結果一律是 0。	lifetime
`post_video_complete_views_paid_unique`	從頭觀看你的推廣影片至總長度 97% 以上的用戶人數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	lifetime
`post_video_retention_graph*`	你的影片在各個時段的播放次數佔所有觀看次數的百分比。影片會均分成 40 個片段。此指標不計入影片直播時的曝光次數。在續看率圖表中，影片中後段的曝光次數可能會多於影片開頭。用戶可能會從中間開始觀看影片、快轉、儲存並從該時間點重新觀看，或採取其他類似動作。	lifetime
`post_video_retention_graph_clicked_to_play`	用戶點擊播放後，你的影片在各個時段的播放次數佔所有觀看次數的百分比。影片會均分成 40 個片段。此指標不計入影片直播時的曝光次數。在續看率圖表中，影片中後段的曝光次數可能會多於影片開頭。用戶可能會從中間開始觀看影片、快轉、儲存並從該時間點重新觀看，或採取其他類似動作。	lifetime
`post_video_retention_graph_autoplayed`	你的影片在各個時段的自動播放次數佔所有自動觀看次數的百分比。影片會均分成 40 個片段。此指標不計入影片直播時的曝光次數。在續看率圖表中，影片中後段的曝光次數可能會多於影片開頭。用戶可能會從中間開始觀看影片、快轉、儲存並從該時間點重新觀看，或採取其他類似動作。	lifetime
`post_video_views_organic`	用戶自主觸及你的影片並播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime, day
`post_video_views_organic_unique`	自主觸及你的影片並觀看至少 3 秒或接近完整播放（若影片短於 3 秒）的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_paid`	你的推廣影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	lifetime, day
`post_video_views_paid_unique`	觀看你的推廣影片至少 3 秒或接近完整播放（若影片短於 3 秒）的用戶人數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	lifetime
`post_video_length`	影片貼文的時間長度（毫秒）。	lifetime
`post_video_views`	你的影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。這會包含直播觀看次數。	lifetime, day
`post_video_views_unique`	觀看你的影片至少 3 秒或接近完整播放（若影片短於 3 秒）的用戶人數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	day, lifetime
`post_video_views_autoplayed`	你的影片自動播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_clicked_to_play`	用戶點擊播放後，你的影片播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_15s*`	你的影片播放至少 15 秒或接近完整播放（若影片短於 15 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_60s_excludes_shorter*`	你的粉絲專頁影片播放至少 60 秒的次數。此衡量指標僅將長度 60 秒以上的影片納入計算。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime, day
`post_video_views_10s`	針對圖形 API v18 以上版本停用：你的影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime, day
`post_video_views_10s_unique`	針對圖形 API v18 以上版本停用：觀看你的影片至少 10 秒或接近完整播放（若影片短於 10 秒）的用戶人數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	lifetime
`post_video_views_10s_autoplayed`	針對圖形 API v18 以上版本停用：你的影片自動播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_10s_clicked_to_play`	針對圖形 API v18 以上版本停用：用戶點擊播放後，你的影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_10s_organic`	針對圖形 API v18 以上版本停用：用戶自主觸及你的影片並播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_10s_paid`	針對圖形 API v18 以上版本停用：你的推廣影片播放至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次曝光，我們將會分別計算影片觀看次數，並扣除重播影片的所有時間。	lifetime, day
`post_video_views_10s_sound_on`	針對圖形 API v18 以上版本停用：用戶開啟音效播放你影片至少 10 秒或接近完整播放（若影片短於 10 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_views_sound_on`	你的影片有聲播放至少 3 秒或接近完整播放（若影片短於 3 秒）的次數。針對影片的每次播放，我們將會扣除重播影片的所有時間。	lifetime
`post_video_view_time`	你的影片播放總時間（毫秒），重播和播放不到 3 秒的時間也算在內。轉貼影片的結果一律是 0。	lifetime, day
`post_video_view_time_organic`	用戶自主觸及你影片並播放的總時間（毫秒）。轉貼影片的結果一律是 0。	lifetime, day
`post_video_view_time_by_age_bucket_and_gender`	最喜愛你影片的觀眾（年齡和性別）播放影片的總時間（毫秒）。	lifetime
`post_video_view_time_by_region_id`	你影片在最受歡迎的前 45 個地點（區域 - 國家／地區）的播放總時間（毫秒）。	lifetime, day
`post_video_views_by_distribution_type`	依照發佈類型（擁有／分享的粉絲專頁）分類的影片播放次數。	lifetime
`post_video_view_time_by_distribution_type`	依照發佈類型（擁有／分享的粉絲專頁）分類的影片播放總時間（毫秒）。	lifetime
`post_video_view_time_by_country_id`	你影片在最受歡迎的前 45 個地點（國家／地區）的播放總時間（分鐘）。	lifetime
`post_video_views_live*`	直播串流時，觀看你的影片超過 3 秒的總用戶人數。	lifetime
`post_video_social_actions_count_unique*`	影片貼文收到的不重複社交動作次數（心情數、留言數、分享次數）。	lifetime, day
`post_video_live_current_viewers*`	正在觀看直播視訊的觀眾人數。此衡量指標只會傳回直播視訊貼文的資料。直播影片貼文的結果一律是 0。
`post_video_15s_to_60s_excludes_shorter_views_rate*`	影片觀看 15 秒到 60 秒的比率。此 60 秒衡量指標僅將長度 60 秒以上的影片納入計算。
`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*`	因為你粉絲專頁貼文而建立的相關動態數量（依動作類型區分）。	lifetime
`post_activity_by_action_type_unique*`	因為你粉絲專頁貼文而建立相關動態的用戶人數（依動作類型區分）。	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

參數

參數	說明
`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	預設值：`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

欄位

由此關係連線進行的閱讀將回傳 JSON 格式結果：

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

`data`

InsightsResult 節點的清單。

`paging`

如需更多有關分頁的詳細資料，請參閱圖形 API 指南。

Error Codes

錯誤	說明
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

建立中

你無法在此端點執行此操作。

更新中

你無法在此端點執行此操作。

刪除中

你無法在此端點執行此操作。

Page Insights

閱讀中

新粉絲專頁體驗

Limitations

Requirements

Example

Single Metric Sample Request

Multiple Metric Sample Request

Metrics

Page Content

Tab Types

Page CTA Clicks

Page Engagement

Page Impressions

Page Posts

Page Post Engagement

Negative Feedback Types

Page Post Impressions

Page Post Reactions

Page Reactions

Page User Demographics

Page Like Sources

Page Video Views

Page Views

Page Video Posts

Stories

Page Story Types

Video Ad Breaks

參數

欄位

data

paging

Error Codes

建立中

更新中

刪除中

See Also

`data`

`paging`