סקירה כללית

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

מבוא

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

תוכלו להשתמש ב-Real Time Reporting API כדי:

  • הצגה של צופים פעילים בדף ויצירת תחושה של דחיפות בקרב משתמשים שצופים בפריט עם מלאי שטחי פרסום סופי.
  • הצגת התוכן הפופולרי ביותר, כמו 10 הדפים הפעילים המובילים.
  • יצירה והצגה של מרכז שליטה בזמן אמת.

משתמש proxy של Google Analytics

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

סקירת קונספט

העקרונות הבסיסיים שעליהם מבוסס ה-Real Time Reporting API הם:

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

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

כדי שהמשתמשים יוכלו להשתמש באפליקציה שלכם כדי לבקש נתוני דוחות מתצוגה מפורטת (פרופיל), עליכם:

  1. מפעילים את Google Analytics API.
  2. יש ליצור פרטי כניסה עבור האפליקציה כדי לגשת ל-API.
  3. מזינים את פרטי הכניסה באפליקציה.

כשהם משתמשים באפליקציה שלכם כדי לבקש נתוני דוח, המשתמשים צריכים לאשר להם לגשת לנתונים בשמם.

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

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

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

אפשר להשתמש ב מאפיינים &מדריך; מדדי עזר כדי לגלות את כל המאפיינים והמדדים [הנחשפים דרך] הזמינים ל-API. כמו כן, יש לקרוא את מדריך ה-API לדיווח על זמן אמת כדי ללמוד איך לציין מאפיינים ומדדים בשאילתת API.

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

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

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

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

השלבים הבאים

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