יומן שינויים של Real-Time Reporting API ב-Google Analytics

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

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

הרשמה ליומני שינויים קשורים

כל יומני השינויים של Google Analytics API
–
להרשמה rss

האפשרות הזו כוללת את כל ממשקי ה-API של איסוף, הגדרה ודיווח.

כל יומני השינויים של Reporting API
–
להרשמה rss

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

יומן שינויים של Real Time Reporting API
–
להרשמה rss

גרסה זו כוללת שינויים במכסות והמגבלות של Analytics Real Time API.

הקריאות ל-Analytics Time Reporting API משמשות ליצירת מגבלה של 10,000 קריאות לצפייה (פרופיל) ביום, בהשוואה לקריאות אחרות ל-API של Analytics. עכשיו, קריאות ל-Analytics Real Time Reporting API מחושבות בנפרד. פירוש הדבר הוא שניתן לבצע 10,000 קריאות ביום לכל תצוגה מפורטת (פרופיל) באמצעות Analytics Real Time Reporting API וגם לבצע עוד 10,000 קריאות ביום לכל תצוגה מפורטת (פרופיל) באמצעות ממשקי API אחרים של Analytics. מידע נוסף זמין בדף מגבלות ומכסות.

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

זוהי גרסה לתיקון באגים:

  • בגרסה הזו תוקנה בעיה באכיפת מגבלות הסינון בשאילתת Real Time Reporting API. בקשות עם rt:activeUsers ומסנן של מאפיין ברמת האירוע יובילו לשגיאה עם סיבה badRequest ולהודעה עם הערך OR operator not supported for a hit level filter. לפרטים נוספים על אילוצי שאילתות, מומלץ לעיין במדריך למפתחים בנושא Real Time Reporting API.

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

שינינו את השם של מאפיינים ומדדים

השמות של המאפיינים והמדדים הבאים השתנו. פרטים על שינוי שמות של נתונים זמינים במדיניות בנושא הוצאה משימוש של נתונים:

משתמש

  • מאפיין - rt:visitorType – במקום זאת יש להשתמש במאפיין rt:userType.
  • מדד – rt:activeVisitors – יש להשתמש במקום זאת ב-rt:activeUsers.

הקידומת ga: הוצאה משימוש

הקידומת ga: הוצאה משימוש לכל המאפיינים והמדדים בזמן אמת, והוחלפה בקידומת החדשה rt:. בקשות API שמשתמשות בקידומת ga: ימשיכו לפעול במשך 6 חודשים, ולאחר מכן תוחזר שגיאה.

מאפיינים ומדדים חדשים

בעדכון הזה מתווספים מאפיינים ומדדים חדשים ל-Real Time Reporting API. כדאי לעיין ברשימה המלאה בחומר העזר בנושא מאפיינים ומדדים.

מעקב אחר אירועים

  • מאפיין - rt:eventAction - הפעולה של האירוע.
  • מאפיין - rt:eventCategory - קטגוריית האירוע.
  • מאפיין - rt:eventLabel - תווית האירוע.
  • מאפיין - rt:totalEvents - המספר הכולל של אירועים עבור הפרופיל, בכל הקטגוריות.

מעקב אחר יעדים

  • מאפיין - rt:goalId - מחרוזת שתואמת למזהה היעד.
  • מדד - rt:goalXXValue - הערך המספרי הכולל של מספר היעד המבוקש, כאשר XX הוא מספר בין 1 ל-20.
  • מדד - rt:goalValueAll - הערך המספרי הכולל של כל היעדים שהוגדרו עבור הפרופיל שלך.
  • מדד - rt:goalXXCompletions - מספר ההשלמות הכולל של מספר היעד המבוקש, כאשר XX הוא מספר בין 1 ל-20.
  • מדד - rt:goalCompletionsAll - מספר ההשלמות הכולל של כל היעדים שהוגדרו לפרופיל שלך.

מעקב אחר דפים

  • מדד - rt:pageViews - המספר הכולל של צפיות בדף.

מעקב אחר אפליקציה

  • מדד - rt:screenViews - המספר הכולל של צפיות במסך.

זוהי הגרסה הראשונית של Real Time Reporting API בגרסת בטא מוגבלת:

  • Real Time Reporting API מאפשר לכם לדווח על פעילות שמתרחשת בנכס כרגע. אתם יכולים להשתמש ב-Real Time Reporting API כדי לבצע שאילתות על מאפיינים ומדדים כדי ליצור ווידג'טים ומרכזי בקרה שמיועדים ללקוחות. פרטים נוספים זמינים במאמר סקירה כללית של Real Time Reporting API.