גרסה 1 של Google Analytics Data API מספקת גישה פרוגרמטית לנתוני הדוחות של Google Analytics 4 (GA4). בעזרת Google Analytics 4 אפשר להבין איך אנשים משתמשים באפליקציה שלכם לאינטרנט, ל-iOS או ל-Android. מידע נוסף על נכסי Google Analytics 4
עם Google Analytics Data API v1, תוכלו ליצור דוחות כדי לענות על שאלות כמו:
- כמה משתמשים פעילים ביום היו באפליקציה ל-Android בשבוע האחרון?
- כמה צפיות בדף קיבלה כל אחת מ-10 כתובות ה-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 שצוין.
- checkCompatibility: השיטה הזו מפרטת מאפיינים ומדדים שאפשר להוסיף לבקשת דוח ולשמור על תאימות.
- runRealtimeReport השיטה הזו מחזירה דוח בהתאמה אישית של נתוני אירועים בזמן אמת לנכס שלכם. אירועים מופיעים בדוחות 'זמן אמת' שניות אחרי שהם נשלחים אל Google Analytics. בדוחות 'זמן אמת' מוצגים אירועים ונתוני שימוש לפרקי זמן, החל מהרגע הנוכחי ועד לפני 30 דקות (עד 60 דקות בנכסי Google Analytics 360).
- properties.audienceExports קבוצה של שיטות שמאפשרות ליצור פעולות ייצוא של קהלים, שכוללות תמונת מצב של המשתמשים בקהל.
- properties.recurringAudienceLists (תצוגה מקדימה מוקדמת) קבוצת שיטות שמאפשרות לנהל ייצוא חוזר של קהלים. ייצוא חוזר של קהלים יוצר בכל יום רשימות קהלים חדשות.
- runFunnelReport (תצוגה מקדימה מוקדמת): השיטה הזו מחזירה דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics. ניתוח משפך מספק לכם תצוגה חזותית של השלבים שהמשתמשים עוברים כדי להשלים משימה ומאפשר לכם לבדוק במהירות אם הם מצליחים להשלים כל שלב או לא.
מאפיינים ומדדים נתמכים
במסמכי התיעוד של סכימת ה-API מפורטים המאפיינים והמדדים שנתמכים כרגע על ידי Analytics Data API.