המאפיינים והמדדים הנתמכים בשאילתות לשיטת דוחות הגישה לנתונים ב-Admin API של Analytics.
מאפיינים
בדוחות הגישה לנתונים ניתן לשלוח בקשה למאפיינים הבאים. מציינים את 'שם ה-API' בשדה name
של המאפיין במשאב AccessDimension
בעמודה של המאפיין, בתגובה לדוח.
שם ה-API | שם ממשק המשתמש | מאפיינים מותרים | תיאור |
---|---|---|---|
accessDateHour | שעת גישה לתאריך | כל הנכסים ב-Google Analytics | התאריך והשעה של המשתמש ב-Google Analytics שניגש לנתוני דיווח ב-Google Analytics. בפורמט YYYYMMDDHH. |
accessMechanism | מנגנון גישה | נכסי Google Analytics 360 | המנגנון שדרכו משתמש ב-Google Analytics ניגש לנתוני דיווח ב-Google Analytics. ערכים אפשריים כוללים Google Analytics User Interface , Google Analytics API , Firebase , Google Ads ואחרים. |
accessedPropertyId | מזהה נכס שבוצעה אליו גישה | כל הנכסים ב-Google Analytics | מזהה הנכס שבו בוצעה גישה לנתוני דיווח של Google Analytics. רוב דוחות הגישה לנתונים מכילים רק נכס אחד, אבל אם לנכס המבוקש יש נכס משנה, דוחות הגישה לנתונים מכילים את הרשאות הגישה גם לנכס המקור וגם לנכס המשנה. מידע נוסף על נכסי משנה זמין במאמר מידע על נכסי משנה. |
accessedPropertyName | שם נכס שבוצעה אליו גישה | כל הנכסים ב-Google Analytics | השם המוצג של הנכס שבו בוצעה גישה לנתוני דיווח של Google Analytics. רוב דוחות הגישה לנתונים מכילים רק נכס אחד, אבל אם לנכס המבוקש יש נכס משנה, דוחות הגישה לנתונים מכילים את הרשאות הגישה גם לנכס המקור וגם לנכס המשנה. מידע נוסף על נכסי משנה זמין במאמר מידע על נכסי משנה. |
accessorAppName | שם האפליקציה של מבצע הגישה | כל הנכסים ב-Google Analytics | שם האפליקציה שניגשה לנתוני דיווח ב-Google Analytics. |
costDataReturned | נתוני העלות הוחזרו | נכסי Google Analytics 360 | הפונקציה מחזירה את הערך true אם בדוח הזה הוחזרו נתוני עלות. אחרת, המאפיין הזה יחזיר false . משתמשי Google Analytics עם ההגבלה No Cost Metrics לא יכולים לראות את מדדי העלות. כל עוד ההגבלה הזו פעילה, המאפיין הזה תמיד יהיה false . מידע נוסף זמין במאמר ניהול גישה והגבלת נתונים. |
dataApiQuotaCategory | קטגוריית מכסה של Data API | כל הנכסים ב-Google Analytics | קטגוריית המכסה של בקשת Data API. הערכים האפשריים כוללים: Core , Realtime ו-Funnel . |
epochTimeMicros | מיקרו-שניות של זמן | נכסי Google Analytics 360 | במיליוניות השנייה מאז תחילת התקופה שבה משתמש Google Analytics ניגש לנתוני דיווח ב-Google Analytics. לדוגמה, מיקרו-שנייה יוניקס של 1655220215027371 היא 2022-06-14 11:23:35 באמריקה/ניו_יורק. |
mostRecentAccessEpochTimeMicros | מיקרו-שניות של גישה לתקופה האחרונה | נכסי Google Analytics 360 | חותמת הזמן של הגישה העדכנית ביותר לשורה הזו. מוחזרת במיליוניות השנייה מאז תחילת התהליך. בדרך כלל משמש עם userEmail ומאפיינים דומים כדי לקבוע את זמני הגישה האחרונים של משתמשי Google Analytics. |
reportType | סוג הדוח | נכסי Google Analytics 360 | סוג נתוני הדיווח שהמשתמש ב-Google Analytics ניגש אליהם. ערכים אפשריים כוללים Reporting , Realtime , Free form exploration , Funnel exploration ואחרים. |
revenueDataReturned | הוחזרו נתוני הכנסה | נכסי Google Analytics 360 | הפונקציה מחזירה את הערך true אם הוחזרו נתוני הכנסות בדוח הזה. אחרת, המאפיין הזה יחזיר false . משתמשי Google Analytics עם ההגבלה No Revenue Metrics לא יכולים לראות מדדי הכנסה. כל עוד ההגבלה הזו פעילה, המאפיין הזה תמיד יהיה false . מידע נוסף זמין במאמר ניהול גישה והגבלת נתונים. |
userCountry | המדינה של המשתמש | נכסי Google Analytics 360 | המדינה של המשתמש ב-Google Analytics שניגש לנתוני דיווח ב-Google Analytics. |
userCountryId | מזהה המדינה של המשתמש | נכסי Google Analytics 360 | מזהה המדינה של המשתמש ב-Google Analytics שניגש לנתוני דיווח ב-Google Analytics. בפורמט שתואם לתקן ISO 3166-1 alpha-2. |
userEmail | כתובת האימייל של המשתמש | כל הנכסים ב-Google Analytics | כתובת האימייל של המשתמש ב-Google Analytics שניגש לנתוני דיווח ב-Google Analytics. חלק מהשילובים מאפשרים למשתמשים לגשת לנתוני דיווח של Google Analytics דרך השילוב, בלי שלמשתמש תהיה גישה ישירה לנכס. במקרה כזה, הפונקציה userEmail תחזיר את הערך Google Ads Linked User , לדוגמה, בהתאם לשילוב. |
userIP | כתובת IP של משתמש | נכסי Google Analytics 360 | כתובת ה-IP של המשתמש ב-Google Analytics שניגש לנתוני דיווח ב-Google Analytics. |
מדדים
בדוחות הגישה לנתונים אפשר לבקש את המדדים הבאים. מציינים את "API
Name" בשדה name
של המשאב AccessMetric
בעמודה של המדד בתגובה לדוח.
שם ה-API | שם ממשק המשתמש | מאפיינים מותרים | תיאור |
---|---|---|---|
accessCount | מספר הרשאות הגישה | נכסי Google Analytics 360 | מספר הפעמים שבוצעה גישה לנתוני דיווח של Google Analytics. |
dataApiQuotaPropertyTokensConsumed | נצרכת אסימוני נכס למכסה ב-Data API | כל הנכסים ב-Google Analytics | מחזירה את סך אסימוני המכסה של נכסים שנצרכו לבקשות API של Data. |