Dimensi & Metrik Realtime
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dimensi dan metrik yang didukung dalam kueri ke metode Realtime Analytics Data API. Metode Pelaporan Inti (RunReport misalnya) menerima serangkaian Dimensi & Metrik yang berbeda dengan metode Realtime.
Dimensi
Dimensi berikut dapat diminta dalam laporan untuk properti apa pun. Tentukan
"Nama API" di kolom name
resource Dimension untuk kolom dimensi dalam respons laporan.
| Nama API |
Nama UI |
Deskripsi |
appVersion |
Versi aplikasi |
versionName aplikasi (Android) atau versi paket singkat (iOS). |
audienceId |
ID audiens |
ID numerik Audiens. Pengguna dilaporkan di audiens yang mencakup pengguna tersebut selama rentang tanggal laporan. Perilaku pengguna saat ini tidak memengaruhi keanggotaan audiens historis dalam laporan. |
audienceName |
Nama audiens |
Nama audiens tertentu. Pengguna dilaporkan di audiens yang mencakup pengguna tersebut selama rentang tanggal laporan. Perilaku pengguna saat ini tidak memengaruhi keanggotaan audiens historis dalam laporan. |
audienceResourceName |
Nama resource audiens |
Nama resource audiens ini. Nama resource berisi ID koleksi & resource untuk mengidentifikasi resource secara unik; untuk mempelajari lebih lanjut, lihat Nama resource. |
city |
Kota |
Kota asal aktivitas pengguna. |
cityId |
ID Kota |
ID geografis kota tempat aktivitas pengguna berasal, yang diperoleh dari alamat IP-nya. |
country |
Negara |
Negara tempat asal aktivitas pengguna. |
countryId |
ID Negara |
ID geografis negara tempat asal aktivitas pengguna, yang diperoleh dari alamat IP-nya. Diformat menurut standar ISO 3166-1 alpha-2. |
deviceCategory |
Kategori perangkat |
Jenis perangkat: Desktop, Tablet, atau Seluler. |
eventName |
Nama peristiwa |
Nama peristiwa. |
minutesAgo |
Real-time menit yang lalu |
Jumlah menit yang lalu saat peristiwa dikumpulkan. 00 adalah menit saat ini, dan 01 berarti menit sebelumnya. |
platform |
Platform |
Platform tempat aplikasi atau situs Anda berjalan; misalnya, web, iOS, atau Android. Untuk menentukan jenis aliran dalam laporan, gunakan platform dan streamId. |
streamId |
ID Aliran Data |
ID aliran data numerik untuk aplikasi atau situs Anda. |
streamName |
Nama aliran data |
Nama aliran data untuk aplikasi atau situs Anda. |
unifiedScreenName |
Judul halaman dan nama layar |
Judul halaman (web) atau nama layar (aplikasi) tempat peristiwa dicatat di log. |
Dimensi Kustom
Realtime Data API dapat membuat laporan tentang Dimensi Kustom cakupan Pengguna. Lihat
Properti pengguna kustom untuk mempelajari
dimensi kustom lebih lanjut. Dimensi kustom ditentukan dalam permintaan laporan API
berdasarkan nama parameter dan cakupan dimensi. Misalnya, sertakan
"customUser:last_level" dalam permintaan Data API untuk membuat laporan bagi
Dimensi Kustom Cakupan Pengguna dengan nama parameter "last_level". Permintaan API ini akan gagal jika properti belum mendaftarkan Dimensi Kustom Cakupan Pengguna ini.
Berikut adalah sintaks umum untuk Dimensi Kustom. Anda dapat mengkueri
metode Metadata API untuk mencantumkan semua
Dimensi Kustom untuk Properti.
| Nama API Generik |
Deskripsi |
customUser:parameter_name |
Dimensi Kustom cakupan Pengguna untuk parameter_name. |
Dimensi kustom cakupan peristiwa tidak didukung di Realtime API.
Metrik
Metrik berikut dapat diminta dalam laporan untuk properti apa pun. Tentukan
"Nama API" di kolom name resource Metric untuk
kolom metrik dalam respons laporan.
| Nama API |
Nama UI |
Deskripsi |
activeUsers |
Pengguna aktif |
Jumlah pengguna unik yang mengunjungi situs atau aplikasi Anda. |
eventCount |
Jumlah peristiwa |
Jumlah peristiwa. |
keyEvents |
Peristiwa utama |
Jumlah peristiwa utama. Menandai peristiwa sebagai peristiwa utama akan memengaruhi laporan sejak waktu pembuatannya. Tindakan ini tidak akan mengubah data historis. Anda dapat menandai peristiwa apa pun sebagai peristiwa utama di Google Analytics, dan beberapa peristiwa (seperti first_open atau purchase) ditandai sebagai peristiwa utama secara default. |
screenPageViews |
Penayangan |
Jumlah layar aplikasi atau halaman web yang dilihat pengguna. Tampilan berulang satu halaman atau layar akan dihitung. (peristiwa screen_view + page_view). |
Metrik kustom cakupan peristiwa tidak didukung di Realtime API.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-29 UTC."],[[["\u003cp\u003eThe Realtime reporting method of the Analytics Data API allows you to query specific dimensions and metrics to analyze real-time user behavior on your app or website.\u003c/p\u003e\n"],["\u003cp\u003eSupported dimensions include user demographics (like city and country), device information, app version, audience data, event details, and user-scoped custom dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can use metrics like \u003ccode\u003eactiveUsers\u003c/code\u003e, \u003ccode\u003eeventCount\u003c/code\u003e, \u003ccode\u003escreenPageViews\u003c/code\u003e, and \u003ccode\u003ekeyEvents\u003c/code\u003e to understand real-time user engagement.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Core Reporting methods, the Realtime method uses a different set of dimensions and metrics and doesn't support event-scoped custom dimensions or metrics.\u003c/p\u003e\n"]]],["The Realtime Analytics Data API supports specific dimensions and metrics for querying. Dimensions include `appVersion`, `audienceId/Name/ResourceName`, geographic data (`city/Id`, `country/Id`), `deviceCategory`, `eventName`, `minutesAgo`, `platform`, `streamId/Name`, and `unifiedScreenName`. User-scoped custom dimensions are supported using the `customUser:parameter_name` format. Supported metrics are `activeUsers`, `eventCount`, `keyEvents`, and `screenPageViews`. Event-scoped custom dimensions and metrics are not supported in the Realtime API.\n"],null,["# Realtime Dimensions & Metrics\n\nThe dimensions and metrics supported in queries to the [Realtime method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) of the Analytics Data API. The\nCore Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Realtime method.\n\nDimensions\n----------\n\nThe following dimensions can be requested in reports for any property. Specify\nthe \"API Name\" in a [`Dimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension) resource's `name`\nfield for a column of the dimension in the report response.\n\n| API Name | UI Name | Description |\n|------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appVersion` | App version | The app's versionName (Android) or short bundle version (iOS). |\n| `audienceId` | Audience ID | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceName` | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceResourceName` | Audience resource name | The resource name of this audience. Resource names contain both collection \\& resource identifiers to uniquely identify a resource; to learn more, see [Resource names](//google.aip.dev/122). |\n| `city` | City | The city from which the user activity originated. |\n| `cityId` | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. |\n| `country` | Country | The country from which the user activity originated. |\n| `countryId` | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. |\n| `deviceCategory` | Device category | The type of device: Desktop, Tablet, or Mobile. |\n| `eventName` | Event name | The name of the event. |\n| `minutesAgo` | Realtime minutes ago | The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute. |\n| `platform` | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. |\n| `streamId` | Stream ID | The numeric data stream identifier for your app or website. |\n| `streamName` | Stream name | The data stream name for your app or website. |\n| `unifiedScreenName` | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. |\n\n### Custom Dimensions\n\nThe Realtime Data API can create reports on User scoped Custom Dimensions. See\n[Custom user properties](//support.google.com/analytics/answer/9269570) to learn\nmore about custom dimensions. Custom dimensions are specified in an API report\nrequest by the dimension's parameter name and scope. For example, include\n`\"customUser:last_level\"` in a Data API request to create a report for the\nUser-scoped Custom Dimension with parameter name `\"last_level\"`. This API\nrequest will fail if the property has not registered this User-scoped Custom\nDimension.\n\nThe following are the general syntax for Custom Dimensions. You can query the\n[Metadata API method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) to list all\nCustom Dimensions for a Property.\n\n| Generic API Name | Description |\n|-----------------------------|----------------------------------------------------|\n| `customUser:parameter_name` | User-scoped Custom Dimension for `parameter_name`. |\n\nEvent-scoped custom dimensions aren't supported in the Realtime API.\n\nMetrics\n-------\n\nThe following metrics can be requested in reports for any property. Specify the\n\"API Name\" in a [`Metric`](/analytics/devguides/reporting/data/v1/rest/v1beta/Metric) resource's `name` field for\na column of the metric in the report response.\n\n| API Name | UI Name | Description |\n|-------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `activeUsers` | Active users | The number of distinct users who visited your site or app. |\n| `eventCount` | Event count | The count of events. |\n| `keyEvents` | Key events | The count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as `first_open` or `purchase`) are marked as key events by default. |\n| `screenPageViews` | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). |\n\nEvent-scoped custom metrics aren't supported in the Realtime API."]]
