סקירה כללית על Google Analytics Data API

אפשר להשתמש ב-Data API כדי לגשת באופן פרוגרמטי לנתוני דוחות של Google Analytics (Google Analytics). ממשק ה-API הזה לא תואם לנכסי Universal Analytics מדור קודם.

מידע נוסף על נכסי Google Analytics

ריכזנו כאן כמה דוגמאות לנתונים שאפשר לדווח עליהם באמצעות Google Analytics Data API v1:

  • מספר המשתמשים הפעילים ביום באפליקציה ל-Android בשבוע האחרון.
  • מספר הצפיות בדפים 10 המובילים באתר שלכם ב-28 הימים האחרונים.
  • מספר המשתמשים הפעילים בכל מדינה באפליקציה ל-iOS ב-30 הדקות האחרונות.

אפשר גם להשתמש ב-Google Analytics Data API v1 כדי:

  • ליצור לוחות בקרה בהתאמה אישית כדי להציג נתונים מ-Google Analytics.
  • אוטומציה של משימות מורכבות בדיווח כדי לחסוך זמן.
  • שילוב של נתוני Google Analytics עם אפליקציות עסקיות אחרות.

שנתחיל?

כדי להתחיל, אפשר לעיין במדריך למתחילים בספריית הלקוח. יש ספריות לקוח ב-Java,‏ Python,‏ Node.js ובשפות אחרות כדי לפשט את ההטמעה.

השיטות הזמינות

זוהי רשימה של השיטות של 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 קבוצה של שיטות שמאפשרות לייצא קהלים, כולל קובץ snapshot של המשתמשים בקהל.
  • properties.recurringAudienceLists (תצוגה מקדימה מוקדמת) קבוצה של שיטות שמאפשרות לנהל ייצוא קבוע של קהלים. ייצוא קבוע של קהלים יוצר רשימות קהלים חדשות מדי יום.
  • runFunnelReport (תצוגה מקדימה מוקדמת) השיטה הזו מאפשרת לקבל דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics. ניתוח משפך ממחיש חזותית את הפעולות שהמשתמשים מבצעים כדי להשלים משימה, ומאפשר לכם לבדוק מה מידת ההצלחה שלהם בכל שלב.

מאפיינים ומדדים נתמכים

רשימה של כל המאפיינים והמדדים שנתמכים ב-Data API מופיעה במסמכי התיעוד של הסכימה של ה-API.