sessionがない場合、アプリケーションは自身の統計しか見ることができません。ユーザセッションがある場合、そのユーザが管理しているアプリケーション、ページ、ドメインの情報を取得できます。これらのデータを得るには、read_insightsパーミッションが必要です。
テーブルからmetricsを取得するには、object_id、end_timeとperiodで指定する期間、metricを指定しなくてはいけません。
Columns
| Indexable | Name | Type | Description |
|---|---|---|---|
| * | object_id | int | 情報を取得する対象のobject id |
| * | metric | string | 取得する情報 |
| * | end_time | int | 測定する対象期間の終了時期のUnixタイムスタンプ。 |
| * | period | int | 測定する期間の秒数。 |
| value | mixed | 測定する対象の値 |
Examples
SELECT metric, value FROM insights WHERE object_id=111605505520003 AND metric='page_like_adds' AND end_time=1272351600 AND period=86400
SELECT metric, value FROM insights WHERE object_id=111605505520003 AND metric='page_like_adds' AND end_time=end_time_date('2010-04-26') AND period=period('day')
Usage Notes
- insightsはページ、アプリケーション、ドメインを対象に30以上のconnectionに対して扱うことができます。
end_timeの値は、Pacific Daylight Timeの深夜0時が指定されているべきです。- end_time_date()という特殊な関数があり、end_timeフィールドに使うことができます。この関数にYYYY-MM-DD形式の日時を渡すと、適切に置き換えられたend_time値を返します。
- 指定可能な期間は、一日(86400),一週間(
2592000),全期間(0)です。全測定対象に関して上記全部が当てはまるわけではありません。 - period()という特殊関数があり、periodフィールドの指定に使えます。この関数に渡せる値は
'day','week','month','lifetime'のうちの一つで、指定した期間に相当する秒数を返します。 - 9月15日の00:00（深夜12時）から始まり、16日の00:00に終わる24時間のデータを収集するには、
1284620400をend_timeに指定し、86400をperiodに指定します。 - _uniqueサフィックスは、それが特定の行動を起こしたユニークユーザの数であることを示しています。
- _loginと_logoutサフィックスは、Facebookにログインしているユーザとログインしていないユーザのページビューを示しています。
- _sourceサフィックスは、測定値がリンク元のリストで成り立っていることを示しています。外部からの流入はドメイン毎に分けられます。内部からの流入であれば、'Profile', 'Search', 'Requests', 'Suggestions', 'Stream', その他などのFacebook特有の区分に分けられます。
Metrics
Application Users
application_active_users
Available Periods(指定可能な期間): day, week, month1, 7, 30日スパンでの、アプリケーションを利用もしくは閲覧したユーザのカウント。
application_active_users_locale
Available Periods: dayアクティブユーザの主要なロケール情報
application_active_users_city
Available Periods: dayアクティブユーザの主要な都市
application_active_users_country
Available Periods: dayアクティブユーザの主要な国
application_active_users_gender
Available Periods: dayアクティブユーザの性別
application_active_users_age
Available Periods: dayアクティブユーザの年齢
application_active_users_gender_age
Available Periods: dayアクティブユーザの年齢／性別層
application_installed_users
Available Periods: lifetimeFacebookアプリケーションのインストール数もしくは、webサイトへのConnect数
application_installed_users_locale
Available Periods: lifetimeアプリケーションをインストールしたユーザのロケール
application_installed_users_city
Available Periods: lifetimeアプリケーションをインストールしたユーザの都市
application_installed_users_country
Available Periods: lifetimeアプリケーションをインストールしたユーザの国
application_installed_users_gender
Available Periods: lifetimeアプリケーションをインストールしたユーザの性別
application_installed_users_age
Available Periods: lifetimeアプリケーションをインストールしたユーザの年齢
application_installed_users_gender_age
Available Periods: lifetimeアプリケーションをインストールしたユーザの年齢／性別層
application_installation_adds
Available Periods: dayFacebookアプリケーションの新規インストール数、もしくはwebサイトへの新規Connect数。
application_installation_adds_unique
Available Periods: dayFacebookアプリケーションの新規インストール数、もしくはwebサイトへの新規Connect数。（訳注：上記application_installation_addsの説明内容と全く同じ内容しか書かれていません。）
application_installation_removes
Available Periods: dayインストールの削除、もしくはwebサイトへのConnectの削除数。
application_installation_removes_unique
Available Periods: dayインストールの削除、もしくはwebサイトへのConnectの削除数。（訳注：上記application_installation_removesの説明内容と全く同じ内容しか書かれていません。）
application_tos_views
Available Periods: dayアプリケーション利用規約のインプレッション
application_tos_views_unique
Available Periods: dayアプリケーション利用規約のインプレッション
application_permission_views_top
Available Periods: dayパーミッション ダイアログのインプレッション
application_permission_views_top_unique
Available Periods: dayパーミッション ダイアログのインプレッション
application_permission_grants_top
Available Periods: dayパーミッション ダイアログのインプレッション
application_permission_grants_top_unique
Available Periods: dayパーミッション ダイアログのインプレッション
application_block_adds
Available Periods: dayアプリケーションのブロック数
application_block_adds_unique
Available Periods: dayアプリケーションのブロック数
application_block_removes
Available Periods: dayアプリケーションのブロック解除数
application_block_removes_unique
Available Periods: dayアプリケーションのブロック解除数
Application Content
application_like_adds
Available Periods: dayアプリケーション経由で作成されたlike数
application_like_adds_unique
Available Periods: dayアプリケーション経由で作成されたlike数
application_like_removes
Available Periods: dayアプリケーション経由で削除されたlike数
application_like_removes_unique
Available Periods: dayアプリケーション経由で削除されたlike数
application_comment_adds
Available Periods: dayアプリケーション経由で作成されたコメント数
application_comment_adds_unique
Available Periods: dayアプリケーション経由で作成されたコメント数
application_photos
Available Periods: dayアプリケーション経由で作成された写真数
application_photos_unique
Available Periods: dayアプリケーション経由で作成された写真数
application_shares
Available Periods: dayアプリケーション経由でLinks.postメソッドを用いて作成されたShare数
application_shares_unique
Available Periods: dayアプリケーション経由でLinks.postメソッドを用いて作成されたShare数
application_status_updates
Available Periods: dayアプリケーション経由で更新されたステータス数
application_status_updates_unique
Available Periods: dayアプリケーション経由で更新されたステータス数
application_stream_stories
Available Periods: dayアプリケーション経由でstream.publishで作成されたストーリー数
application_stream_stories_unique
Available Periods: dayアプリケーション経由でstream.publishで作成されたストーリー数
application_feed_form_views
Available Periods: dayFeedダイアログのインプレッション
application_feed_form_views_unique
Available Periods: dayFacebookログインユーザのFeedダイアログインプレッション
application_feed_form_views_login
Available Periods: dayFacebookログインユーザのFeedダイアログインプレッション
application_feed_form_views_login_unique
Available Periods: dayFacebookログインユーザのFeedダイアログインプレッション
application_feed_form_views_logout
Available Periods: dayFacebookにログインしていないユーザのFeedダイアログインプレッション
Plugins
application_widget_activity_views
Available Periods: dayactivity pluginのインプレッション
application_widget_activity_views_unique
Available Periods: dayFacebookログインユーザのactivity pluginのインプレッション
application_widget_activity_views_login
Available Periods: dayFacebookログインユーザのactivity pluginのインプレッション
application_widget_activity_views_login_unique
Available Periods: dayFacebookログインユーザのactivity pluginのインプレッション
application_widget_activity_views_logout
Available Periods: dayFacebookにログインしていないユーザのactivity pluginのインプレッション
application_widget_activity_views_external_referrals
Available Periods: dayActivity pluginsインプレッションの主要なドメイン
application_widget_comments_views
Available Periods: dayComments pluginのインプレッション
application_widget_comments_views_unique
Available Periods: dayFacebookログインユーザのComments pluginのインプレッション
application_widget_comments_views_login
Available Periods: dayFacebookログインユーザのComments pluginのインプレッション
application_widget_comments_views_login_unique
Available Periods: dayFacebookログインユーザのComments pluginのインプレッション
application_widget_comments_views_logout
Available Periods: dayFacebookにログインしていないユーザのComments pluginのインプレッション
application_widget_fan_views
Available Periods: dayLike Boxのインプレッション
application_widget_fan_views_unique
Available Periods: dayFacebookログインユーザのLike Boxインプレッション
application_widget_fan_views_login
Available Periods: dayFacebookログインユーザのLike Boxインプレッション
application_widget_fan_views_login_unique
Available Periods: dayFacebookログインユーザのLike Boxインプレッション
application_widget_fan_views_logout
Available Periods: dayFacebookにログインしていないユーザのLike Boxインプレッション
application_widget_fan_views_external_referrals
Available Periods: dayLike Box pluginsインプレッションの主要ドメイン
application_widget_like_views
Available Periods: dayLike pluginのインプレッション
application_widget_like_views_unique
Available Periods: dayFacebookログインユーザのLike Buttonインプレッション
application_widget_like_views_login
Available Periods: dayFacebookログインユーザのLike Buttonインプレッション
application_widget_like_views_login_unique
Available Periods: dayFacebookログインユーザのLike Buttonインプレッション
application_widget_like_views_logout
Available Periods: dayFacebookにログインしていないユーザのLike Buttonインプレッション
application_widget_like_views_external_referrals
Available Periods: dayLike pluginインプレッションの主要ドメイン
application_widget_live_stream_views
Available Periods: dayLive Stream pluginのインプレッション
application_widget_live_stream_views_unique
Available Periods: dayFacebookログインユーザのLive Stream pluginインプレッション
application_widget_live_stream_views_login
Available Periods: dayFacebookログインユーザのLive Stream pluginインプレッション
application_widget_live_stream_views_login_unique
Available Periods: dayFacebookログインユーザのLive Stream pluginインプレッション
application_widget_live_stream_views_logout
Available Periods: dayログインユーザのLive Stream pluginインプレッション（訳注：『ログインユーザの』とドキュメントにありますが、未ログインユーザの間違いかと思います。）
application_widget_live_stream_views_external_referrals
Available Periods: dayLive Stream pluginインプレッションの主要ドメイン
application_widget_recommendation_views
Available Periods: dayRecommendation pluginのインプレッション
application_widget_recommendation_views_unique
Available Periods: dayFacebookログインユーザのRecommendation pluginのインプレッション
application_widget_recommendation_views_login
Available Periods: dayFacebookログインユーザのRecommendation pluginのインプレッション
application_widget_recommendation_views_login_unique
Available Periods: dayFacebookログインユーザのRecommendation pluginのインプレッション
application_widget_recommendation_views_logout
Available Periods: dayFacebookにログインしていないユーザのRecommendation pluginのインプレッション
application_widget_recommendation_views_external_referrals
Available Periods: dayRecommendation pluginインプレッションの主要なドメイン
application_widget_share_views
Available Periods: dayFacebookログインユーザのShareボタンインプレッション
application_widget_share_views_unique
Available Periods: dayFacebookログインユーザのShareボタンインプレッション
application_widget_views
Available Periods: day全ソーシャルプラグインのインプレッション
application_widget_views_unique
Available Periods: dayFacebookログインユーザの全ソーシャルプラグインのインプレッション
application_widget_views_login
Available Periods: dayFacebookログインユーザの全ソーシャルプラグインのインプレッション
application_widget_views_login_unique
Available Periods: dayFacebookログインユーザの全ソーシャルプラグインのインプレッション
application_widget_views_logout
Available Periods: dayFacebookにログインしていないユーザの全ソーシャルプラグインのインプレッション
Canvas
application_canvas_views
Available Periods: dayアプリケーションのキャンバスページのインプレッション数
application_canvas_views_unique
Available Periods: dayFacebookログインユーザの、アプリケーションのキャンバスページのインプレッション数
application_canvas_views_login
Available Periods: dayFacebookログインユーザの、アプリケーションのキャンバスページのインプレッション数
application_canvas_views_login_unique
Available Periods: dayFacebookログインユーザの、アプリケーションのキャンバスページのインプレッション数
application_canvas_views_logout
Available Periods: dayFacebookにログインしていないユーザの、アプリケーションのキャンバスページのインプレッション数
application_canvas_views_internal_referrals
Available Periods: dayFacebook内からキャンバスページへの主要な参照元
application_canvas_views_external_referrals
Available Periods: day外部ドメインからキャンバスページへの主要な参照元
Tabs
application_tab_views
Available Periods: dayユーザのプロフィールページにあるアプリケーションタブのインプレッション
application_tab_views_unique
Available Periods: dayユーザのプロフィールページにあるアプリケーションタブのインプレッション
API Performance
application_api_calls
Available Periods: dayアプリケーションからの全API利用数
application_api_calls_top
Available Periods: dayアプリケーションからの主要なAPI利用数
application_api_calls_unique
Available Periods: dayアプリケーションからの全API利用数
application_api_errors
Available Periods: dayアプリケーションからのAPIエラー数
application_api_errors_top
Available Periods: dayアプリケーションからの主要なAPIエラー数
Page Users
page_active_users
Available Periods: day, week, monthページもしくはページ投稿の操作／閲覧した人の数。ファンや、そうではない人両方を含みます
page_active_users_locale
Available Periods: dayアクティブユーザのロケール
page_active_users_city
Available Periods: dayアクティブユーザの主要な都市
page_active_users_country
Available Periods: dayアクティブユーザの主要な国
page_active_users_gender
Available Periods: dayアクティブユーザの性別
page_active_users_age
Available Periods: dayアクティブユーザの年齢
page_active_users_gender_age
Available Periods: dayアクティブユーザの年齢／性別層
page_fans
Available Periods: lifetimeページをlikeした人の総数
page_fans_locale
Available Periods: lifetimeページをlikeしたユーザの言語設定で指定されている言語の情報
page_fans_city
Available Periods: lifetimeページをlikeしたユーザの、都市毎にソートしたロケーションデータ
page_fans_country
Available Periods: lifetimeページをlikeしたユーザの、国毎にソートしたロケーションデータ
page_fans_gender
Available Periods: lifetimeページをlikeしたユーザの性別
page_fans_age
Available Periods: lifetimeページをlikeしたユーザの年齢
page_fans_gender_age
Available Periods: lifetimeページをlikeしたユーザがプロフィールで設定している情報に基づいた年齢／性別層
page_fan_adds
Available Periods: dayページを新規でlikeした人の数
page_fan_adds_unique
Available Periods: dayページを新規でlikeした人の数
page_fan_adds_source
Available Periods: dayThis
is a breakdown of the number of Page likes from the most common places
where people can like your Page. Note: this does not include all areas
of Facebook where users can like your Page.page_fan_adds_source_unique
Available Periods: dayページをlikeできる箇所の中で、最もlikeされた場所の解析結果。注意：Facebook上での、ページをlikeできる箇所全部が含まれている訳ではありません。
page_fan_removes
Available Periods: dayページのlike削除
page_fan_removes_unique
Available Periods: dayページのlike削除
page_fan_removes_source
Available Periods: dayページのlike削除のソース
page_fan_removes_source_unique
Available Periods: dayページのlike削除のソース
Page Content
page_comment_adds
Available Periods: dayページのコンテンツ上で作成されたコメント
page_comment_adds_unique
Available Periods: dayページのコンテンツ上で作成されたコメント
page_comment_adds_source
Available Periods: dayページのコンテンツ上で新規に作成されたコメントのソース
page_comment_adds_source_unique
Available Periods: dayページのコンテンツ上で新規に作成されたコメントのソース
page_comment_removes
Available Periods: dayページのコンテンツ上で削除されたコメント
page_comment_removes_unique
Available Periods: dayページのコンテンツ上で削除されたコメント
page_comment_removes_source
Available Periods: dayページのコンテンツ上で削除されたコメントのソース
page_comment_removes_source_unique
Available Periods: dayページのコンテンツ上で削除されたコメントのソース
page_like_adds
Available Periods: dayページコンテンツのlike
page_like_adds_unique
Available Periods: dayページコンテンツのlike
page_like_adds_source
Available Periods: dayページコンテンツのlikeのソース
page_like_adds_source_unique
Available Periods: dayページコンテンツのlikeのソース
page_like_removes
Available Periods: dayページコンテンツのlike削除
page_like_removes_unique
Available Periods: dayページコンテンツのlike削除
page_like_removes_source
Available Periods: dayページコンテンツのlike削除のソース
page_like_removes_source_unique
Available Periods: dayページコンテンツのlike削除のソース
page_stream_views
Available Periods: dayページのNews Feed投稿を閲覧（ファン／ファンではない人含む）した回数
page_stream_views_unique
Available Periods: dayページのNews Feed投稿を閲覧（ファン／ファンではない人含む）した回数
page_wall_posts
Available Periods: dayページへのウォール投稿
page_wall_posts_unique
Available Periods: dayページへのウォール投稿
page_wall_posts_source
Available Periods: dayページへのウォール投稿のソース
page_wall_posts_source_unique
Available Periods: dayページへのウォール投稿のソース
page_photos
Available Periods: dayページへ投稿された写真
page_photos_unique
Available Periods: dayページへ投稿された写真
page_photo_views
Available Periods: dayページの写真が閲覧された回数
page_photo_views_unique
Available Periods: dayページの写真が閲覧された回数
page_videos
Available Periods: dayページへ投稿された動画
page_videos_unique
Available Periods: dayページへ投稿された動画
page_video_plays
Available Periods: dayページへ投稿された動画が再生された回数
page_video_plays_unique
Available Periods: dayページへ投稿された動画が再生された回数
page_audio_plays
Available Periods: dayページの音声ファイルが再生された回数
page_audio_plays_unique
Available Periods: dayページの音声ファイルが再生された回数
page_discussions
Available Periods: dayページのDiscussion Boardに作成されたDiscussion
page_discussions_unique
Available Periods: dayページのDiscussion Boardに作成されたDiscussion
page_review_adds
Available Periods: dayページに新規で寄せられたレビュー
page_review_adds_unique
Available Periods: dayページに新規で寄せられたレビュー
page_review_modifications
Available Periods: day既存のレビューで変更されたもの
page_review_modifications_unique
Available Periods: day既存のレビューで変更されたもの
Page Views
page_views
Available Periods: dayページビュー
page_views_unique
Available Periods: dayFacebookログインユーザのページビュー
page_views_login
Available Periods: dayFacebookログインユーザのページビュー
page_views_login_unique
Available Periods: dayFacebookログインユーザのページビュー
page_views_logout
Available Periods: dayFacebookにログインしていないユーザのページビュー
page_views_internal_referrals
Available Periods: dayFacebook内からページへの主要な参照元
page_views_external_referrals
Available Periods: dayFacebook外からページへの主要な参照元
Domain Users
domain_active_users_locale
Available Periods: dayURLもしくはドメインに関わったユーザのロケール
domain_active_users_city
Available Periods: dayURLもしくはDomainに関わったユーザの主要な都市
domain_active_users_country
Available Periods: dayURLもしくはDomainに関わったユーザの主要な国
domain_active_users_gender
Available Periods: dayURLもしくはDomainに関わったユーザの性別
domain_active_users_age
Available Periods: dayURLもしくはDomainに関わったユーザの年齢
domain_active_users_gender_age
Available Periods: dayURLもしくはDomainに関わったユーザの年齢／性別層
domain_fan_adds
Available Periods: dayドメイン中のURLに対するlike(※Open Graph必須)
domain_fan_removes
Available Periods: dayドメイン中のURLからのlike削除
Domain Content
domain_comment_adds
Available Periods: dayドメイン中URLのShareコメント
domain_like_adds
Available Periods: dayドメイン中URLのShareのLike
domain_like_removes
Available Periods: dayドメイン中URLのShareのlike削除
domain_shares
Available Periods: dayドメイン中URLのShare
domain_reshares
Available Periods: dayドメイン中URLの再Share
domain_widget_comments_adds
Available Periods: lifetime, dayComments pluginを用いてサイト上にコメント投稿された回数。
domain_widget_comments_views
Available Periods: lifetime, dayドメイン上でのComments Boxインプレッション
domain_widget_comments_feed_views
Available Periods: lifetime, dayComments Boxへの投稿で生成されたストーリーの閲覧数
domain_widget_comments_feed_clicks
Available Periods: lifetime, dayコメントストーリーへのクリックでサイトへ誘導された数。
