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 | Число пользователей, выполнивших вход и просмотревших вкладки на вашей Странице. (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 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 | Количество кликов по контактной информации и кнопке призыва к действию вашей Страницы. | day, week, days_28 |
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 |
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* | Количество людей, на экране которых показывался контент с вашей Страницы или о вашей Странице с прикрепленной социальной информацией. Социальная информация – это одна из форм органического распространения. Она показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является приблизительной и в разработке. | day, week, days_28 |
page_impressions_nonviral* | Сколько раз контент с вашей Страницы показывался на экране пользователя. Не включает контент о вашей Странице с прикрепленной социальной информацией. Социальная информация показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является в разработке. | day, week, days_28 |
page_impressions_nonviral_unique* | Количество людей, на экране которых показывался контент с вашей Страницы. Не включает контент о вашей Странице с прикрепленной социальной информацией. Социальная информация – это одна из форм органического распространения. Она показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является приблизительной и в разработке. | day, week, days_28 |
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* | Число отображений публикаций вашей Страницы на экране какого-либо пользователя в результате оплаченного распространения – например, рекламы. | 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 |
Metric Name | Description | Values for `period` |
---|---|---|
post_clicks* | Число кликов по любым местам ваших публикаций без создания новости. | lifetime |
post_clicks_by_type* | Число кликов по любым местам ваших публикаций без создания новости (с разбивкой по типу потребления). | 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* | Число отображений публикации вашей Страницы на экране какого-либо пользователя. Публикациями считаются статусы, фото, ссылки, видео и т. п. | 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* | Эта метрика учитывает охват, когда вашим контентом делятся в виде репоста или истории. Охват от репостов учитывается только в органическом распространении. Эта метрика является приблизительной и в разработке. | lifetime |
post_impressions_nonviral* | Число отображений публикации вашей Страницы на экране какого-либо пользователя. Не включает контент о вашей Странице с прикрепленной социальной информацией. Социальная информация прикрепляется, когда друг пользователя взаимодействует с вашей Страницей или публикацией. Сюда входят такие действия, как отметка "Нравится" или подписка на вашу Страницу, взаимодействие с вашей публикацией, репост фото вашей Страницы или отметка посещения вашей Страницы, выполненные другом пользователя. Эта метрика является в разработке. | lifetime |
post_impressions_nonviral_unique* | Число людей, на экране которых отображалась публикация вашей Страницы. Не включает контент о вашей Странице с прикрепленной социальной информацией. В качестве одной из форм органического распространения социальная информация прикрепляется, когда друг пользователя взаимодействует с вашей Страницей или публикацией. Сюда входят такие действия, как отметка "Нравится" или подписка на вашу Страницу, взаимодействие с вашей публикацией, репост фото вашей Страницы или отметка посещения вашей Страницы, выполненные другом пользователя. Эта метрика является приблизительной и в разработке. | lifetime |
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 |
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 |
Metric Name | Description | Values for `period` |
---|---|---|
page_fans | Общее число людей, которым понравилась ваша Страница. | day |
page_fans_locale | Совокупные данные о языке людей, которым понравилась ваша страница, основанные на настройках языка по умолчанию при входе на Facebook. | day |
page_fans_city | Совокупные данные о местонахождении людей, которым понравилась ваша страница, с сортировкой по городам. | 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 |
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 | Число просмотров видео вашей Страницы в течение как минимум 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 | Не поддерживается для версий после Graph API v18. Число воспроизведений видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Время повторов при каждом воспроизведении не учитывается. | day, week, days_28 |
page_video_views_10s_paid | Не поддерживается для версий после Graph API v18. Число воспроизведений продвигаемых видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Для каждого показа видео просмотры считаются отдельно, а время повторов не учитывается. | day, week, days_28 |
page_video_views_10s_organic | Не поддерживается для версий после Graph API v18. Число воспроизведений видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд) в рамках органического охвата. Время повторов при каждом воспроизведении не учитывается. | day, week, days_28 |
page_video_views_10s_autoplayed | Не поддерживается для версий после Graph API v18. Число автоматических воспроизведений видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Время повторов при каждом воспроизведении не учитывается. | day, week, days_28 |
page_video_views_10s_click_to_play | Не поддерживается для версий после Graph API v18. Число воспроизведений видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд) после нажатия кнопки "Воспроизвести". Время повторов при каждом воспроизведении не учитывается. | day, week, days_28 |
page_video_views_10s_unique | Не поддерживается для версий после Graph API v18. Число людей, смотревших видео вашей Страницы в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Время повторов при каждом воспроизведении не учитывается. | day, week, days_28 |
page_video_views_10s_repeat | Не поддерживается для версий после Graph 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. |
Metric Name | Description | Values for `period` |
---|---|---|
page_views_total* | Число просмотров профиля вашей Страницы пользователями, которые выполнили вход, а также пользователями, не выполнившими вход. | day, week, days_28 |
Metric Name | Description | Values for `period` |
---|---|---|
post_video_avg_time_watched | Среднее время (в миллисекундах), которое люди потратили на просмотр ваших видео. Метрика доступна только для видео, созданных после 25 августа 2016 г. Возвращает 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 | Не поддерживается для версий после Graph API v18. Число воспроизведений ваших видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Время повторов при каждом воспроизведении не учитывается. | lifetime, day |
post_video_views_10s_unique | Не поддерживается для версий после Graph API v18. Число людей, смотревших ваши видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Для каждого показа видео просмотры считаются отдельно, а время повторов не учитывается. | lifetime |
post_video_views_10s_autoplayed | Не поддерживается для версий после Graph API v18. Число автоматических воспроизведений ваших видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Время повторов при каждом воспроизведении не учитывается. | lifetime |
post_video_views_10s_clicked_to_play | Не поддерживается для версий после Graph API v18. Число воспроизведений ваших видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд) после нажатия кнопки "Воспроизвести". Время повторов при каждом воспроизведении не учитывается. | lifetime |
post_video_views_10s_organic | Не поддерживается для версий после Graph API v18. Число воспроизведений ваших видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд) в рамках органического охвата. Время повторов при каждом воспроизведении не учитывается. | lifetime |
post_video_views_10s_paid | Не поддерживается для версий после Graph API v18. Число воспроизведений ваших продвигаемых видео в течение как минимум 10 секунд или почти полностью (если они короче 10 секунд). Для каждого показа видео просмотры считаются отдельно, а время повторов не учитывается. | lifetime, day |
post_video_views_10s_sound_on | Не поддерживается для версий после Graph 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* | Число зрителей, которые сейчас смотрят прямой эфир. Эта метрика показывается только для публикаций с прямыми эфирами. Если прямой эфир прошел, значение метрики будет нулевым. | |
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 |
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 |
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 |
Параметр | Описание |
---|---|
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
paging
Ошибка | Описание |
---|---|
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 |