Версия API Graph
Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 11 сен
Последнее обновление (Русский): 26 окт 2018 г.

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.

New Page Experience

This endpoint is supported for New Page Experience.

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

TypeDescription

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 Graph, ознакомьтесь с нашим руководством по API Graph.

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 Graph, ознакомьтесь с нашим руководством по API Graph.

Metrics

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

SuffixDescription

_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

Число пользователей, выполнивших вход и просмотревших вкладки на вашей Странице. (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*

Количество людей, на экране которых показывался контент с вашей Страницы или о вашей Странице с прикрепленной социальной информацией. Социальная информация – это одна из форм органического распространения. Она показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является приблизительной и в разработке.

day, week, days_28

page_impressions_nonviral*

Сколько раз контент с вашей Страницы показывался на экране пользователя. Не включает контент о вашей Странице с прикрепленной социальной информацией. Социальная информация показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является в разработке.

day, week, days_28

page_impressions_nonviral_unique*

Количество людей, на экране которых показывался контент с вашей Страницы. Не включает контент о вашей Странице с прикрепленной социальной информацией. Социальная информация – это одна из форм органического распространения. Она показывается, когда друг пользователя взаимодействует с вашей Страницей, публикацией или историей, например ставит Странице отметку "Нравится" или подписывается на нее, взаимодействует с публикацией, делится фото с вашей Страницы или отмечает на ней посещение. Эта метрика является приблизительной и в разработке.

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*

Число отображений публикаций вашей Страницы на экране какого-либо пользователя в результате оплаченного распространения – например, рекламы.

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*

Эта метрика учитывает охват, когда вашим контентом делятся в виде репоста или истории. Охват от репостов учитывается только в органическом распространении. Эта метрика является приблизительной и в разработке.

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

Совокупные данные о местонахождении людей, которым понравилась ваша страница, с сортировкой по городам.

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

Не поддерживается для версий после 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.

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

Среднее время (в миллисекундах), которое люди потратили на просмотр ваших видео. Метрика доступна только для видео, созданных после 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

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 Graph.

Error Codes

ОшибкаОписание
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
80001There 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.
3001Invalid query
104Incorrect signature
368The action attempted has been deemed abusive or is otherwise disallowed
2500Error parsing graph query

Создание

Нельзя выполнить эту операцию в этой конечной точке.

Обновление

Нельзя выполнить эту операцию в этой конечной точке.

Удаление

Нельзя выполнить эту операцию в этой конечной точке.

See Also