כל בקשת API מאמתת שהמכסות לא מוצו ומנצלת את המכסות. אם תנוצל כל המכסה, הבקשה תיכשל ותוצג הודעת שגיאה רלוונטית. כל בקשת Data API בודקת כמה קטגוריות מכסה.
קטגוריות מכסה
לצורכי המכסה, ה-Data API כולל שלוש קטגוריות של בקשות: Core, זמן אמת ומשפך. בקשות API לשיטות ליבה מחייבות מכסות ליבה. בקשות API לשיטות בזמן אמת מחייבות מכסות בזמן אמת. בקשה אחת לא צורכת גם את המכסות של הליבה וגם את המכסות בזמן אמת. אלה השיטות והקטגוריות של ה-API:
| קטגוריית מכסה | שיטות API |
|---|---|
| התוכן הקבוע | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| זמן אמת | runRealtimeReport |
| משפך | runFunnelReport |
מכסות של נכסים ב-Analytics
כל הבקשות מנצלות מכסות של נכסים.
| שם המכסה | מגבלה של נכס רגיל | מגבלת נכסים ב-Analytics 360 |
|---|---|---|
| אסימוני ליבה לנכס ביום | 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 |
| אסימונים בזמן אמת לכל פרויקט לנכס לשעה | 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 |
- בקשות בו-זמניות נמדדות לפי מספר הבקשות שמתבצעות בו-זמנית. על מנת לצמצם את הבו-זמניות של הבקשות שלך, עליך להמתין עד שבקשות קודמות יושלמו לפני שליחת בקשות נוספות.
- שגיאות שרת הן קודים 500 ו-503. המכסות לשגיאות בחיבור לשרת מחויבות רק בתגובה לבקשות שגיאה בחיבור לשרת. אם מיציתם את המכסות של השגיאות בשרת בצמד אחד של פרויקטים ונכסים, כל הבקשות לנכס מהפרויקט נחסמות.
- כל בקשה משתמשת במכסה של אסימונים לנכס לשעה וגם אסימונים לפרויקט לשעה. כלומר, צריך לגשת לנכס ליותר מ-3 פרויקטים לפני שהמכסה 'אסימונים לכל נכס לשעה' תנוצל לפני המכסה 'אסימונים לכל פרויקט לכל שעה'.
לנכסים יכולים להיות 120 בקשות שעשויות לעמוד בסף חיוב לשעה. המאפיינים userAgeBracket, userGender, brandingInterest, audienceId ו-audienceName עשויים להגיע לסף. ערכי הסף חלים על מנת למנוע ממי שצופה בדוח להסיק את הנתונים הדמוגרפיים או תחומי העניין של משתמשים ספציפיים.
מכסה של אסימונים לנכס
האסימונים מחושבים בכל בקשה בהתאם למורכבות הבקשה. רוב הבקשות יחייבו 10 אסימונים או פחות. כשבקשה מסוימת משתמשת במספר גדול של אסימוני מכסה, לרוב הגורמים האלה אחראים:
- מספר גדול של שורות
- מספר גדול של עמודות
- קריטריונים לסינון מורכב
- טווח תאריכים ארוך
בכל בקשת API אפשר לציין "returnPropertyQuota": true בגוף הבקשה, כדי להחזיר את הסטטוס הנוכחי של אסימוני המכסה לנכס. הסטטוס כולל גם את הסכום שנוצל על ידי הבקשה וגם את הסכום שנותר לכל קבוצת מכסות. לדוגמה, כדאי לציין את הפרמטר הזה ב-RunReportRequest.