סקירה כללית

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

מבוא

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

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

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

SuperProxy של Google Analytics

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

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

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

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

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

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

  1. מפעילים את ממשק ה-API של Google Analytics.
  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 פועל, תוכלו להתחיל: