アプリケーション、ページ、ドメインに関する統計情報を返します。測定する対象は、applicationとpageのヒット数、追加、削除、likeです。Metricsの項目では、測定対象の一覧があります。

sessionがない場合、アプリケーションは自身の統計しか見ることができません。ユーザセッションがある場合、そのユーザが管理しているアプリケーション、ページ、ドメインの情報を取得できます。これらのデータを得るには、read_insightsパーミッションが必要です。

テーブルからmetricsを取得するには、object_id、end_timeとperiodで指定する期間、metricを指定しなくてはいけません。

Columns

IndexableNameTypeDescription
*object_idint

情報を取得する対象のobject id

*metricstring

取得する情報

*end_timeint

測定する対象期間の終了時期のUnixタイムスタンプ。

*periodint

測定する期間の秒数。

valuemixed

測定する対象の値

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, month

    1, 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: lifetime

    Facebookアプリケーションのインストール数もしくは、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: day

    Facebookアプリケーションの新規インストール数、もしくはwebサイトへの新規Connect数。

  • application_installation_adds_unique
    Available Periods: day

    Facebookアプリケーションの新規インストール数、もしくは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: day

    Feedダイアログのインプレッション

  • application_feed_form_views_unique
    Available Periods: day

    FacebookログインユーザのFeedダイアログインプレッション

  • application_feed_form_views_login
    Available Periods: day

    FacebookログインユーザのFeedダイアログインプレッション

  • application_feed_form_views_login_unique
    Available Periods: day

    FacebookログインユーザのFeedダイアログインプレッション

  • application_feed_form_views_logout
    Available Periods: day

    FacebookにログインしていないユーザのFeedダイアログインプレッション

Plugins

  • application_widget_activity_views
    Available Periods: day

    activity pluginのインプレッション

  • application_widget_activity_views_unique
    Available Periods: day

    Facebookログインユーザのactivity pluginのインプレッション

  • application_widget_activity_views_login
    Available Periods: day

    Facebookログインユーザのactivity pluginのインプレッション

  • application_widget_activity_views_login_unique
    Available Periods: day

    Facebookログインユーザのactivity pluginのインプレッション

  • application_widget_activity_views_logout
    Available Periods: day

    Facebookにログインしていないユーザのactivity pluginのインプレッション

  • application_widget_activity_views_external_referrals
    Available Periods: day

    Activity pluginsインプレッションの主要なドメイン

  • application_widget_comments_views
    Available Periods: day

    Comments pluginのインプレッション

  • application_widget_comments_views_unique
    Available Periods: day

    FacebookログインユーザのComments pluginのインプレッション

  • application_widget_comments_views_login
    Available Periods: day

    FacebookログインユーザのComments pluginのインプレッション

  • application_widget_comments_views_login_unique
    Available Periods: day

    FacebookログインユーザのComments pluginのインプレッション

  • application_widget_comments_views_logout
    Available Periods: day

    FacebookにログインしていないユーザのComments pluginのインプレッション

  • application_widget_fan_views
    Available Periods: day

    Like Boxのインプレッション

  • application_widget_fan_views_unique

    Available Periods: day

    FacebookログインユーザのLike Boxインプレッション

  • application_widget_fan_views_login
    Available Periods: day

    FacebookログインユーザのLike Boxインプレッション

  • application_widget_fan_views_login_unique
    Available Periods: day

    FacebookログインユーザのLike Boxインプレッション

  • application_widget_fan_views_logout
    Available Periods: day

    FacebookにログインしていないユーザのLike Boxインプレッション

  • application_widget_fan_views_external_referrals
    Available Periods: day

    Like Box pluginsインプレッションの主要ドメイン

  • application_widget_like_views
    Available Periods: day

    Like pluginのインプレッション

  • application_widget_like_views_unique
    Available Periods: day

    FacebookログインユーザのLike Buttonインプレッション

  • application_widget_like_views_login
    Available Periods: day

    FacebookログインユーザのLike Buttonインプレッション

  • application_widget_like_views_login_unique
    Available Periods: day

    FacebookログインユーザのLike Buttonインプレッション

  • application_widget_like_views_logout
    Available Periods: day

    FacebookにログインしていないユーザのLike Buttonインプレッション

  • application_widget_like_views_external_referrals
    Available Periods: day

    Like pluginインプレッションの主要ドメイン

  • application_widget_live_stream_views
    Available Periods: day

    Live Stream pluginのインプレッション

  • application_widget_live_stream_views_unique
    Available Periods: day

    FacebookログインユーザのLive Stream pluginインプレッション

  • application_widget_live_stream_views_login
    Available Periods: day

    FacebookログインユーザのLive Stream pluginインプレッション

  • application_widget_live_stream_views_login_unique
    Available Periods: day

    FacebookログインユーザのLive Stream pluginインプレッション

  • application_widget_live_stream_views_logout
    Available Periods: day

    ログインユーザのLive Stream pluginインプレッション(訳注:『ログインユーザの』とドキュメントにありますが、未ログインユーザの間違いかと思います。)

  • application_widget_live_stream_views_external_referrals
    Available Periods: day

    Live Stream pluginインプレッションの主要ドメイン

  • application_widget_recommendation_views
    Available Periods: day

    Recommendation pluginのインプレッション

  • application_widget_recommendation_views_unique
    Available Periods: day

    FacebookログインユーザのRecommendation pluginのインプレッション

  • application_widget_recommendation_views_login
    Available Periods: day

    FacebookログインユーザのRecommendation pluginのインプレッション

  • application_widget_recommendation_views_login_unique
    Available Periods: day

    FacebookログインユーザのRecommendation pluginのインプレッション

  • application_widget_recommendation_views_logout
    Available Periods: day

    FacebookにログインしていないユーザのRecommendation pluginのインプレッション

  • application_widget_recommendation_views_external_referrals
    Available Periods: day

    Recommendation pluginインプレッションの主要なドメイン

  • application_widget_share_views
    Available Periods: day

    FacebookログインユーザのShareボタンインプレッション

  • application_widget_share_views_unique
    Available Periods: day

    FacebookログインユーザのShareボタンインプレッション

  • application_widget_views
    Available Periods: day

    全ソーシャルプラグインのインプレッション

  • application_widget_views_unique

    Available Periods: day

    Facebookログインユーザの全ソーシャルプラグインのインプレッション

  • application_widget_views_login
    Available Periods: day

    Facebookログインユーザの全ソーシャルプラグインのインプレッション

  • application_widget_views_login_unique
    Available Periods: day

    Facebookログインユーザの全ソーシャルプラグインのインプレッション

  • application_widget_views_logout
    Available Periods: day

    Facebookにログインしていないユーザの全ソーシャルプラグインのインプレッション

Canvas

  • application_canvas_views
    Available Periods: day

    アプリケーションのキャンバスページのインプレッション数

  • application_canvas_views_unique
    Available Periods: day

    Facebookログインユーザの、アプリケーションのキャンバスページのインプレッション数

  • application_canvas_views_login
    Available Periods: day

    Facebookログインユーザの、アプリケーションのキャンバスページのインプレッション数

  • application_canvas_views_login_unique
    Available Periods: day

    Facebookログインユーザの、アプリケーションのキャンバスページのインプレッション数

  • application_canvas_views_logout
    Available Periods: day

    Facebookにログインしていないユーザの、アプリケーションのキャンバスページのインプレッション数

  • application_canvas_views_internal_referrals
    Available Periods: day

    Facebook内からキャンバスページへの主要な参照元

  • 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: day

    This
    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: day

    Facebookログインユーザのページビュー

  • page_views_login
    Available Periods: day

    Facebookログインユーザのページビュー

  • page_views_login_unique
    Available Periods: day

    Facebookログインユーザのページビュー

  • page_views_logout
    Available Periods: day

    Facebookにログインしていないユーザのページビュー

  • page_views_internal_referrals
    Available Periods: day

    Facebook内からページへの主要な参照元

  • page_views_external_referrals
    Available Periods: day

    Facebook外からページへの主要な参照元


Domain Users

  • domain_active_users_locale
    Available Periods: day

    URLもしくはドメインに関わったユーザのロケール

  • domain_active_users_city
    Available Periods: day

    URLもしくはDomainに関わったユーザの主要な都市

  • domain_active_users_country
    Available Periods: day

    URLもしくはDomainに関わったユーザの主要な国

  • domain_active_users_gender
    Available Periods: day

    URLもしくはDomainに関わったユーザの性別

  • domain_active_users_age
    Available Periods: day

    URLもしくはDomainに関わったユーザの年齢

  • domain_active_users_gender_age
    Available Periods: day

    URLもしくは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, day

    Comments pluginを用いてサイト上にコメント投稿された回数。

  • domain_widget_comments_views
    Available Periods: lifetime, day

    ドメイン上でのComments Boxインプレッション

  • domain_widget_comments_feed_views
    Available Periods: lifetime, day

    Comments Boxへの投稿で生成されたストーリーの閲覧数

  • domain_widget_comments_feed_clicks
    Available Periods: lifetime, day

    コメントストーリーへのクリックでサイトへ誘導された数。