獲取專頁洞察報告
本指南會講解如何獲取 Facebook 專頁的各項衡量數據。獲取為專頁讚好的用戶總數，或者有多少用戶分享有關您專頁的動態。
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.
限制
- Facebook 會將公開專頁的衡量數據儲存 2 年。
- 未發佈的專頁之衡量數據只會儲存 5 天。
- 使用
since和until查看日常衡量數據時，第一個end_time值將為since指定的日期加 1，以包含since日期資料。例如，如果將since設定為 2018 年 1 月 1 日，end_time將為格林威治標準時間 2018 年 1 月 2 日 8:00。
準備工作
獲取單一衡量數據
傳送 GET 要求至 /{page-id}/insights/{metric-name} 端點：
curl -i -X GET "https://graph.facebook.com/{page-id}/insights/page_impressions_unique
?access_token={page-access-token}"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "page_impressions_unique",
"period": "day",
"values": [
{
"value": 66226,
"end_time": "2020-03-10T07:00:00+0000"
},
{
"value": 78037,
"end_time": "2020-03-11T07:00:00+0000"
}
],
"title": "Daily Total Reach",
"description": "Daily: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "{page-id}/insights/page_impressions_unique/day"
},
{
"name": "page_impressions_unique",
"period": "week",
"values": [
{
"value": 202229,
"end_time": "2020-03-10T07:00:00+0000"
},
{
"value": 206982,
"end_time": "2020-03-11T07:00:00+0000"
}
],
"title": "Weekly Total Reach",
"description": "Weekly: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "{page-id}/insights/page_impressions_unique/week"
},
{
"name": "page_impressions_unique",
"period": "days_28",
"values": [
{
"value": 427380,
"end_time": "2020-03-10T07:00:00+0000"
},
{
"value": 432909,
"end_time": "2020-03-11T07:00:00+0000"
}
],
"title": "28 Days Total Reach",
"description": "28 Days: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "{page-id}/insights/page_impressions_unique/days_28"
}
],
"paging": {
"previous": "https://graph.facebook.com/{page-id}/insights?access_token={page-access-token}&pretty=0&metric=page_impressions_unique&since=1583568000&until=1583737200",
"next": "https://graph.facebook.com/{page-id}/insights?access_token={page-access-token}&pretty=0&metric=page_impressions_unique&since=1583910000&until=1584082800"
}
}獲取多個衡量數據
傳送 GET 要求至 /{page-id}/insights 端點，並附上 metric 欄位：
curl -i -X GET "https://graph.facebook.com/{page-id}/insights
?metric=page_impressions_unique,page_impressions_paid
&access_token={page-access-token}"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "page_impressions_unique",
"period": "day",
"values": [
{
"value": 60,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 50,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "Daily Total Reach",
"description": "Daily: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "PAGE_ID/insights/page_impressions_unique/day"
},
{
"name": "page_impressions_paid",
"period": "day",
"values": [
{
"value": 8,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 10,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "Daily Paid Impressions",
"description": "Daily: The number of times any post or story content from your Page or about your Page entered a person's screen through paid distribution such as an ad. (Total Count)",
"id": "PAGE_ID/insights/page_impressions_paid/day"
},
{
"name": "page_impressions_unique",
"period": "week",
"values": [
{
"value": 40,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 50,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "Weekly Total Reach",
"description": "Weekly: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "PAGE_ID/insights/page_impressions_unique/week"
},
{
"name": "page_impressions_paid",
"period": "week",
"values": [
{
"value": 50,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 106,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "Weekly Paid Impressions",
"description": "Weekly: The number of times any post or story content from your Page or about your Page entered a person's screen through paid distribution such as an ad. (Total Count)",
"id": "PAGE_ID/insights/page_impressions_paid/week"
},
{
"name": "page_impressions_unique",
"period": "days_28",
"values": [
{
"value": 110,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 10,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "28 Days Total Reach",
"description": "28 Days: The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. (Unique Users)",
"id": "PAGE_ID/insights/page_impressions_unique/days_28"
},
{
"name": "page_impressions_paid",
"period": "days_28",
"values": [
{
"value": 120,
"end_time": "2024-03-11T07:00:00+0000"
},
{
"value": 20,
"end_time": "2024-03-12T07:00:00+0000"
}
],
"title": "28 Days Paid Impressions",
"description": "28 days: The number of times any post or story content from your Page or about your Page entered a person's screen through paid distribution such as an ad. (Total Count)",
"id": "PAGE_ID/insights/page_impressions_paid/days_28"
}
],
...獲取專頁帖子的衡量數據
傳送 GET 要求至 /{page-post-id}/insights 端點，並附上 metric 欄位：
curl -i -X GET "https://graph.facebook.com{page-post-id}/insights
?metric=post_reactions_like_total,post_reactions_love_total,post_reactions_wow_total
&access_token={page-access-token}"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [
{
"value": 226
}
],
"title": "Lifetime Total Like Reactions of a post.",
"description": "Lifetime: Total like reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [
{
"value": 17
}
],
"title": "Lifetime Total Love Reactions of a post.",
"description": "Lifetime: Total love reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
},
{
"name": "post_reactions_wow_total",
"period": "lifetime",
"values": [
{
"value": 1
}
],
"title": "Lifetime Total wow Reactions of a post.",
"description": "Lifetime: Total wow Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_wow_total/lifetime"
}
],
"paging": {
"previous": "https://graph.facebook.com/{page-post-id}/insights?access_token={page-access-token}b&pretty=0&metric=post_reactions_like_total%2Cpost_reactions_love_total%2Cpost_reactions_wow_total&since=1583568000&until=1583737200",
"next": "https://graph.facebook.com/{page-post-id}/insights?access_token={page-access-token}&pretty=0&metric=post_reactions_like_total%2Cpost_reactions_love_total%2Cpost_reactions_wow_total&since=1583910000&until=1584082800"
}
}獲取影片插播廣告的展示次數
其他必要條件
- 要求專頁存取憑證的用戶必須能存取營利洞察報告。
傳送 GET 要求至 /{page-id} 端點，以獲取專頁的每日影片插播廣告展示次數：
curl -i -X GET \
"https://graph.facebook.com/{page-id}/insights
?metric=page_daily_video_ad_break_ad_impressions_by_crosspost_status
&period=day
&since=2017-12-10
&until=2017-12-14"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "page_daily_video_ad_breaks_ad_impressions_by_crosspost_status",
"period": "day",
"values": [
{
"value": {
"crossposted": 27584,
"owned": 692730
},
"end_time": "2017-12-11T08:00:00+0000"
},
{
"value": {
"owned": 757456,
"crossposted": 20593
},
"end_time": "2017-12-12T08:00:00+0000"
},
{
"value": {
"owned": 690092,
"crossposted": 15372
},
"end_time": "2017-12-13T08:00:00+0000"
}
],
"title": "Daily page level videos ad impression",
"description": "Number of times an ad was shown during ad breaks in your Page's videos, by distribution type (page_owned and crossposted).",
"id": "{page-id}/insights/page_daily_video_ad_break_ad_impressions_by_crosspost_status/day"
}
...獲取專頁帖子的每日影片插播廣告展示次數
傳送 GET 要求至 /{page-post-id}/insights 端點，並附上 metric 欄位：
curl -i -X GET "https://graph.facebook.com/{page-post-id}/insights
?metric=post_video_ad_break_ad_impressions
&period=day
&since=2017-12-10
&until=2017-12-14
&access_token={page-access-token}"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "total_video_ad_break_ad_impressions",
"period": "day",
"values": [
{
"value": 2612,
"end_time": "2017-12-11T08:00:00+0000"
},
{
"value": 1038,
"end_time": "2017-12-12T08:00:00+0000"
},
{
"value": 818,
"end_time": "2017-12-13T08:00:00+0000"
},
{
"value": 553,
"end_time": "2017-12-14T08:00:00+0000"
}
],
"title": "Daily Video Ad Break Ad Impressions",
"description": "Number of times an ad was shown during your video ad breaks.",
"id": "{video-id}/video_insights/total_video_ad_break_ad_impressions/day"
}
...獲取專頁帖子的總影片插播廣告展示次數
curl -i -X GET "https://graph.facebook.com/{page-post-id}/insights
?metric=post_video_ad_break_ad_impressions
&period=lifetime
&access_token={page-access-token}"成功的話，您的應用程式會收到以下回應：
{
"data": [
{
"name": "total_video_ad_break_ad_impressions",
"period": "lifetime",
"values": [
{
"value": 55468
}
],
"title": "Lifetime Video Ad Break Ad Impressions",
"description": "Number of times an ad was shown during your video ad breaks.",
"id": "{video-id}/video_insights/total_video_ad_break_ad_impressions/lifetime"
}
...常見錯誤代碼
| 錯誤代碼 | 錯誤訊息 | 說明 |
|---|---|---|
無 | 傳回空白資料集。 | 您需要 |
| 「（#100）此值必須為有效的洞察報告衡量數據」 | 可能出現拼寫或語法問題。 |
| 「未指定要擷取的衡量數據。請指定要擷取的一個或多個衡量數據，然後重試。」 | 使用 |