Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
Gerçek Zamanlı Boyutlar ve Metrikler
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Analytics Data API'nin Realtime yöntemi için sorgularda desteklenen boyutlar ve metrikler. Temel raporlama yöntemleri (örneğin, RunReport), Gerçek Zamanlı yöntemden farklı bir boyut ve metrik grubu kabul eder.
Boyutlar
Aşağıdaki boyutlar, herhangi bir mülkle ilgili raporlarda istenebilir. Rapor yanıtındaki boyut sütunu için Dimension kaynağının name alanında "API Adı"nı belirtin.
| API adı |
Kullanıcı Arayüzü Adı |
Açıklama |
appVersion |
Uygulama sürümü |
Uygulamaya ait versionName (Android) veya kısa paket sürümü (iOS). |
audienceId |
Hedef kitle kimliği |
Bir kitlenin sayısal tanımlayıcısı. Kullanıcılar, raporun tarih aralığında ait oldukları kitlelerde raporlanır. Mevcut kullanıcı davranışı, kullanıcıların eski raporlarda hangi kitle listelerinin üyesi olduğunu etkilemez. |
audienceName |
Kitle adı |
Bir kitleye verilen ad. Kullanıcılar, raporun tarih aralığında ait oldukları kitlelerde raporlanır. Mevcut kullanıcı davranışı, kullanıcıların eski raporlarda hangi kitle listelerinin üyesi olduğunu etkilemez. |
audienceResourceName |
Kitle kaynak adı |
Bu kitlenin kaynak adı. Kaynak adları, bir kaynağı benzersiz şekilde tanımlamak için hem koleksiyon hem de kaynak tanımlayıcıları içerir. Daha fazla bilgi için Kaynak adları başlıklı makaleyi inceleyin. |
city |
Şehir |
Kullanıcı etkinliğinin gerçekleştiği şehir. |
cityId |
Şehir kimliği |
Kullanıcı etkinliğinin gerçekleştiği şehrin IP adresinden elde edilen coğrafi kimliği. |
country |
Ülke |
Kullanıcı etkinliğinin gerçekleştiği ülke. |
countryId |
Ülke kimliği |
Kullanıcı etkinliğinin gerçekleştiği ülkenin coğrafi kimliği (IP adresinden elde edilir). ISO 3166-1 alfa-2 standardına göre biçimlendirilmiş olmalıdır. |
deviceCategory |
Cihaz kategorisi |
Cihaz türü: Masaüstü, Tablet veya Mobil |
eventName |
Etkinlik adı |
Etkinliğin adı. |
minutesAgo |
Gerçek zamanlı dakika önce |
Bir etkinliğin kaç dakika önce toplandığı. 00, geçerli dakikayı, 01 ise önceki dakikayı ifade eder. |
platform |
Platform |
Uygulamanızın veya web sitenizin yayınlandığı platform (ör. web, iOS veya Android). Bir raporda akışın türünü belirlemek için hem platformu hem de streamId'yi kullanın. |
streamId |
Akış Kimliği |
Uygulamanız veya web siteniz için sayısal veri akışı tanımlayıcısı. |
streamName |
Akış adı |
Uygulamanızın veya web sitenizin veri akışı adı. |
unifiedScreenName |
Sayfa başlığı ve ekran adı |
Etkinliğin günlüğe kaydedildiği sayfa başlığı (web) veya ekran adı (uygulama). |
Özel boyutlar
Gerçek Zamanlı Veri API'si, kullanıcı kapsamlı özel boyutlar hakkında rapor oluşturabilir. Özel boyutlar hakkında daha fazla bilgi edinmek için Özel kullanıcı özellikleri başlıklı makaleyi inceleyin. Özel boyutlar, API raporu isteğinde boyutun parametre adı ve kapsamıyla belirtilir. Örneğin, parametre adı "last_level" olan kullanıcı kapsamlı özel boyut için rapor oluşturmak üzere bir Data API isteğine "customUser:last_level" ekleyin. Mülk, bu kullanıcı kapsamlı özel boyutu kaydetmediyse bu API isteği başarısız olur.
Aşağıda, özel boyutların genel söz dizimi verilmiştir. Bir mülkle ilgili tüm özel boyutları listelemek için Metadata API yöntemini sorgulayabilirsiniz.
| Genel API Adı |
Açıklama |
customUser:parameter_name |
parameter_name için kullanıcı kapsamlı özel boyut. |
Etkinlik kapsamlı özel boyutlar, Realtime API'de desteklenmez.
Metrikler
Aşağıdaki metrikler, herhangi bir mülkle ilgili raporlarda istenebilir. Rapor yanıtındaki metrik sütunu için Metric kaynağının name alanında "API Adı"nı belirtin.
| API adı |
Kullanıcı Arayüzü Adı |
Açıklama |
activeUsers |
Etkin kullanıcı sayısı |
Sitenizi veya uygulamanızı ziyaret eden farklı kullanıcıların sayısı. |
eventCount |
Etkinlik sayısı |
Etkinlik sayısı. |
keyEvents |
Önemli etkinlikler |
Önemli etkinlik sayısı. Bir etkinliğin önemli etkinlik olarak işaretlenmesi raporları, söz konusu önemli etkinliğin oluşturulmaya başlamasından itibaren etkiler. Bu işlem, geçmiş verileri değiştirmez. Google Analytics'te herhangi bir etkinliği önemli olarak işaretleyebilirsiniz. Bazı etkinlikler (ör. first_open veya purchase) varsayılan olarak önemli etkinlik olarak işaretlenir. |
screenPageViews |
Görüntüleme sayısı |
Kullanıcılarınızın görüntülediği uygulama ekranlarının veya web sayfalarının sayısı. Tek bir sayfanın veya ekranın yinelenen gösterimleri de sayılır. (screen_view + page_view etkinlikleri). |
Etkinlik kapsamlı özel metrikler, Realtime API'de desteklenmez.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-29 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
