מהו ה-Core Reporting API – סקירה כללית

במסמך הזה מוצגת סקירה כללית של ה-Core Reporting API גרסה 3.0 של Google Analytics. מידע מפורט לגבי ה-API זמין במדריך העזר.

מבוא

Google Analytics Core Reporting API מאפשר לך לגשת לרוב נתוני הדוח ב-Google Analytics. בעזרת ה-Core Reporting API אפשר:

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

בחירת גרסה

לאחרונה השקנו גרסה חדשה של Core Reporting API.

  • יוצרים אפליקציה חדשה? – מומלץ להשתמש בגרסה 3.0 העדכנית ביותר.
  • משתמשים בגרסה 2.3 מהדור הקודם? – אפשר לקרוא את המדריך להעברת נתונים כדי לקבל פרטים על אופן העדכון של האפליקציה לשימוש בגרסה החדשה.

תחילת העבודה

רוצה להתחיל כבר עכשיו? קראו את המדריך של Hello ל-Analytics API.

כל אפליקציה שמשתמשת ב-API צריכה לעבור מספר שלבים כדי להירשם, לאשר את המשתמש ולעבוד עם ה-API. המדריך הזה כולל הסבר מפורט על כל שלב בתהליך, ובסופו תהיה לך אפליקציה פעילה שאפשר להתאים אישית.

סקירה כללית של מושגים

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

ה-Core Reporting API כולל 3 מושגים בסיסיים:

  1. כיצד דוחות קשורים למשתמשים ולתצוגות מפורטות (פרופילים).
  2. המבנה של דוח ובניית שאילתות
  3. עבודה עם התגובה מה-API

דוחות, משתמשים ותצוגות מפורטות (פרופילים)

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

יש כמה דרכים לאתר את מזהה התצוגה המפורטת (הפרופיל) שלכם.

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

שליחת שאילתות לגבי מאפיינים ומדדים

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

אפשר להיעזר ב מדריך האינטראקטיבי בנושא מאפיינים ומדדים כדי לעיין בכל המאפיינים והמדדים שנחשפים דרך ה-API. מומלץ גם לקרוא את מדריך העזר ל-Core Reporting API כדי ללמוד איך לציין מאפיינים ומדדים בשאילתה של API.

עבודה עם דוחות

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

למידע נוסף על תגובת ה-API, ניתן לקרוא את מדריך העזר המרכזי ל-Reporting API.

חזרה למעלה

מדיניות בנושא מכסות והוצאה משימוש

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

לקבלת פרטים על אופן הטיפול בשינויים בעמודות הליבה של Reporting API (כלומר מאפיינים ומדדים) אפשר לקרוא את המדיניות בנושא הוצאה משימוש של נתונים. ב מדריך למפתחים בנושא Metadata API מוסבר איך אפשר להשתמש ב- Metadata API כדי לחפש עמודות שהוצאו משימוש.

השלבים הבאים

עכשיו, אחרי שהבנת איך ה-API פועל, יש לנו כמה משאבים שיעזרו לך להתחיל:

  • לקבלת מידע על עבודה עם ה-API, ניתן לעיין ב מדריך למפתחים.
  • אפשר להשתמש בכלי האינטראקטיבי Query Explorer כדי ליצור באופן חזותי שאילתות ולראות את התשובה שלהן דרך ה-API.
  • קראו את המאמר שאילתות נפוצות שמפרט כמה מהשאילתות הנפוצות ביותר ל-Core Reporting API.
  • במאמר מאפיינים ומדדים מופיעה רשימה של כל הנתונים שזמינים דרך ה-API.
  • בדף ספריות ודוגמאות מופיעה רשימה של כל ספריות הלקוח הזמינות שאפשר להשתמש בהן עם ה-API הזה.

חזרה למעלה