המאפיינים והמדדים הנתמכים בשאילתות לשיטת 'זמן אמת' ב-Analytics Data API. שיטות הדיווח המרכזיות (RunReport, למשל) מקבלות קבוצה שונה של Dimensions & Metrics מזו של השיטה 'זמן אמת'.
מאפיינים
ניתן לבקש את המאפיינים הבאים בדוחות לכל נכס. מציינים את שם ה-API בשדה name של המשאב Dimension בעמודה של המאפיין, בתגובת הדוח.
| שם ה-API | שם ממשק המשתמש | תיאור |
|---|---|---|
| appVersion | גרסת האפליקציה | ערך versionName של אפליקציה (Android) או גרסת החבילה המקוצרת שלה (iOS). |
| audienceId | מזהה קהל | המזהה המספרי של קהל. המשתמשים מדווחים בקהלים שאליהם הם שייכים בטווח התאריכים של הדוח. התנהגות המשתמשים הנוכחית לא משפיעה על החברות ההיסטורית בקהל בדוחות. |
| audienceName | שם הקהל | השם הנתון של קהל. המשתמשים מדווחים בקהלים שאליהם הם שייכים בטווח התאריכים של הדוח. התנהגות המשתמשים הנוכחית לא משפיעה על החברות ההיסטורית בקהל בדוחות. |
| עיר | עיר | העיר שממנה בוצעה פעילות המשתמש. |
| 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 |
מאפיינים מותאמים אישית ברמת האירוע לא נתמכים ב-זמן אמת API.
מדדים
אפשר לבקש את המדדים הבאים בדוחות של כל נכס. מציינים את 'API Name' בשדה name של המשאב Metric בעמודה של המדד בתגובה לדוח.
| שם ה-API | שם ממשק המשתמש | תיאור |
|---|---|---|
| activeUsers | משתמשים פעילים | מספר המשתמשים הייחודיים שביקרו באתר או באפליקציה שלכם. |
| במספר ההמרות | המרות | המספר של אירועי ההמרה. אירועים מסומנים כהמרות בזמן האיסוף. שינויים בסימון ההמרות של האירוע יחולו מאותו רגע ואילך. אתם יכולים לסמן כל אירוע כהמרה ב-Google Analytics. אירועים מסוימים (למשל first_open ו-purchase) מסומנים כהמרות כברירת מחדל. למידע נוסף, ניתן לעיין במאמר מידע על המרות. |
| eventCount | מספר האירועים | מספר האירועים. |
| screenPageViews | צפיות | מספר המסכים באפליקציה או דפי האינטרנט שהמשתמשים שלכם צפו בהם. צפיות חוזרות באותו הדף או אותו המסך נכללות במספר הסופי. (אירועי screen_view + אירועי page_view). |
מדדים מותאמים אישית ברמת האירוע לא נתמכים ב-זמן אמת API.