המאפיינים והמדדים שנתמכים בשאילתות לשיטת זמן האמת של 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" בבקשת API ל-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.