גרסה 1 של Google Analytics Data API מאפשרת גישה פרוגרמטית לנתוני דוחות Google Analytics 4 (GA4). נכס Google Analytics 4 עוזר לך להבין כיצד אנשים משתמשים באינטרנט, ב-iOS או באפליקציה שלך ל-Android. למידע נוסף על נכסי Google Analytics 4.
בעזרת Google Analytics Data API v1, ניתן ליצור דוחות כדי לענות על שאלות כגון:
- כמה משתמשים פעילים ביום יש באפליקציה ל-Android בשבוע האחרון?
- כמה צפיות בדף קיבלו כל אחת מעשר כתובות ה-URL המובילות של האתר שלי ב-28 הימים האחרונים?
- כמה משתמשים פעילים בכל מדינה היו באפליקציה iOS שלי ב-30 הדקות האחרונות?
אפשר להשתמש ב-Google Analytics Data API v1 גם כדי:
- יצירת מרכזי בקרה בהתאמה אישית להצגת נתוני Google Analytics.
- אוטומציה של משימות דיווח מורכבות חוסכת זמן.
- לשלב את נתוני Google Analytics עם אפליקציות עסקיות אחרות.
מדריך למתחילים
קריאה ל-API לצורך יצירת הדוח הראשון נמצאת במרחק שורות ספורות. כדי להתחיל, מומלץ לעיין בהתחלה המהירה של שימוש בספריות לקוח. יש ספריות לקוח ב-Java, Python, Node.js ושפות אחרות כדי לפשט את ההטמעה.
השיטות הזמינות
- runReport השיטה הזו מחזירה דוח מותאם אישית של נתוני האירועים ב-Google Analytics, והיא השיטה המועדפת לשאילתות פשוטות מסוג דוח.
- batchRunReports זוהי גרסת אצווה של שיטת RunReport שמאפשרת ליצור מספר דוחות באמצעות קריאה אחת ל-API.
- runPivotReport השיטה הזו מחזירה דוח צירים מותאם אישית של נתוני האירועים ב-Google Analytics. דוחות ציר הם פורמטים מתקדמים יותר ואקספרסיביים יותר מדוחות רגילים. כל ציר מציג את עמודות המאפיינים והשורות הגלויים בתגובת הדוח.
- batchRunPivotReports זוהי גרסת אצווה של השיטה RunPivotReport שמאפשרת ליצור דוחות מרובים באמצעות קריאה יחידה ל-API.
- getMetadata השיטה הזו מחזירה מטא-נתונים עבור מאפיינים ומדדים שזמינים בשיטות דיווח. הנתונים משמשים לניתוח המאפיינים והמדדים. התגובה בשיטה הזו כוללת גם את המאפיינים והמדדים המותאמים אישית שזמינים לנכס GA4 שצוין.
- runRealtimeReport השיטה הזו מחזירה דוח מותאם אישית של נתוני אירועים בזמן אמת לגבי הנכס שלכם. אירועים מופיעים בדוחות 'זמן אמת' שניות ספורות לאחר שנשלחו ל-Google Analytics. בדוחות 'זמן אמת' מוצגים אירועים ונתוני שימוש לפרקי זמן שונים, החל מהרגע הנוכחי ועד לפני 30 דקות (עד 60 דקות בנכסי Google Analytics 360).
- runFunnelReport (תצוגה מקדימה מוקדמת) השיטה הזו מחזירה דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics. ניתוח משפך מספק לכם תצוגה חזותית של השלבים שהמשתמשים עוברים כדי להשלים משימה ומאפשר לכם לבדוק במהירות אם הם מצליחים להשלים כל שלבב או לא.
מאפיינים ומדדים נתמכים
תיעוד סכימת ה-API מפרט את המאפיינים והמדדים הנתמכים כרגע על ידי Analytics Data API.