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