グラフ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.

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を使用する方法については、グラフ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.

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

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*

あなたの広告を最低1回見たアカウントセンター内アカウントの数です。リーチは、同じアカウントセンター内アカウントが広告を複数回見た場合もカウントに含まれる可能性があるインプレッションとは異なります。 この指標は推定値です。

day, week, days_28

page_impressions_viral*

あなたのページのコンテンツ、またはあなたのページに関するコンテンツがソーシャル情報を伴って利用者の画面に表示された回数。ソーシャル情報は、利用者の友達があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際に表示されます。アクションには、ページへの「いいね!」やページのフォロー、投稿へのリアクション、ページ上の写真のシェアやページへのチェックインなども含まれます。 この指標は開発中です。

day, week, days_28

page_impressions_viral_unique*

この指標では、あなたのFacebookページやページのコンテンツからのオーガニック配信またはペイド配信によるリーチのうち、ソーシャル情報を伴ってコンテンツが表示された場合をカウントします。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。オーガニックとペイドの配信両方でリーチが発生した場合、カウントされるのは1件のみです。 この指標は推定値開発中です。

day, week, days_28

page_impressions_nonviral*

あなたのFacebookページやページのコンテンツが利用者の画面に表示された回数。ソーシャル情報を伴うコンテンツは含まれません。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。 この指標は開発中です。

day, week, days_28

page_impressions_nonviral_unique*

この指標では、あなたのFacebookページやページのコンテンツからのオーガニック配信またはペイド配信によるリーチをカウントします。ソーシャル情報を伴って表示されたコンテンツは含まれません。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。オーガニックとペイドの配信両方でリーチが発生した場合、カウントされるのは1件のみです。 この指標は推定値開発中です。

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*

広告によってページの投稿を最低1回見たアカウントセンター内アカウントの数です。

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*

ページの投稿が画面に表示された人の数です。あなたのページに関して作成されたソーシャル情報を伴うコンテンツは含まれません。オーガニック配信の1つの形として、利用者の友達があなたのページや投稿に対してアクションを実行した際にソーシャル情報が表示されます。アクションには、ページへの「いいね!」やページのフォロー、投稿へのリアクション、ページ上の写真のシェアやページへのチェックインなども含まれます。

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*

広告によって投稿を最低1回見たアカウントセンター内アカウントの数です。 この指標は推定値です。

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*

この指標では、あなたのFacebookページやページのコンテンツからのオーガニック配信またはペイド配信によるリーチをカウントします。ソーシャル情報を伴って表示されたコンテンツは含まれません。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。オーガニックとペイドの配信両方でリーチが発生した場合、カウントされるのは1件のみです。 この指標は推定値開発中です。

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*

ページ投稿の「いいね!」の合計数(1日)です。

day, week, days_28

page_actions_post_reactions_love_total*

ページ投稿の「超いいね!」の合計数(1日)です。

day, week, days_28

page_actions_post_reactions_wow_total*

ページ投稿の「すごいね」の1日の合計数です。

day, week, days_28

page_actions_post_reactions_haha_total*

ページ投稿の「うけるね」の合計数(1日)です。

day, week, days_28

page_actions_post_reactions_sorry_total*

1日: ページ投稿の「悲しいね」の合計数です。

day, week, days_28

page_actions_post_reactions_anger_total*

ページ投稿への「ひどいね」のリアクションの1日の合計数です。

day, week, days_28

page_actions_post_reactions_total

1日: タイプ別のページ投稿のリアクションの合計数です。

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秒未満の動画の場合、ほぼ最後まで再生された回数。1回の動画再生中、リプレイにかかった時間は除外されます。

day, week, days_28

page_video_views_by_uploaded_hosted*

ページレベルの1日の動画再生数の、ページにアップロードされた全バリエーションおよびページにホスティングされた全バリエーション別の内訳です。

day, week, days_28

page_video_views_paid

ページで宣伝された動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数。動画の再生はインプレッションごとに個別にカウントされ、リプレイ時間は除外されます。

day, week, days_28

page_video_views_organic

オーガニックリーチによりページの動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数。1回の動画再生中、リプレイにかかった時間は除外されます。

day, week, days_28

page_video_views_by_paid_non_paid*

ページの動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数の合計、広告、オーガニック別の内訳。1回の動画再生中のリプレイ時間は除外されます。

day, week, days_28

page_video_views_autoplayed

ページの動画が自動で3秒以上(3秒より短い動画の場合はそのほぼ全て)再生された回数です。1つの動画内で同じ部分をリプレイした時間は除外されます。

day, week, days_28

page_video_views_click_to_play

再生をクリックしてページの動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数。1回の動画再生中のリプレイ時間は除外されます。

day, week, days_28

page_video_views_unique

ページの動画を3秒以上再生した人数、または3秒未満の動画の場合、ほぼ最後まで再生した人数。1回の動画再生中のリプレイ時間は除外されます。

day, week, days_28

page_video_repeat_views

ページの動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数です。

day, week, days_28

page_video_complete_views_30s

ページの動画が30秒以上再生された回数、または30秒未満の動画の場合、ほぼ最後まで再生された回数。1回の動画再生中のリプレイ時間は除外されます。

day, week, days_28

page_video_complete_views_30s_paid

ページで宣伝された動画が30秒以上再生された回数、または30秒未満の動画の場合、ほぼ最後まで再生された回数。動画の再生はインプレッションごとに個別にカウントされ、リプレイ時間は除外されます。

day, week, days_28

page_video_complete_views_30s_organic

オーガニックリーチによりページの動画が30秒以上再生された回数、または30秒未満の動画の場合、ほぼ最後まで再生された回数です。1回の動画再生中のリプレイ時間は除外されます。

day, week, days_28

page_video_complete_views_30s_autoplayed

ページの動画が自動で30秒以上(30秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

day, week, days_28

page_video_complete_views_30s_click_to_play

再生をクリックしてページの動画が30秒以上再生された回数、または30秒未満の動画の場合、ほぼ最後まで再生された回数。1回の動画再生中、リプレイにかかった時間は除外されます。

day, week, days_28

page_video_complete_views_30s_unique

ページの動画を30秒以上再生した人数、または30秒未満の動画の場合、ほぼ最後まで再生した人数。1回の動画再生中のリプレイ時間は除外されます。

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秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。再シェアされた動画では0となります。

lifetime

post_video_complete_views_30s_clicked_to_play

再生をクリックした後に動画が30秒以上(30秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。再シェアされた動画では0となります。

lifetime

post_video_complete_views_30s_organic

オーガニックリーチにより動画が30秒以上(30秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。再シェアされた動画では0となります。

lifetime

post_video_complete_views_30s_paid

宣伝された動画が30秒以上(30秒より短い動画の場合はそのほぼ全て)再生された回数。動画の再生はインプレッションごとに個別にカウントされ、リプレイ時間は除外されます。再シェアされた動画では0となります。

lifetime

post_video_complete_views_30s_unique

動画を30秒以上(3秒より短い動画の場合はそのほぼ全て)再生した人数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

page_video_views_10s

グラフAPI v18より後のバージョンでは利用できません: ページの動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

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秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

day, week, days_28

page_video_views_10s_autoplayed

グラフAPI v18より後のバージョンでは利用できません: ページの動画が自動で10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

day, week, days_28

page_video_views_10s_click_to_play

グラフAPI v18より後のバージョンでは利用できません: 再生をクリックした後にページの動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

day, week, days_28

page_video_views_10s_unique

グラフAPI v18より後のバージョンでは利用できません: ページの動画を10秒以上(10秒より短い動画の場合はそのほぼすべて)再生した人数。1つの動画内で同じ部分をリプレイした時間は除外されます。

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%以上再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。再シェアされた動画では0となります。

lifetime

post_video_complete_views_organic_unique

オーガニックリーチにより動画を最初から全体の97%以上再生した人数。1つの動画内で同じ部分をリプレイした時間は除外されます。再シェアされた動画では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秒未満の動画はほぼすべて)再生された回数。ただし1度の閲覧でリプレイした場合、2回目以降はカウントされません。

lifetime, day

post_video_views_organic_unique

オーガニックリーチにより動画を3秒以上(3秒より短い動画の場合はそのほぼ全て)再生した人数。1つの動画内で同じ部分をリプレイした時間は除外されます。

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秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。これにはライブ再生も含まれます。

lifetime, day

post_video_views_unique

動画を3秒以上(3秒より短い動画の場合はそのほぼすべて)再生した人数。1回の動画再生中のリプレイ時間は除外されます。

day, lifetime

post_video_views_autoplayed

動画が自動で3秒以上(3秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_clicked_to_play

再生をクリックした後に動画が3秒以上(3秒より短い動画の場合はそのほぼ全て)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_15s*

動画が15秒以上(15秒より短い動画の場合はそのほぼ全て)再生された回数。1回の動画再生中、リプレイにかかった時間は除外されます。

lifetime

post_video_views_60s_excludes_shorter*

動画が60秒以上再生された回数です。この指標は60秒以上再生された動画のみカウントします。1回の動画再生中のリプレイ時間は除外されます。

lifetime, day

post_video_views_10s

グラフAPI v18より後のバージョンでは利用できません: 動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime, day

post_video_views_10s_unique

グラフAPI v18より後のバージョンでは利用できません: 動画を10秒以上(10秒より短い動画の場合はそのほぼすべて)再生した人数。動画の再生はインプレッションごとに個別にカウントされ、リプレイ時間は除外されます。

lifetime

post_video_views_10s_autoplayed

グラフAPI v18より後のバージョンでは利用できません: 動画が自動で10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_10s_clicked_to_play

グラフAPI v18より後のバージョンでは利用できません: 再生をクリックした後に動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_10s_organic

グラフAPI v18より後のバージョンでは利用できません: オーガニックリーチにより動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_10s_paid

グラフAPI v18より後のバージョンでは利用できません: 宣伝された動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)再生された回数。動画の再生はインプレッションごとに個別にカウントされ、リプレイ時間は除外されます。

lifetime, day

post_video_views_10s_sound_on

グラフAPI v18より後のバージョンでは利用できません: 動画が10秒以上(10秒より短い動画の場合はそのほぼすべて)音声付きで再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

lifetime

post_video_views_sound_on

動画が3秒以上(3秒より短い動画の場合はそのほぼ全て)音声付きで再生された回数。1つの動画内で同じ部分をリプレイした時間は除外されます。

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ガイドをご覧ください。

エラーコード

エラー詳細
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