获取公共主页成效分析
本指南将介绍如何获取 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将为 GMT 时间 2018 年 1 月 2 日 8:00。
准备工作
获取单个指标
向 /{page-id}/insights/{metric-name} 端点发送 GET 请求：
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"
}
}获取多个指标
向 /{page-id}/insights 端点发送 GET 请求，并附上 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"
}
],
...获取公共主页帖子的指标
向 /{page-post-id}/insights 端点发送 GET 请求，并附上 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"
}
}获取视频广告插播展示次数
其他要求
- 请求公共主页访问口令的用户必须能够访问该变现成效分析。
向 /{page-id} 端点发送 GET 请求，以获取公共主页的单日视频广告插播展示次数：
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"
}
...获取公共主页帖子的单日视频广告插播展示次数
向 /{page-post-id}/insights 端点发送 GET 请求，并附上 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) 该值必须为有效的成效分析指标” | 可能出现拼写或语法问题。 |
| “未指定要获取的任何指标。请指定要获取的一个或多个指标，然后重试。” | 使用 |