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