קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
המאפיינים והמדדים שנתמכים בשאילתות לשיטת זמן האמת של Analytics Data API. השיטות של Core Reporting (לדוגמה, RunReport) מקבלות קבוצה שונה של מאפיינים ומדדים מאשר השיטה של Realtime.
מידות
אפשר לבקש את המאפיינים הבאים בדוחות של כל נכס. מציינים את 'שם ה-API' בשדה name של משאב Dimension עבור עמודה של המימד בתגובת הדוח.
שם ה-API
שם ממשק המשתמש
תיאור
appVersion
גרסת אפליקציה
ערך versionName של אפליקציה (Android) או גרסת החבילה המקוצרת שלה (iOS).
audienceId
מזהה קהל
המזהה המספרי של קהל. המשתמשים מדווחים בקהלים שאליהם הם שייכים בטווח התאריכים של הדוח. התנהגות המשתמשים הנוכחית לא משפיעה על החברות ההיסטורית בקהל בדוחות.
audienceName
שם הקהל
השם הנתון של קהל. המשתמשים מדווחים בקהלים שאליהם הם שייכים בטווח התאריכים של הדוח. התנהגות המשתמשים הנוכחית לא משפיעה על החברות ההיסטורית בקהל בדוחות.
audienceResourceName
השם של משאב הקהל
שם המשאב של הקהל הזה. שמות המשאבים מכילים מזהים של אוסף ושל משאב, כדי לזהות משאב באופן ייחודי. מידע נוסף זמין במאמר בנושא שמות משאבים.
city
עיר
העיר שממנה בוצעה פעילות המשתמש.
cityId
מזהה עיר
המזהה הגיאוגרפי של העיר שממנה בוצעה פעילות המשתמש, שנגזר מכתובת ה-IP שלו.
country
מדינה
המדינה שממנה בוצעה פעילות המשתמש.
countryId
מזהה מדינה
המזהה הגיאוגרפי של המדינה שממנה בוצעה פעילות המשתמש, שנגזר מכתובת ה-IP שלו. הפורמט צריך להיות בהתאם לתקן ISO 3166-1 alpha-2.
deviceCategory
קטגוריית מכשיר
סוג המכשיר: מחשב שולחני, טאבלט או נייד.
eventName
שם האירוע
שם האירוע.
minutesAgo
דקות שעברו בזמן אמת
מספר הדקות שחלפו מאז שהאירוע נאסף. 00 היא הדקה הנוכחית, ו-01 היא הדקה הקודמת.
platform
פלטפורמה
הפלטפורמה שבה האפליקציה או האתר פעלו. לדוגמה, אינטרנט, iOS או Android. כדי לקבוע את סוג הזרם בדוח, צריך להשתמש גם בפלטפורמה וגם ב-streamId.
streamId
מזהה מקור הנתונים
המזהה המספרי של מקור הנתונים של האפליקציה או האתר.
streamName
שם מקור הנתונים
השם של מקור הנתונים של האפליקציה או האתר.
unifiedScreenName
כותרת דף ושם מסך
כותרת הדף (באתר) או שם המסך (באפליקציה) שבהם נרשם האירוע.
מאפיינים מותאמים אישית
ה-API של נתוני זמן אמת יכול ליצור דוחות על מאפיינים מותאמים אישית ברמת המשתמש. מידע נוסף על מאפיינים מותאמים אישית זמין במאמר בנושא מאפייני משתמש מותאמים אישית. מאפיינים מותאמים אישית מצוינים בבקשת דוח של API לפי שם הפרמטר וההיקף של המאפיין. לדוגמה, כדי ליצור דוח עבור מאפיין מותאם אישית ברמת המשתמש עם שם הפרמטר "last_level", צריך לכלול את הפרמטר "customUser:last_level" בבקשה ל-Data API. בקשת ה-API הזו תיכשל אם לא רשמתם בנכס מאפיין מותאם אישית בהיקף משתמש.
התחביר הכללי של מאפיינים מותאמים אישית מפורט בהמשך. אפשר להריץ שאילתה בשיטה של Metadata API כדי לקבל רשימה של כל המאפיינים בהתאמה אישית בנכס.
שם API כללי
תיאור
customUser:parameter_name
מאפיין מותאם אישית בהיקף רמת המשתמש עבור parameter_name.
אין תמיכה במאפיינים מותאמים אישית ברמת האירוע ב-Realtime API.
מדדים
אפשר לבקש את המדדים הבאים בדוחות של כל נכס. מציינים את הערך של 'שם ה-API' בשדה name של משאב Metric כדי להוסיף עמודה של המדד בתגובת הדוח.
שם ה-API
שם ממשק המשתמש
תיאור
activeUsers
משתמשים פעילים
מספר המשתמשים הייחודיים שביקרו באתר או באפליקציה שלכם.
eventCount
מספר האירועים
מספר האירועים.
keyEvents
אירועים מרכזיים
מספר האירועים המרכזיים. הסימון של אירוע כאירוע מרכזי משפיע על הדוחות העתידיים שלכם. הוא לא גורם לשינוי של נתונים היסטוריים. אפשר לסמן כל אירוע כאירוע מרכזי ב-Google Analytics. כברירת מחדל, אירועים מסוימים (כמו first_open או purchase) מסומנים כאירועים מרכזיים.
screenPageViews
צפיות
מספר המסכים באפליקציה או הדפים באתר שבהם המשתמשים צפו. מספר הצפיות החוזרות באותו הדף או אותו המסך נספרות. (מספר אירועי screen_view + מספר אירועי page_view).
אין תמיכה במדדים מותאמים אישית ברמת האירוע ב-Realtime API.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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."]]
