המאפיינים והמדדים שנתמכים בשאילתות לשיטה 'זמן אמת' של Analytics Data API. שיטות הדיווח הבסיסיות (לדוגמה, RunReport) מקבלות קבוצה שונה של מאפיינים ומדדים מאשר השיטה 'זמן אמת'.
מידות
אפשר לבקש את המאפיינים הבאים בדוחות של כל נכס. מציינים את 'שם ה-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. כדי לקבוע את סוג הסטרימינג בדוח, צריך להשתמש גם ב-platform וגם ב-streamId. |
streamId |
מזהה מקור הנתונים | המזהה המספרי של מקור הנתונים של האפליקציה או האתר. |
streamName |
שם מקור הנתונים | השם של מקור הנתונים של האפליקציה או האתר. |
unifiedScreenName |
כותרת דף ושם מסך | כותרת הדף (באתר) או שם המסך (באפליקציה) שבו האירוע נרשם ביומן. |
מאפיינים מותאמים אישית
באמצעות Realtime Data 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). |
מדדים מותאמים אישית ברמת האירוע לא נתמכים ב-זמן אמת API.