סכימת גישה לנתונים

המאפיינים והמדדים שנתמכים בשאילתות לשיטה Data Access Reports של Analytics Admin API.

מידות

אפשר לבקש את המאפיינים הבאים בדוחות גישה לנתונים. מציינים את הערך של AccessDimension בשדה name של מאפיין המקור של משאב כדי להגדיר עמודה של מאפיין המקור בתגובת הדוח.

שם ה-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	מספר המיקרו-שניות מאז ראשית זמן יוניקס (Unix epoch) שחלפו עד שמשתמש GA נכנס לנתוני הדיווח של GA. לדוגמה, מיקרו-שנייה ב-Unix של '1655220215027371' היא 2022-06-14 11:23:35 באמריקה/ניו יורק.
mostRecentAccessEpochTimeMicros	המיקרו-שניות של תקופת זמן המערכת בגישה האחרונה	נכסי Google Analytics 360	חותמת הזמן של הגישה האחרונה בשורה הזו. הערך שמוחזר הוא במיקרו-שניות מאז ראשית זמן יוניקס (Unix epoch). בדרך כלל משתמשים במאפיין הזה עם המאפיין 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' בשדה המדד name של משאב AccessMetric כדי להציג עמודה של המדד בתגובת הדוח.

שם ה-API	שם ממשק המשתמש	מאפיינים מותרים	תיאור
accessCount	מספר הפעמים שבוצעה גישה	נכסי Google Analytics 360	מספר הפעמים שבהן הייתה גישה לנתוני הדיווח של GA. כשמשתמשים בממשק המשתמש של Google Analytics, כל כרטיס דוח יכול להוביל לאירוע אחד או יותר של גישה לנתונים. לכן, יכול להיות שיהיו יותר אירועי גישה מאשר מספר הדוחות שנצפו כשמשתמשים בממשק המשתמש של Google Analytics.
dataApiQuotaPropertyTokensConsumed	טוקנים של נכסים במכסה של Google Data API שנצרכו	כל הנכסים ב-Google Analytics	הפונקציה מחזירה את סך כל מכסת הטוקנים של הנכס שבקשות ה-Data API צרכו.