אתם יכולים להשתמש ב-Data API כדי לגשת באופן פרוגרמטי לנתוני דוחות מ-Google Analytics (GA). ה-API הזה לא תואם לנכסי Universal Analytics מדור קודם.
מידע נוסף על נכסי Google Analytics
הנה כמה דוגמאות לנתונים שאפשר לדווח עליהם באמצעות Google Analytics Data API v1:
- מספר המשתמשים הפעילים ביום באפליקציית Android בשבוע האחרון.
- מספר הצפיות בדפים ב-10 הדפים המובילים באתר שלך ב-28 הימים האחרונים.
- מספר המשתמשים הפעילים באפליקציית iOS שלכם בכל מדינה ב-30 הדקות האחרונות.
אפשר גם להשתמש ב-Google Analytics Data API v1 כדי:
- ליצור לוחות בקרה בהתאמה אישית כדי להציג נתונים מ-Google Analytics.
- אוטומציה של משימות מורכבות שקשורות לדיווח כדי לחסוך זמן.
- שילוב הנתונים שלכם ב-Google Analytics עם אפליקציות עסקיות אחרות.
עקביות נתונים וזיהוי של מי שמדווח
Google Analytics Data API v1 ניגש לאותם נתוני דוחות כמו ממשק Google Analytics. הנתונים שמוחזרים על ידי ה-API מכבדים באופן מלא את ההגדרות של זיהוי של מי שמדווח שהוגדרו בנכס ב-Google Analytics שלכם, כך שמספר המשתמשים, ביטול הכפילויות ומידול הנתונים תואמים למרחב הזהויות שנבחר – כמו משולב, מתועד או מבוסס-מכשיר – בהגדרות הנכס.
במאמר זיהוי של מי שמדווח מוסבר איך מרחבי זהות שונים יכולים להשפיע על הדוחות.
שנתחיל?
כדי להתחיל, אפשר לעיין במדריך לתחילת העבודה עם ספריית לקוח. יש ספריות לקוח ב-Java, ב-Python, ב-Node.js ובשפות אחרות כדי לפשט את ההטמעה.
שיטות זמינות
בהמשך מופיעה רשימה של רכיבי ה-method של Data API. לפרטים נוספים, אפשר לעיין במסמכי התיעוד.
-
runReportהשיטה הזו מחזירה דוח מותאם אישית של נתוני האירועים ב-Google Analytics, והיא השיטה המועדפת לשאילתות פשוטות של דוחות. -
batchRunReportsזוהי גרסת אצווה של השיטה runReport שמאפשרת ליצור כמה דוחות באמצעות קריאה אחת ל-API. -
runPivotReportהשיטה הזו מחזירה דוח ציר מותאם אישית של נתוני האירועים ב-Google Analytics. דוחות ציר הם פורמטים מתקדמים יותר ובעלי יכולת הבעה גבוהה יותר מדוחות רגילים. כל ציר מתאר את העמודות והשורות של המאפיינים שמוצגים בתגובת הדוח. batchRunPivotReportsזוהי גרסת אצווה של השיטה runPivotReport שמאפשרת ליצור כמה דוחות באמצעות קריאה ל-API אחת.-
getMetadataהשיטה הזו מחזירה מטא-נתונים של מאפיינים ומדדים שזמינים בשיטות דיווח. הפרמטר הזה משמש לניתוח המאפיינים והמדדים. התגובה של השיטה הזו כוללת גם את המאפיינים והמדדים המותאמים אישית שזמינים בנכס Google Analytics שצוין. -
checkCompatibilityבשיטה הזו מפורטים המאפיינים והמדדים שאפשר להוסיף לבקשת דוח ולשמור על תאימות. -
runRealtimeReportהשיטה הזו מחזירה דוח מותאם אישית של נתוני אירועים בזמן אמת בנכס. אירועים מופיעים בדוחות בזמן אמת שניות אחרי שהם נשלחים ל-Google Analytics. בדוחות 'פעילות בזמן אמת' מוצגים אירועים ונתוני שימוש לתקופות זמן שמתחילות ברגע הנוכחי ומסתיימות 30 דקות לפני כן (עד 60 דקות בנכסי Google Analytics 360). properties.audienceExportsקבוצה של שיטות שמאפשרות ליצור קובצי Audience Exports, שכוללים תמונת מצב של המשתמשים בקהל.properties.recurringAudienceLists(גרסת טרום-השקה) קבוצה של שיטות שמאפשרות לכם לנהל ייצוא חוזר של קהלים. ייצוא קהלים חוזר יוצר רשימות קהלים חדשות בכל יום.-
runFunnelReport(גרסת Preview מוקדמת) השיטה הזו מאפשרת לקבל דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics. ניתוח משפך (Funnel Exploration) הוא תצוגה חזותית של כל הפעולות שמשתמשים עושים כדי להשלים משימה, שאפשר לראות בה בקלות עד כמה הם מצליחים בכל שלב.
מאפיינים ומדדים נתמכים
רשימה של כל המאפיינים והמדדים שנתמכים על ידי Data API מופיעה במסמכי התיעוד של סכימת ה-API.