המגבלות והמכסות הבאות חלות על Data API.
איך המכסות חלות
כל הבקשות ל-Google Analytics Data API v1 מחייבות פרויקט ב-Google Cloud וכפופות למכסות שמפורטות בדף הזה. המכסות נצרכות ללא קשר לשיטה שבה משתמשים כדי לזהות את הפרויקט שמבצע את הקריאה, כולל:
- בקשות שאומתו באמצעות פרטי כניסה של OAuth 2.0.
- בקשות שאומתו באמצעות מפתח API בלבד.
מפתחות API משמשים לשיוך בקשה לפרויקט בענן ספציפי ב-Google לצורכי מכסה וחיוב. כל הקריאות ל-API שמתבצעות באמצעות פרטי כניסה או מפתח API מהפרויקט שלכם ייספרו במכסות הרלוונטיות של הפרויקט ושל נכס Google Analytics.
קטגוריות מכסות
ל-Data API יש ארבע קטגוריות של מכסות בקשות: ליבה, זמן אמת, משפך וצ'אט.
בקשות API לשיטות ליבה מחויבות לפי מכסות הליבה. בקשות API לשיטות של Realtime מחויבות לפי מכסות של Realtime. בקשות API ל-methods של Funnel מחויבות במסגרת מכסות Funnel. בקשות API לשיטות של Chat מחויבות לפי מכסות של Chat. כל בקשה צורכת רק סוג אחד של מכסה.
| קטגוריית מכסה | שיטות API |
|---|---|
| ליבה | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| זמן אמת | runRealtimeReport |
| משפך | runFunnelReport |
| צ'אט | properties.chat |
מכסות בנכס Analytics
כל הבקשות צורכות מכסות של נכסים.
| שם המכסה | מגבלות בנכסים רגילים | מגבלת נכסים ב-Analytics 360 |
|---|---|---|
| טוקנים מרכזיים לכל נכס ביום | 200,000 | 2,000,000 |
| Core Tokens Per Property Per Hour | 40,000 | 400,000 |
| טוקנים מרכזיים לכל פרויקט לכל נכס לכל שעה | 14,000 | 140,000 |
| בקשות ליבה בו-זמניות לכל נכס | 10 | 50 |
| שגיאות ליבה בחיבור לשרת לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
| טוקנים בזמן אמת לכל נכס ביום | 200,000 | 2,000,000 |
| טוקנים בזמן אמת לכל נכס לשעה | 40,000 | 400,000 |
| טוקנים בזמן אמת לכל פרויקט, לכל נכס, לכל שעה | 14,000 | 140,000 |
| בקשות מקבילות בזמן אמת לכל נכס | 10 | 50 |
| שגיאות בחיבור לשרת בזמן אמת לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
| טוקנים של משפך לכל נכס ביום | 200,000 | 2,000,000 |
| טוקנים של משפך לכל נכס לשעה | 40,000 | 400,000 |
| Funnel Tokens Per Project Per Property Per Hour | 14,000 | 140,000 |
| בקשות בו-זמניות במשפך לכל נכס | 10 | 50 |
| שגיאות בחיבור לשרת במשפך לכל פרויקט, לכל נכס ולכל שעה | 10 | 50 |
| טוקנים של צ'אט לכל נכס ביום | 3,750,000 | 3,750,000 |
| Chat Tokens Per Property Per Hour | 500,000 | 500,000 |
- בקשות בו-זמניות נמדדות לפי מספר הבקשות שמופעלות בו-זמנית. כדי לצמצם את מספר הבקשות המקבילות, צריך לחכות שהבקשות הקודמות יושלמו לפני ששולחים בקשות נוספות.
- שגיאות שרת הן קודים 500 ו-503. המכסות של שגיאות בחיבור לשרת מחויבות רק אם בקשה מסוימת גורמת לשגיאה בחיבור לשרת. כשמגיעים למכסת השימוש של שגיאות השרת בפרויקט ובנכס, כל הבקשות לנכס מהפרויקט נחסמות. רשימה מלאה של תגובות שגיאה מופיעה במאמר בנושא תגובות שגיאה.
- כל בקשה צורכת מכסה גם של Tokens Per Property Per Hour וגם של Tokens Per Project Per Property Per Hour. כלומר, יכול להיות שנגיע למכסת השימוש של 'טוקנים לכל נכס לשעה' לפני מכסת השימוש של 'טוקנים לכל פרויקט לכל נכס לשעה', אם יותר מ-3 פרויקטים ניגשים לאותו נכס.
לכל נכס מותר לשלוח 120 בקשות לשעה שעשויות להיות כפופות לסף. יכול להיות שהמדדים userAgeBracket, userGender, brandingInterest, audienceId ו-audienceName הוגבלו. המטרה של ערכי הסף היא למנוע ממי שצופה בדוח להסיק ממנו נתונים דמוגרפיים או תחומי עניין של משתמשים ספציפיים.
מכסת טוקנים של נכסים
טוקנים נצרכים עם כל בקשה ל-Google Analytics Data API v1.
מספר האסימונים שחויבו תלוי במורכבות הבקשה. ברוב הבקשות נגבה תשלום של 10 טוקנים או פחות, אבל בבקשות מורכבות יותר (כמו שאילתות של Analytics Advisor chat) נגבה תשלום גבוה יותר.
גורמים שמשפיעים על צריכת הטוקנים
העלות המדויקת של האסימון עבור בקשה נקבעת בזמן הביצוע, ולכן קשה לבצע חישוב מדויק מראש. העלות מושפעת משילוב של גורמים שקשורים לבקשה עצמה ולנתונים הבסיסיים בנכס ב-Google Analytics. הגורמים הבאים יכולים להוביל לעלויות גבוהות יותר:
- מספר השורות: בקשת מספר גדול יותר של שורות.
- מספר המאפיינים והמדדים: כולל מספר גדול יותר של מאפיינים ומדדים.
- מורכבות הסינון: שימוש בביטויי סינון מורכבים.
- אורך טווח התאריכים: שאילתות על תקופות ארוכות יותר.
- עוצמת הנתונים (cardinality): מאפיינים בעלי עוצמה גבוהה (הרבה ערכים ייחודיים, כמו
pagePath, מאפיינים מותאמים אישית) יכולים להגדיל באופן משמעותי את עלות האסימונים. - נפח האירועים בנכס: שאילתות בנכסים עם נפח גבוה יותר של אירועים עשויות לצרוך יותר טוקנים מאשר אותה שאילתה בנכס עם פחות נתונים.
מעקב אחרי השימוש בטוקנים
הדרך היעילה ביותר לקבוע את עלות הטוקנים של קריאות ספציפיות ל-API היא לכלול את הפרמטר "returnPropertyQuota": true בגוף הבקשה.
תגובת ה-API תכלול את האובייקט PropertyQuota, שבו מפורטים הטוקנים שנצרכו בבקשה הספציפית הזו ויתרות המכסות שנותרו.
שימוש באסימונים ב-Chat ומעקב אחריו
בבקשות ל-Analytics Advisor chat, הטוקנים מייצגים את העלויות של חישוב המודל, חשיבה רציונלית ואחזור נתוני הבסיס. הגורמים שמשפיעים על צריכת האסימונים ב-Chat:
- היקף השאילתה והניתוח: מורכבות ורוחב הניתוח המבוקש.
- טוקנים של קלט ופלט של המודל: נפח הנתונים ההקשריים שעברו עיבוד והנרטיב של התגובה שנוצר.
- אסימוני חשיבה: שלבים של ניתוח נתונים שנדרשים כדי לסכם את הממצאים.
- זמן אחזור של ביצוע: זמן העיבוד שנדרש לניתוח נתונים רב-שלבי.
כדי לעקוב אחרי השימוש בטוקנים בצ'אט, מגדירים "returnPropertyQuota": true
ב-ChatRequest. התגובה תכלול את אובייקט PropertyChatQuota שמכיל את השדות tokensPerDay ו-tokensPerHour עם היתרות שנוצלו והיתרות שנותרו.