סקירה כללית

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

מבוא

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

אפשר להשתמש ב-Real Time Reporting API כדי:

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

שרת-על של Google Analytics

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

סקירה כללית של קונספט

מושגי היסוד ב-Real Time Reporting API הם:

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

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

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

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

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

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

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

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

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

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

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

מדיניות מכסה

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

השלבים הבאים

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