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

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

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

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

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

  • כמה משתמשים פעילים ביום היו לאפליקציית Android שלך בשבוע האחרון.
  • מספר הצפיות בדפים המובילים באתר ב-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 ובשפות אחרות כדי לפשט את ההטמעה.

שיטות זמינות

זו רשימה של ה-methods של 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 ‫(גרסת טרום-השקה מוקדמת) השיטה הזו מאפשרת לקבל דוח משפך מותאם אישית של נתוני האירועים ב-Google Analytics. ניתוח משפך (Funnel Exploration) הוא תצוגה חזותית של כל הפעולות שמשתמשים עושים כדי להשלים משימה, שאפשר לראות בה בקלות עד כמה הם מצליחים בכל שלב.
  • ‫properties.chat ‫(גרסת טרום-השקה מוקדמת) השיטה הזו מספקת גישה פרוגרמטית לשיחה עם Ask Advisor ב-Google Analytics. אתם יכולים לשאול שאלות בשפה טבעית לגבי נתוני האירועים, לאבחן שינויים בביצועים ולקבל תובנות מובנות בפורמט של טקסט וטבלה.

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

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