Analytics Data API Realtime 方法查詢支援的維度和指標。Core Reporting 方法 (例如 RunReport) 接受的維度和指標組合與 Realtime 方法不同。
尺寸
您可以在任何資源的報表中要求下列維度。在報表回應中，為維度資料欄指定 Dimension 資源 name 欄位的「API 名稱」。
| API 名稱 | UI 名稱 | 說明 |
|---|---|---|
appVersion |
應用程式版本 | 應用程式的 versionName (Android) 或簡短版軟體包版本編號 (iOS)。 |
audienceId |
目標對象 ID | 目標對象的數字 ID。報表會根據使用者在報表日期範圍內所屬的目標對象，將使用者歸入相應的目標對象。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
audienceName |
目標對象名稱 | 目標對象的名稱。報表會根據使用者在報表日期範圍內所屬的目標對象，將使用者歸入相應的目標對象。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
audienceResourceName |
目標對象資源名稱 | 這個目標對象的資源名稱。資源名稱包含集合和資源 ID，可明確識別資源。詳情請參閱「資源名稱」。 |
city |
城市 | 使用者活動的來源城市。 |
cityId |
城市 ID | 使用者活動來源城市的地理 ID，根據使用者的 IP 位址推算而得。 |
country |
國家/地區 | 使用者活動的來源國家/地區。 |
countryId |
國家/地區 ID | 使用者活動來源國家/地區的地理 ID，根據使用者的 IP 位址推算而得。格式須符合 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 要求就會失敗。
以下是自訂維度的一般語法。您可以查詢中繼資料 API 方法，列出資源的所有自訂維度。
| Generic API 名稱 | 說明 |
|---|---|
customUser:parameter_name |
parameter_name 的以使用者為範圍自訂維度。 |
Realtime API 不支援以事件為範圍的自訂維度。
指標
您可以在任何資源的報表中要求下列指標。在 Metric 資源的 name 欄位中，指定報表回應中指標欄的「API 名稱」。
| API 名稱 | UI 名稱 | 說明 |
|---|---|---|
activeUsers |
活躍使用者 | 曾造訪您網站或應用程式的不重複使用者人數。 |
eventCount |
事件計數 | 事件數量。 |
keyEvents |
重要事件 | 重要事件計數。將事件標示為重要事件只會影響之後產生的報表資料，不會影響歷來資料。您可以在 Google Analytics 中將任何事件標示為重要事件，而有些事件 (例如 first_open 或 purchase) 會預設標示為重要事件。 |
screenPageViews |
觀看次數 | 使用者瀏覽應用程式畫面或網頁的次數。重複瀏覽同一個網頁或畫面也會列入計算。(screen_view + page_view 事件)。 |
Realtime API 不支援以事件為範圍的自訂指標。