透過 Analytics Data API 的即時方法查詢時支援的維度和指標。核心報表方法 (例如 RunReport
) 接受的維度和指標與即時方法不同。
尺寸
您可以在任何資源的報表中要求下列維度。在 Dimension
資源的 name
欄位中,為報表回應中的維度資料欄指定「API 名稱」。
API 名稱 | 使用者介面名稱 | 說明 |
---|---|---|
appVersion | 應用程式版本 | 應用程式的 versionName (Android) 或簡短版軟體包版本編號 (iOS)。 |
audienceId | 目標對象 ID | 目標對象的數字 ID。在報表日期範圍內,使用者會記錄於所屬的目標對像中。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
audienceName | 目標對象名稱 | 目標對象的指定名稱。在報表日期範圍內,使用者會記錄於所屬的目標對像中。目前的使用者行為不會影響報表中的歷來目標對象成員。 |
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 要求就會失敗。
以下是自訂維度的一般語法。您可以查詢 Metadata API 方法,藉此列出「屬性」的所有自訂維度。
一般 API 名稱 | 說明 |
---|---|
customUser:parameter_name | 「parameter_name」的以使用者為範圍自訂維度 |
Realtime API 不支援以事件為範圍的自訂維度,
指標
您可以在任何資源的報表中要求下列指標。在 Metric
資源的 name
欄位中,為報表回應中的指標資料欄指定「API 名稱」。
API 名稱 | 使用者介面名稱 | 說明 |
---|---|---|
activeUsers | 活躍使用者 | 曾造訪您網站或應用程式的不重複使用者人數。 |
轉換次數 | 轉換 | 轉換事件的數量。事件在收集時會標示為轉換;事件的轉換標記會在日後生效。您可以在 Google Analytics (分析) 中將任何事件標示為轉換,有些事件 (例如 first_open、purchase) 都會根據預設標示為轉換。詳情請參閱「關於轉換」一文。 |
eventCount | 事件計數 | 事件數。 |
screenPageViews | 觀看次數 | 使用者瀏覽的應用程式畫面或網頁數量。重複瀏覽同一個網頁或畫面也會列入計算。(screen_view 與 page_view 事件)。 |
Realtime API 不支援以事件為範圍的自訂指標。