リアルタイムのディメンションと指標

Analytics Data API の Realtime メソッドのクエリでサポートされているディメンションと指標。コア レポート メソッド(RunReport など)は、リアルタイム メソッドとは異なるディメンションと指標のセットを受け入れます。

ディメンション

以下のディメンションは、どのプロパティのレポートでもリクエストできます。レポート レスポンスのディメンションの列にある Dimension リソースの name フィールドに「API 名」を指定します。

API 名 UI 名 説明
appVersion アプリのバージョン アプリの versionName(Android の場合)または short bundle version(iOS の場合)。
audienceId オーディエンス ID オーディエンスの数値 ID。ユーザーは、レポートの期間中に属していたオーディエンスにレポートされます。現在のユーザーの行動によって、レポート済みのオーディエンスから変更されることはありません。
audienceName オーディエンス名 オーディエンスに指定した名前。ユーザーは、レポートの期間中に属していたオーディエンスにレポートされます。現在のユーザーの行動によって、レポート済みのオーディエンスから変更されることはありません。
audienceResourceName オーディエンス リソース名 このオーディエンスのリソース名。リソース名には、リソースを一意に識別するためにコレクション ID とリソース ID の両方が含まれます。詳しくは、リソース名をご覧ください。
city 市区町村 ユーザー アクションが発生した都市です。
cityId 都市 ID ユーザー アクションが発生した都市の地域 ID(IP アドレスから取得)。
country ユーザー アクションが発生した国です。
countryId 国 ID ユーザー アクションが発生した国(IP アドレスから取得)の地域 ID。ISO 3166-1 alpha-2 標準の形式で表されます。
deviceCategory デバイス カテゴリ 端末の種類(パソコン、タブレット、またはモバイル)です。
eventName イベント名 イベントの名前。
minutesAgo リアルタイムの経過分数 イベントが収集された時点からの経過時間(分単位)。00 は現在の分、01 は前の分を意味します。
platform プラットフォーム アプリまたはウェブサイトが実行されたプラットフォームです(ウェブ、iOS、Android など)。レポートでストリームのタイプを特定するには、platform と streamId の両方を使用します。
streamId ストリーム ID アプリまたはウェブサイトの数値データ ストリーム ID。
streamName ストリーム名 アプリまたはウェブサイトのデータ ストリーム名。
unifiedScreenName ページタイトルとスクリーン名 イベントが記録されたページのタイトル(ウェブ)またはスクリーン名(アプリ)。

カスタム ディメンション

Realtime Data API を使用すると、ユーザー スコープのカスタム ディメンションに関するレポートを作成できます。カスタム ディメンションの詳細については、カスタム ユーザー プロパティをご覧ください。カスタム ディメンションは、API レポート リクエストでディメンションのパラメータ名とスコープで指定します。たとえば、Data API リクエストに "customUser:last_level" を含めて、パラメータ名 "last_level" のユーザー スコープのカスタム ディメンションのレポートを作成します。プロパティでこのユーザー スコープのカスタム ディメンションが登録されていない場合、この API リクエストは失敗します。

カスタム ディメンションの一般的な構文は次のとおりです。Metadata API メソッドをクエリすると、プロパティのすべてのカスタム ディメンションを一覧表示できます。

汎用 API 名 説明
customUser:parameter_name parameter_name のユーザー スコープのカスタム ディメンション

イベント スコープのカスタム ディメンションは、Realtime API ではサポートされていません。

指標

以下の指標は、どのプロパティのレポートでもリクエストできます。レポート レスポンスの指標の列の「API Name」を、Metric リソースの name フィールドに指定します。

API 名 UI 名 説明
activeUsers アクティブ ユーザー数 サイトまたはアプリにアクセスした個別のユーザーの数。
eventCount イベント数 イベントの数。
keyEvents キーイベント キーイベントの数。イベントにキーイベントとしてマークを付けると、作成時点以降のレポートに反映されますが、過去のデータは変更されません。Google アナリティクスでは任意のイベントにキーのマークを付けることができますが、一部のイベント(first_openpurchase など)はデフォルトでキーイベントとしてマークされます。
screenPageViews 視聴回数 ユーザーが閲覧したアプリの画面またはウェブページの数。同じページやスクリーンが繰り返し表示された場合も集計されます(screen_view イベント数 + page_view イベント数)。

イベント スコープのカスタム指標は Realtime API ではサポートされていません。