سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
ابعاد بیدرنگ و تقویت معیارهای
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ابعاد و معیارهای پشتیبانی شده در پرس و جوهای روش Realtime در Analytics Data API. روش‌های گزارش اصلی (برای مثال RunReport ) مجموعه‌ای از ابعاد و متریک‌ها را نسبت به روش Realtime می‌پذیرند.
ابعاد
ابعاد زیر را می توان در گزارشات برای هر ملکی درخواست کرد. "نام API" را در قسمت name منبع Dimension برای ستونی از بعد در پاسخ گزارش مشخص کنید.
| نام API | نام رابط کاربری | توضیحات |
|---|
appVersion | نسخه برنامه | نسخه نام برنامه (اندروید) یا نسخه کوتاه باندل (iOS). |
audienceId | شناسه مخاطب | شناسه عددی یک مخاطب. کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
audienceName | نام مخاطب | نام داده شده یک مخاطب کاربران در محدوده تاریخ گزارش در مخاطبانی که به آنها تعلق داشتند گزارش می شوند. رفتار کاربر فعلی بر عضویت مخاطبان تاریخی در گزارش‌ها تأثیر نمی‌گذارد. |
audienceResourceName | نام منبع مخاطب | نام منبع این مخاطبان. نام منابع حاوی هر دو شناسه مجموعه و منبع برای شناسایی منحصر به فرد یک منبع است. برای کسب اطلاعات بیشتر، به نام منابع مراجعه کنید. |
city | شهر | شهری که فعالیت کاربر از آن سرچشمه گرفته است. |
cityId | شناسه شهر | شناسه جغرافیایی شهری که فعالیت کاربر از آن سرچشمه گرفته است، از آدرس IP آنها مشتق شده است. |
country | کشور | کشوری که فعالیت کاربر از آن منشا گرفته است. |
countryId | شناسه کشور | شناسه جغرافیایی کشوری که فعالیت کاربر از آن سرچشمه گرفته است، برگرفته از آدرس IP آنها. فرمت شده بر اساس استاندارد ISO 3166-1 alpha-2. |
deviceCategory | دسته دستگاه | نوع دستگاه: رومیزی، تبلت یا موبایل. |
eventName | نام رویداد | نام رویداد. |
minutesAgo | دقایقی قبل بیدرنگ | تعداد دقایقی پیش که یک رویداد جمع آوری شد. 00 دقیقه فعلی است و 01 به معنای دقیقه قبل است. |
platform | پلت فرم | پلتفرمی که برنامه یا وب سایت شما روی آن اجرا می شود؛ برای مثال، وب، iOS یا اندروید. برای تعیین نوع جریان در گزارش، از هر دو پلتفرم و streamId استفاده کنید. |
streamId | شناسه جریان | شناسه جریان داده عددی برای برنامه یا وب سایت شما. |
streamName | نام جریان | نام جریان داده برای برنامه یا وب سایت شما. |
unifiedScreenName | عنوان صفحه و نام صفحه | عنوان صفحه (وب) یا نام صفحه (برنامه) که رویداد در آن ثبت شده است. |
ابعاد سفارشی
Realtime Data API می‌تواند گزارش‌هایی درباره ابعاد سفارشی با محدوده کاربر ایجاد کند. برای کسب اطلاعات بیشتر در مورد ابعاد سفارشی، ویژگی های کاربر سفارشی را ببینید. ابعاد سفارشی در یک درخواست گزارش API با نام پارامتر و محدوده ابعاد مشخص می‌شوند. برای مثال، "customUser:last_level" در درخواست Data API برای ایجاد گزارشی برای بعد سفارشی محدوده کاربر با نام پارامتر "last_level" قرار دهید. این درخواست API در صورتی که دارایی این بعد سفارشی با محدوده کاربر را ثبت نکرده باشد ناموفق خواهد بود.
در زیر دستور کلی برای ابعاد سفارشی آمده است. می‌توانید برای فهرست کردن همه ابعاد سفارشی برای یک ویژگی ، از متد API فراداده پرس و جو کنید.
| نام API عمومی | توضیحات |
|---|
customUser:parameter_name | ابعاد سفارشی با محدوده کاربر برای parameter_name . |
ابعاد سفارشی با محدوده رویداد در API Realtime پشتیبانی نمی‌شود.
معیارها
معیارهای زیر را می توان در گزارش برای هر ملک درخواست کرد. "نام API" را در قسمت name منبع Metric برای ستونی از متریک در پاسخ گزارش مشخص کنید.
| نام API | نام رابط کاربری | توضیحات |
|---|
activeUsers | کاربران فعال | تعداد کاربران مشخصی که از سایت یا برنامه شما بازدید کردند. |
eventCount | شمارش رویداد | شمارش رویدادها |
keyEvents | رویدادهای کلیدی | شمارش رویدادهای کلیدی علامت گذاری یک رویداد به عنوان یک رویداد کلیدی بر گزارش های مربوط به زمان ایجاد تأثیر می گذارد. داده های تاریخی را تغییر نمی دهد. می‌توانید هر رویدادی را به‌عنوان کلید در Google Analytics علامت‌گذاری کنید، و برخی رویدادها (مانند first_open یا purchase ) به‌طور پیش‌فرض به‌عنوان رویدادهای کلیدی علامت‌گذاری می‌شوند. |
screenPageViews | بازدیدها | تعداد صفحه‌های برنامه یا صفحات وب که کاربران شما مشاهده کرده‌اند. بازدیدهای مکرر از یک صفحه یا صفحه شمارش می شود. (رویدادهای screen_view + page_view). |
معیارهای سفارشی با محدوده رویداد در API Realtime پشتیبانی نمی‌شوند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
