그래프 API 버전

문서가 업데이트되었습니다.
한국어로 번역이 아직 완료되지 않았습니다.

영어 업데이트됨: 9월 11일
한국어 업데이트됨: 2018. 10. 26.

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.

새로운 페이지 환경

This endpoint is supported for 새로운 페이지 환경.

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

Type	Description
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를 사용하는 방법을 알아보려면 그래프 API 사용 가이드를 읽어보세요.

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를 사용하는 방법을 알아보려면 그래프 API 사용 가이드를 읽어보세요.

Metrics

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

Suffix	Description
`_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`	Facebook에 로그인하여 페이지의 탭을 본 사용자 수. (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분 이상, 1번 이상 시청했거나 동영상 콘텐츠에 댓글, 공유, 공감 또는 좋아요로 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*`	이 지표는 Facebook 페이지 및 페이지 콘텐츠가 소셜 정보가 연결된 상태로 표시된 경우 해당 페이지 및 콘텐츠의 일반 배포나 광고 배포를 통한 도달을 계산합니다. 소셜 정보는 누군가 회원님의 페이지, 게시물 또는 스토리에 반응을 보이면 피드에 표시됩니다. 도달이 일반 배포와 광고 배포 모두로부터 발생한 경우에는 한 번만 집계됩니다. 이 지표는 추산치 및 개발 중입니다.	day, week, days_28
`page_impressions_nonviral*`	Facebook 페이지 및 페이지 콘텐츠가 화면에 표시된 횟수(소셜 정보가 연결된 상태로 표시된 경우는 제외). 소셜 정보는 누군가 회원님의 페이지, 게시물 또는 스토리에 반응을 보이면 피드에 표시됩니다. 이 지표는 개발 중입니다.	day, week, days_28
`page_impressions_nonviral_unique*`	이 지표는 Facebook 페이지 및 페이지 콘텐츠의 일반 배포나 광고 배포를 통한 도달을 계산합니다(소셜 정보가 연결된 상태로 표시된 경우는 제외). 소셜 정보는 누군가 회원님의 페이지, 게시물 또는 스토리에 반응을 보이면 피드에 표시됩니다. 도달이 일반 배포와 광고 배포 모두로부터 발생한 경우에는 한 번만 집계됩니다. 이 지표는 추산치 및 개발 중입니다.	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*`	광고로 인해 Facebook 페이지 및 페이지 콘텐츠가 화면에 표시된 횟수.	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*`	이 지표는 회원님의 Facebook 콘텐츠가 리포스트 또는 스토리로 공유된 경우 도달을 집계합니다. 공유를 통한 도달은 일반 배포에만 집계됩니다. 이 지표는 추산치 및 개발 중입니다.	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`	페이지를 좋아한 사람들에 대해 집계된 도시별 Facebook 위치 데이터.	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`	그래프 API v18 이상 사용 중단됨: 페이지 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_paid`	그래프 API v18 이상 사용 중단됨: 페이지의 홍보 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 동영상이 노출될 때마다 동영상 조회가 별도로 집계되며 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_organic`	그래프 API v18 이상 사용 중단됨: 일반 도달에 의해 페이지 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_autoplayed`	그래프 API v18 이상 사용 중단됨: 페이지 동영상이 10초 이상 자동 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_click_to_play`	그래프 API v18 이상 사용 중단됨: 사람들이 재생을 클릭한 후 페이지 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_unique`	그래프 API v18 이상 사용 중단됨: 페이지 동영상을 10초 이상 조회했거나, 길이가 10초 미만인 경우 전체 동영상을 거의 대부분 조회한 사람 수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	day, week, days_28
`page_video_views_10s_repeat`	그래프 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`	사람들이 동영상을 조회한 평균 시간(밀리초). 2016년 8월 25일 이후에 생성된 동영상에 대해서만 이 데이터를 볼 수 있습니다. 재공유된 동영상의 경우 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`	그래프 API v18 이상 사용 중단됨: 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	lifetime, day
`post_video_views_10s_unique`	그래프 API v18 이상 사용 중단됨: 동영상을 10초 이상 조회했거나, 길이가 10초 미만인 경우 전체 동영상을 거의 대부분 조회한 사람 수. 동영상이 노출될 때마다 동영상 조회가 별도로 집계되며 동영상을 다시 재생한 시간은 제외됩니다.	lifetime
`post_video_views_10s_autoplayed`	그래프 API v18 이상 사용 중단됨: 동영상이 10초 이상 자동 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	lifetime
`post_video_views_10s_clicked_to_play`	그래프 API v18 이상 사용 중단됨: 사람들이 재생을 클릭한 후 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	lifetime
`post_video_views_10s_organic`	그래프 API v18 이상 사용 중단됨: 일반 도달에 의해 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 단일 동영상 재생 인스턴스에서 동영상을 다시 재생한 시간은 제외됩니다.	lifetime
`post_video_views_10s_paid`	그래프 API v18 이상 사용 중단됨: 홍보 동영상이 10초 이상 재생되었거나, 길이가 10초 미만인 경우 전체 동영상이 거의 대부분 재생된 횟수. 동영상이 노출될 때마다 동영상 조회가 별도로 집계되며 동영상을 다시 재생한 시간은 제외됩니다.	lifetime, day
`post_video_views_10s_sound_on`	그래프 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*`	현재 라이브 방송을 시청 중인 시청자 수. 이 지표는 라이브 방송 게시물에 대해서만 반환되며, 라이브 방송이 종료된 게시물에 대해서는 0을 반환합니다.
`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 가이드를 확인하세요.

오류 코드

오류	설명
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

만들기

이 엔드포인트에서 수행할 수 없는 작업입니다.

업데이트 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

삭제 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

Page Insights

읽기

새로운 페이지 환경

Limitations

Requirements

Example

Single Metric Sample Request

Multiple Metric Sample Request

Metrics

Page Content

Tab Types

Page CTA Clicks

Page Engagement

Page Impressions

Page Posts

Page Post Engagement

Negative Feedback Types

Page Post Impressions

Page Post Reactions

Page Reactions

Page User Demographics

Page Like Sources

Page Video Views

Page Views

Page Video Posts

Stories

Page Story Types

Video Ad Breaks

매개변수

필드

data

paging

오류 코드

만들기

업데이트 중

삭제 중

See Also

`data`

`paging`