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

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

מידות

אפשר לבקש את המאפיינים הבאים בדוחות של גישה לנתונים. ציינו את הערך של "API Name" בשדה 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	קטגוריית המכסה של בקשת Google Data API. כמה מהערכים האפשריים: 'Core',‏ 'Realtime' ו-'Funnel'.
epochTimeMicros	המיקרו-שניות של תקופת זמן המערכת	נכסי Google Analytics 360	המיקרו-שניות של Unix מאז ראשית הזמן שבהן משתמש GA נכנס לנתוני הדיווח של GA. לדוגמה, מיקרו-שנייה של Unix‏ '1655220215027371' היא 2022-06-14 11:23:35 ב-America/New_York.
mostRecentAccessEpochTimeMicros	המיקרו-שניות של תקופת זמן המערכת בגישה האחרונה	נכסי Google Analytics 360	חותמת הזמן של הגישה האחרונה לשורה הזו. מוחזר במיקרו-שניות של Unix מאז ראשית הזמן. בדרך כלל משתמשים במאפיין הזה עם 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 צרכו.