Represents insights for Facebook Pages and Page posts. Refer to our Pages API documentation.
On March 14, 2024, a number of the Page Insights metrics were deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics. Read our blog to learn more.
Get metrics for Pages or Page posts.
period
are calculated from the initial collection of the data point.since
and until
parameters. since
and until
, the since
date data will be included in the first value
returned.viral_unique
and organic_unique
.3001
, with subcode 1504028
and an error message that states: "No metric was specified to be fetched. Please specify one or more metrics to be fetched and try again."Type | Description |
---|---|
A Page access token requested by a person who can perform the ANALYZE task on the Page. | |
Not applicable. | |
| |
GET v21.0/{object-id}/insights/{metric} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->get(
'{object-id}/insights/{metric}',
'{access-token}'
);
} catch(Facebook\Exceptions\FacebookResponseException $e) {
echo 'Graph returned an error: ' . $e->getMessage();
exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
echo 'Facebook SDK returned an error: ' . $e->getMessage();
exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
"{object-id}/insights/{metric}",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"{object-id}/insights/{metric}",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"{object-id}/insights/{metric}"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
NOTE: If your request times out or some metrics are not returned, try reducing the number of metrics in your API request.
GET v21.0/{object-id}/insights?metric={metric-1},{metric-2},{metric-3},... HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->get(
'{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...',
'{access-token}'
);
} catch(Facebook\Exceptions\FacebookResponseException $e) {
echo 'Graph returned an error: ' . $e->getMessage();
exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
echo 'Facebook SDK returned an error: ' . $e->getMessage();
exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},...",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"{object-id}/insights?metric={metric-1},{metric-2},{metric-3},..."
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Metric names indicate whether a metric is for a Page or a Page post.
Suffix | Description |
---|---|
| Indicates that the metric shows the number of unique users who performed a specific action, for example |
| Indicates whether a person was logged into Facebook, for example, |
| Indicates whether a person is logged out of Facebook, for example |
| Indicates that the metric will be broken down into a list of referral sources, for example |
| Indicates that a metric is refreshed several times during the day, for example |
Most of the metrics below can be retrieved using post_activity_by_action_type
, post_clicks_by_type
, and page_consumptions_by_consumption_type
.
Metric Name | Description | Values for `period` |
---|---|---|
page_tab_views_login_top_unique | 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 for Page content metrics.
Name | Description |
---|---|
allactivity | Administrative tab |
app | Custom created tab |
info | About tab view |
insights | Insights tab |
likes | Likes tab |
locations | Map tab |
photos | Photos tab |
photos_albums | Photos tab |
photos_stream | Photos tab |
profile | Pages timeline |
profile_info | Info tab |
profile_likes | Likes tab |
profile_photos | Photos tab |
timeline | Pages timeline |
events | Events tab |
videos | Videos tab |
wall | Timeline |
Metric Name | Description | Values for `period` |
---|---|---|
page_total_actions | ページの連絡先情報とコールトゥアクションボタンのクリック数。 | day, week, days_28 |
The "like" reaction counts include both "like" and "care" reactions.
Metric Name | Description | Values for `period` |
---|---|---|
page_post_engagements* | 投稿でリアクションやコメント、シェアなどのアクションが実行された回数です。 | day, week, days_28 |
page_fan_adds_by_paid_non_paid_unique | 初めてページに「いいね!」したアカウントセンター内アカウントの数です。ページの「いいね!」がペイドコンテンツとオーガニックコンテンツのどちらに起因するものかに基づいて分類されます。 この指標は推定値です。 | day |
page_lifetime_engaged_followers_unique* | ページのフォロワーのうち、過去14日間に1件以上のライブ動画または録画された動画を少なくとも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 |
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* | day, week, days_28 | |
page_impressions_nonviral* | あなたのFacebookページやページのコンテンツが利用者の画面に表示された回数。ソーシャル情報を伴うコンテンツは含まれません。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。 この指標は開発中です。 | day, week, days_28 |
page_impressions_nonviral_unique* | day, week, days_28 |
Metric Name | Description | Values for `period` |
---|---|---|
page_posts_impressions* | あなたのページの投稿が利用者の画面に表示された回数。投稿には、ステータス、写真、リンク、動画なども含まれます。 | day, week, days_28 |
page_posts_impressions_unique* | あなたのページの投稿が画面に表示された人の数。投稿には、ステータス、写真、リンク、動画なども含まれます。 | day, week, days_28 |
page_posts_impressions_paid* | 広告により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 |
Metric Name | Description | Values for `period` |
---|---|---|
post_clicks* | ストーリーズの生成なしで投稿がクリックされた回数です。 | lifetime |
post_clicks_by_type* | ストーリーズの生成なしで投稿がクリックされた回数(消費タイプ別)です。 | lifetime |
Negative feedback types for page_negative_feedback_by_type
metrics.
Name | Description |
---|---|
hide_clicks | Hide this story |
hide_all_clicks | Hide all posts from this page |
report_spam_clicks | Report an object as a spam |
unlike_page_clicks | Unlike a page |
Metric Name | Description | Values for `period` |
---|---|---|
post_impressions* | あなたのページの投稿が利用者の画面に表示された回数。投稿には、ステータス、写真、リンク、動画なども含まれます。 | lifetime |
post_impressions_unique* | あなたのページの投稿が画面に表示された人の数。投稿には、ステータス、写真、リンク、動画なども含まれます。 この指標は推定値です。 | lifetime |
post_impressions_paid* | 広告によりあなたのページのコンテンツが利用者の画面に表示された回数。 | lifetime |
post_impressions_paid_unique* | 広告によって投稿を最低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* | lifetime | |
post_impressions_nonviral* | あなたのページのコンテンツが利用者の画面に表示された回数。ソーシャル情報を伴って表示されたコンテンツは含まれません。ソーシャル情報は、利用者があなたのページ、投稿、ストーリーズのいずれかに対してアクションを実行した際にフィードに表示されます。 この指標は開発中です。 | lifetime |
post_impressions_nonviral_unique* | lifetime |
The "like" reaction counts include both "like" and "care" reactions.
Metric Name | Description | Values for `period` |
---|---|---|
post_reactions_like_total | 投稿への「いいね!」の合計数です。 | lifetime |
post_reactions_love_total | 投稿への「超いいね!」の合計数です。 | lifetime |
post_reactions_wow_total | 投稿への「すごいね」の合計数です。 | lifetime |
post_reactions_haha_total | 投稿への「うけるね」の合計数です。 | lifetime |
post_reactions_sorry_total | 投稿への「悲しいね」の合計数です。 | lifetime |
post_reactions_anger_total | 投稿への「ひどいね」の合計数です | lifetime |
post_reactions_by_type_total | 投稿のリアクションのタイプ別合計数。 | lifetime |
The "like" reaction counts include both "like" and "care" reactions.
Metric Name | Description | Values for `period` |
---|---|---|
page_actions_post_reactions_like_total* | ページ投稿の「いいね!」の合計数(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 |
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 |
Source types for page_fans_by_like_source
and page_fans_by_like_source_unique
metrics.
Name | Description |
---|---|
Ads | Page likes that came from people who saw your Page or post in an ad. |
News Feed | Page likes that came from people who saw content posted by your Page or about your Page in News Feed. |
Page Suggestions | Page likes that came from people saw your Page in a list of suggested Pages. |
Restored Likes from Reactivated Accounts | Page likes that came from people who reactivated their Facebook profile. |
Search | Page likes that came from people who saw you Page or post in search. |
Your Page | Page likes that came from people who visited your Page. |
Metric Name | Description | Values for `period` |
---|---|---|
page_video_views | ページの動画が3秒以上再生された回数、または3秒未満の動画の場合、ほぼ最後まで再生された回数。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. |
Metric Name | Description | Values for `period` |
---|---|---|
page_views_total* | ログインしている人とログインしていない人がページのプロフィールを見た回数です。 | day, week, days_28 |
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 |
Page and Post Stories and "People talking about this".
Metric Name | Description | Values for `period` |
---|---|---|
post_activity_by_action_type* | ページ投稿について作成されたアクションタイプ別のストーリーズの数。 | lifetime |
post_activity_by_action_type_unique* | あなたのページ投稿に関するストーリーズを作成した人をアクションタイプ別に示した人数。 | lifetime |
Name | Description |
---|---|
checkin | Page checkins |
coupon | Offer claims |
event | RSVPing to event |
fan | Page likes |
mention | Page mentions |
page post | Posts by a Page |
question | Question answers |
user post | Posts by people on a Page |
other | Other types |
Metric Name | Description | Values for period |
---|---|---|
| The total number of times an ad was shown during ad breaks in crossposted videos. | day |
| The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook. | day |
| An estimate of the amount you earned from ad breaks in a crossposted videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments. | day |
| The total number of times an ad was shown during ad breaks in your videos. | day, lifetime |
| An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments. | day, lifetime |
| The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook. | day, lifetime |
| The number of views of your videos that will receive a payout. To qualify for payout, your Page or profile must generate ad revenue in the current earning period. You must also be following the Partner Monetization Policies and Content Monetization Policies. There are additional factors which may disqualify a view for payout. | day,lifetime |
パラメーター | 説明 |
---|---|
breakdown list<A valid breakdown for an insights endpoint> | breakdown for marketing messages metrics. This is currently in development. |
date_preset enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year} | Preset a date range, like lastweek, yesterday. If since or until presents, it does not work. |
metric list<A valid metric for an insights endpoint> | The list of metrics that needs to be fetched |
period enum {day, week, days_28, month, lifetime, total_over_range} | The aggregation period |
show_description_from_api_doc boolean | デフォルト値: false If set to true, then an additional description of the metric, retrieved from the API doc(https://developers.facebook.com/docs/graph-api/reference/insights) will be included in the returned data |
since datetime | Lower bound of the time range to consider |
until datetime | Upper bound of the time range to consider |
このエッジからの読み込むではJSONフォーマットの結果が返されます:
{ "
data
": [], "paging
": {} }
data
paging
エラー | 詳細 |
---|---|
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
200 | Permissions error |
80001 | There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
3001 | Invalid query |
104 | Incorrect signature |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
2500 | Error parsing graph query |