取得粉絲專頁洞察報告
本指南說明如何取得 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 GMT。
準備工作
取得單項衡量指標
傳送 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）數值必須為有效的洞察報告衡量指標」 | 可能是拼字或語法問題。 |
| 「未指定要擷取的衡量指標。請指定一或多個要擷取的衡量指標，然後再試一次。」 | 使用 |