ממשק API לדיווח על משפכים מרובי-ערוצים - מדריך

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

מבוא

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

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

  • שילוב של מאפיינים ומדדים.
  • טווח תאריכים.
  • קבוצה של פרמטרים של אפשרויות שקובעים אילו נתונים יוחזרו

ה-API הופך את שיטת report.get לזמינה בנקודת קצה ב-REST: https://www.googleapis.com/analytics/v3/data/mcf. בקטע הבא מוצגת בקשה לדוגמה ותיאור של כל אחד מהפרמטרים.

שליחת בקשה

ה-API מספק שיטה אחת לבקשת נתונים:

analytics.data.mcf.get()

אפשר גם לשלוח שאילתה ל-API כנקודת קצה ל-REST:

Authorization: Bearer {oauth2-token}

GET https://www.googleapis.com/analytics/v3/data/mcf
  ?ids=ga:12345
  &metrics=mcf:totalConversions,mcf:totalConversionValue
  &start-date=2011-10-01
  &end-date=2011-10-31

כל פרמטר של שאילתת כתובת URL מציין פרמטר של שאילתת API שחייב להיות מקודד של כתובת URL.

כל הבקשות ל-API של משפכים מרובי-ערוצים חייבות להיות מותרות. עדיף דרך OAuth 2.0.

סיכום הפרמטרים של השאילתה

בטבלה הבאה מסוכם כל הפרמטרים של שאילתות שאושרו על ידי ה-Reporting API של משפכים מרובי-ערוצים. לוחצים על כל שם של פרמטר כדי לקבל תיאור מפורט.

שם ערך חובה סיכום
ids string כן מזהה הטבלה הייחודי של הטופס ga:XXXX, שבו XXXX הוא מזהה התצוגה המפורטת (הפרופיל) ב-Analytics שעבורו השאילתה תאחזר את הנתונים.
start-date string כן תאריך ההתחלה של אחזור נתוני Analytics. בקשות עשויות לציין תאריך התחלה בפורמט YYYY-MM-DD, או כתאריך יחסי (למשל, today, yesterday או NdaysAgo כאשר N הוא מספר שלם חיובי).
end-date string כן תאריך הסיום לאחזור הנתונים של Analytics. ניתן לציין תאריך סיום בפורמט YYYY-MM-DD, או כתאריך יחסי (למשל, today, yesterday או NdaysAgo כאשר N הוא מספר שלם חיובי).
metrics string כן רשימה של מדדים המופרדים בפסיקים, כמו mcf:totalConversions,mcf:totalConversionValue. שאילתה חוקית חייבת לציין לפחות מדד אחד.
dimensions string no רשימת מאפיינים המופרדים באמצעות פסיקים עבור הדוח 'משפכים מרובי-ערוצים' כגון mcf:source,mcf:keyword.
sort string no רשימה של מאפיינים ומדדים המופרדים בפסיקים, שמציינים את סדר המיון ואת כיוון המיון של הנתונים שהוחזרו.
filters string no מסננים של מאפיינים או מדדים שמגבילים את הנתונים שהוחזרו עבור הבקשה שלך.
samplingLevel string no רמת הדגימה הרצויה. ערכים מורשים:
  • DEFAULT — מחזירה תגובה עם גודל לדוגמה שמאזן את המהירות והדיוק.
  • FASTER — מחזירה תגובה מהירה עם דגימה קטנה יותר.
  • HIGHER_PRECISION — החזרת תגובה מדויקת יותר באמצעות גודל דגימה גדול, אבל התוצאה עשויה להיות איטית יותר.
start-index integer no השורה הראשונה של הנתונים לאחזור, החל מ-1. אפשר להשתמש בפרמטר הזה כמנגנון עימוד, לצד הפרמטר max-results.
max-results integer no מספר השורות המקסימלי שיש לכלול בתגובה.

פרטי פרמטר השאילתה

מזהים

ids=ga:12345
חובה.
המזהה הייחודי המשמש לאחזור הנתונים של משפכים מרובי-ערוצים. המזהה הזה הוא שרשור של מרחב השמות ga: עם המזהה (הפרופיל) של הדוח. אפשר לאחזר את מזהה התצוגה המפורטת (הפרופיל) בדוח באמצעות השיטה analytics.management.profiles.list, שמספקת את id למשאב 'תצוגה (פרופיל)' ב- Google Analytics Management API.

חזרה למעלה


תאריך התחלה

start-date=2011-10-01
חובה.
כל הבקשות לנתונים של משפכים מרובי-ערוצים חייבים לציין טווח תאריכים. אם לא כוללים את הפרמטרים start-date ו-end-date בבקשה, השרת מחזיר שגיאה. ערכים של תאריכים יכולים להיות עבור תאריך מסוים באמצעות התבנית YYYY-MM-DD או באופן יחסי באמצעות today, yesterday או תבנית NdaysAgo. הערכים צריכים להיות תואמים ל-[0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo).
הstart-date התקף המוקדם ביותר הוא 2011-01-01. אין מגבלה עליונה ב-start-date.
התאריכים היחסיים הם תמיד יחסיים לתאריך הנוכחי בזמן השאילתה ומבוססים על אזור הזמן של התצוגה המפורטת (הפרופיל) שצוינה בשאילתה.

טווח תאריכים לדוגמה מ-7 הימים האחרונים (שהתחיל אתמול) לפי תאריכים יחסיים:

  &start-date=7daysAgo
  &end-date=yesterday

חזרה למעלה


תאריך סיום

end-date=2011-10-31
חובה.
כל הבקשות לנתונים של משפכים מרובי-ערוצים חייבים לציין טווח תאריכים. אם לא כוללים את הפרמטרים start-date ו-end-date בבקשה, השרת מחזיר שגיאה. ערכים של תאריכים יכולים להיות עבור תאריך מסוים באמצעות התבנית YYYY-MM-DD או באופן יחסי באמצעות today, yesterday או תבנית NdaysAgo. הערכים צריכים להיות תואמים ל-[0-9]{4}-[0-9]{2}-[0-9]{2}|today|yesterday|[0-9]+(daysAgo).
הרכישה המוקדמת ביותר מבחינת end-date היא 2005-01-01. אין מגבלה עליונה לאפליקציה end-date.
התאריכים היחסיים הם תמיד יחסיים לתאריך הנוכחי בזמן השאילתה ומבוססים על אזור הזמן של התצוגה המפורטת (הפרופיל) שצוינה בשאילתה.

טווח תאריכים לדוגמה מ-10 הימים האחרונים (החל מהיום) לפי תאריכים יחסיים:

  &start-date=9daysAgo
  &end-date=today

חזרה למעלה


מימדים

dimensions=mcf:source,mcf:keyword
אופציונלי.

פרמטר המאפיינים מגדיר את מפתחות הנתונים העיקריים בדוח 'משפכים מרובי-ערוצים', כגון mcf:source או mcf:medium. בעזרת מאפיינים אפשר לפלח את מדדי ההמרות. לדוגמה, אמנם אתה יכול לבקש את המספר הכולל של המרות לאתר שלך, אבל זה עשוי להיות מעניין יותר לבקש את מספר ההמרות עם פילוח לפי אמצעי ההגעה לאתר. במקרה כזה, יוצג מספר ההמרות מאורגני, מהפניה, מאימייל וכן הלאה.

כשמשתמשים ב-dimensions בבקשת נתונים, חשוב לשים לב למגבלות הבאות:

  • ניתן לציין עד 7 מאפיינים בכל שאילתה.
  • אפשר לא לשלוח שאילתה שמורכבת ממאפיינים בלבד: יש לשלב בין כל המאפיינים המבוקשים לבין מדד אחד לפחות.

ערכים לא זמינים

במקרים שבהם לא ניתן לקבוע את ערך המאפיין, מערכת Analytics משתמשת במחרוזת המיוחדת (לא מוגדרת).

חזרה למעלה


ערכים

metrics=mcf:totalConversions,mcf:totalConversionValue
חובה.

הנתונים הסטטיסטיים המצטברים של פעילות המשתמשים באתר, כמו סך כל ההמרות או ערך ההמרות הכולל. אם בשאילתה אין פרמטר dimensions, המדדים שהוחזרו מספקים ערכים מצטברים עבור טווח התאריכים המבוקש, כמו ערך ההמרה הכולל. עם זאת, כשמבקשים מאפיינים, הערכים מפולחים לפי ערך המאפיין. לדוגמה, הבקשה mcf:totalConversions עם mcf:source מחזירה את המספר הכולל של ההמרות לכל מקור.

כשמבקשים מדדים, חשוב לזכור:

  • כל בקשה חייבת לספק ערך אחד לפחות. בקשה לא יכולה לכלול רק מאפיינים.
  • אפשר לציין עד 10 מדדים לכל שאילתה.

חזרה למעלה


מיון

sort=mcf:source,mcf:medium
אופציונלי.

רשימה של מדדים ומאפיינים שמציינים את סדר המיון ואת כיוון המיון של הנתונים שהוחזרו.

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

מיון התוצאות של שאילתה מאפשר לשאול שאלות שונות לגבי הנתונים. לדוגמה, כדי להתייחס לשאלה "מהם מקורות ההמרות המובילים שלי, ודרך אילו אמצעי הגעה לאתר?" ניתן לשלוח שאילתה עם הפרמטר הבא. העמודה ממוינת ראשונה לפי mcf:source ואז לפי mcf:medium, בסדר עולה:

sort=mcf:source,mcf:medium

כדי לענות על השאלה הקשורה, מהו אמצעי ההגעה לאתר המובילים שלי להמרה ומה המקור שלהם?, ניתן ליצור שאילתה עם הפרמטר הבא. העמודה ממוינת ראשונה לפי mcf:medium, ואחר כך לפי mcf:source, בסדר עולה:

sort=mcf:medium,mcf:source

כשמשתמשים בפרמטר sort, חשוב לזכור:

  • מיון רק לפי ערכים של מאפיינים או מדדים שבהם השתמשת בפרמטרים dimensions או metrics. אם הבקשה תמיין בשדה שלא צוין בפרמטר או במאפיינים או במדדים, תופיע הודעת שגיאה.
  • כברירת מחדל, המחרוזות ממוינות בסדר אלפביתי עולה באזור en-US.
  • המספרים ממוינים לפי סדר מספרי עולה כברירת מחדל.
  • התאריכים ממוינים בסדר עולה לפי תאריך כברירת מחדל.

חזרה למעלה


מסננים

filters=mcf:medium%3D%3Dreferral
אופציונלי.

הפרמטר filters של מחרוזת השאילתה מגביל את הנתונים שהוחזרו מהבקשה שלך. כדי להשתמש בפרמטר filters, צריך לספק מאפיין או מדד שעליו רוצים לסנן, ולאחר מכן להוסיף את ביטוי המסנן. לדוגמה, השאילתה הבאה מבקשת את mcf:totalConversions ואת mcf:source עבור התצוגה המפורטת (הפרופיל) 12134, שבה המאפיין mcf:medium הוא המחרוזת referral:

https://www.googleapis.com/analytics/v3/data/mcf
?ids=mcf:12134
&dimensions=mcf:source
&metrics=mcf:totalConversions
&filters=mcf:medium%3D%3Dreferral
&start-date=2011-10-01
&end-date=2011-10-31

פרטים נוספים זמינים בחומר העזר בנושא Core Reporting API.

חזרה למעלה


רמת דגימה

samplingLevel=DEFAULT
אופציונלי.
אפשר להשתמש בפרמטר הזה כדי להגדיר את רמת הדגימה (כלומר מספר הביקורים ששימש לחישוב התוצאה) בשאילתת הדיווח. הערכים המותרים תואמים לממשק האינטרנט וכוללים:
  • DEFAULT — מחזירה תגובה עם גודל לדוגמה שמאזן את המהירות והדיוק.
  • FASTER — מחזירה תגובה מהירה עם דגימה קטנה יותר.
  • HIGHER_PRECISION — החזרת תגובה מדויקת יותר באמצעות גודל דגימה גדול, אבל התוצאה עשויה להיות איטית יותר.
אם לא תספק/י את הדגימה, ייעשה שימוש ברמת הדגימה של DEFAULT.
בקטע דגימה מוסבר איך לחשב את אחוז הביקורים שבהם השאילתה נשלחה.

חזרה למעלה


תוצאות מקסימליות

max-results=100
אופציונלי.

מספר השורות המקסימלי שיש לכלול בתגובה זו. אפשר להשתמש בשילוב עם start-index כדי לאחזר קבוצת משנה של רכיבים, או להשתמש בה בלבד כדי להגביל את מספר הרכיבים שיוחזרו, החל מהראשון. אם לא תספקו את max-results, השאילתה תחזיר את ברירת המחדל של 1,000 שורות.

ה-Reporting API למשפכים מרובי-ערוצים מחזיר לכל היותר 10,000 שורות לכל בקשה, ללא קשר לבקשה. הוא גם יכול להחזיר פחות שורות מכפי שביקשת, אם אין הרבה פלחי מאפיינים כפי שציפית. לדוגמה, יש פחות מ-300 ערכים אפשריים עבור mcf:medium, כך שכאשר מפלחים רק לפי אמצעי הגעה לאתר, לא ניתן לקבל יותר מ-300 שורות, גם אם מגדירים max-results לערך גבוה יותר.

חזרה למעלה


תשובה

אם הבקשה תאושר, גוף התגובה יוחזר עם מבנה ה-JSON המוגדר למטה.

הערה: המונח "results" מתייחס לכל קבוצת השורות שתואמת לשאילתה, ואילו "response" מתייחס לקבוצת השורות שהוחזרו בדף התוצאות הנוכחי. התגובות עשויות להיות שונות אם המספר הכולל של התוצאות גדול יותר מהגודל של הדף בתגובה הנוכחית, כפי שמוסבר ב-itemsPerPage.

פורמט תגובה

JSON
{
  "kind": "analytics#mcfData",
  "id": string,
  "query": {
    "start-date": string,
    "end-date": string,
    "ids": string,
    "dimensions": [
      string
    ],
    "metrics": [
      string
    ],
    "sort": [
      string
    ],
    "filters": string,
    "samplingLevel": string,
    "start-index": integer,
    "max-results": integer
  },
  "itemsPerPage": integer,
  "totalResults": integer,
  "selfLink": string,
  "previousLink": string,
  "nextLink": string,
  "profileInfo": {
    "profileId": string,
    "accountId": string,
    "webPropertyId": string,
    "internalWebPropertyId": string,
    "profileName": string,
    "tableId": string
  },
  "containsSampledData": boolean,
  "sampleSize": string,
  "sampleSpace": string,
  "columnHeaders": [
    {
      "name": string,
      "columnType": string,
      "dataType": string
    }
  ],
  "totalsForAllResults": [
    {
      metricName: string,
      ...
    }
  ]
  "rows": [
    [
      McfData.Rows
    ]
  ],
}

חזרה למעלה

שדות תגובה

המאפיינים של מבנה גוף התגובה מוגדרים כך:

שם הנכס ערך תיאור
kind string סוג המשאב. הערך הוא "analytics#mcfData".
id string המזהה של תגובת הנתונים הזו.
query object האובייקט מכיל את כל הערכים שהועברו כפרמטרים לשאילתה. המשמעות של כל שדה מוסברת בתיאור של פרמטר השאילתה התואם.
query.start-date string תאריך התחלה.
query.end-date string תאריך סיום.
query.ids string מזהה טבלה ייחודי.
query.dimensions[] list רשימת מאפיינים של ניתוח נתונים.
query.metrics[] list רשימת מדדים לניתוח נתונים.
query.sort[] list רשימת מדדים או מאפיינים שבהם הנתונים ממוינים.
query.filters string רשימה של מסנני מדדים או מאפיינים המופרדים בפסיקים.
query.samplingLevel string Requested sampling level.
query.start-index integer אינדקס ההתחלה של שורות. ערך ברירת המחדל הוא 1.
query.max-results integer מספר התוצאות המקסימלי בכל דף.
startIndex integer אינדקס ההתחלה של שורות שצוין על ידי פרמטר השאילתה start-index. ערך ברירת המחדל הוא 1.
itemsPerPage integer המספר המקסימלי של שורות שהתגובה יכולה להכיל, ללא קשר למספר השורות שהוחזרו בפועל. אם צוין max-results פרמטר השאילתה, הערך של itemsPerPage הוא הקטן יותר מבין max-results או 10,000. ערך ברירת המחדל של itemsPerPage הוא 1,000.
totalResults integer מספר השורות הכולל בתוצאת השאילתה, ללא קשר למספר השורות שהוחזרו בתגובה. בשאילתות שגורמות למספר שורות גדול, הערך totalResults יכול להיות גדול מ-itemsPerPage. מידע נוסף על totalResults ועל itemsPerPage לשאילתות גדולות זמין בקטע החלפה.
profileInfo object מידע על התצוגה המפורטת (הפרופיל) שעבורה נשלחה בקשה להצגת הנתונים. נתוני תצוגה (פרופיל) זמינים דרך Google Analytics Management API.
profileInfo.profileId string מזהה התצוגה המפורטת (הפרופיל) כמו 1174.
profileInfo.accountId string מספר החשבון שאליו התצוגה המפורטת (פרופיל) הזו שייכת, כמו 30481.
profileInfo.webPropertyId string מזהה נכס אינטרנט שאליו שייכת התצוגה המפורטת (פרופיל) הזו, כגון UA-30481-1.
profileInfo.internalWebPropertyId string מזהה פנימי של נכס האינטרנט שאליו שייכת התצוגה המפורטת (פרופיל) הזו, כגון UA-30481-1.
profileInfo.profileName string שם התצוגה המפורטת (פרופיל).
profileInfo.tableId string מזהה טבלה לתצוגה (פרופיל), המורכב מ-"ga:" ואחריו מזהה התצוגה המפורטת (הפרופיל).
containsSampledData boolean הערך הוא True אם התגובה מכילה נתוני דגימה.
sampleSize string מספר הדגימות המשמשות לחישוב נתוני הדגימה.
sampleSpace string גודל המדגם הכולל. המדד הזה מציין את הגודל הכולל של השטח הזמין שממנו נבחרו הדוגמאות.
columnHeaders[] list כותרות של עמודות עם שמות מאפיינים, ואחרייהם שמות המדדים. סדר המאפיינים והמדדים זהה לאלה שצוינו בבקשה באמצעות הפרמטרים metrics ו-dimensions. מספר הכותרות הוא מספר המאפיינים + מספר המדדים.
columnHeaders[].name string שם המאפיין או המדד.
columnHeaders[].columnType string סוג עמודה. &"DIMENSION" או "METRIC".
columnHeaders[].dataType string סוג הנתונים. בכותרות של עמודת מאפיין יש "STRING" או "MCF_SEQUENCE" כסוג נתונים בלבד. בכותרות של עמודת מדדים יש סוגי נתונים לגבי ערכי מדדים, כגון "INTEGER", "DOUBLE", "CURRENCY" וכו'.
totalsForAllResults object הערכים הכוללים של המדדים המבוקשים כצמדים של ערכי מפתח של שמות וערכים. סדר הערכים הכולל זהה לזה של מדד המדד שצוין בבקשה.
rows[] list

דיווח על שורות נתונים, כאשר כל שורה מכילה רשימה של Mcf.Rowsאובייקטים. ברשימה הפנימית הזו מופיעים ערכי מאפיינים שאחריהם מופיעים ערכי המדדים באותו סדר שצוין בבקשה. כל שורה כוללת רשימה של שדות N, כאשר N = מספר המאפיינים + מספר הערכים.

אובייקט Mcf.Rows עוטף אובייקט אחר שיכול להיות מסוג primitiveValue או conversionPathValue. ניתן להגדיר כל אחד מסוגי המאפיינים מכל סוג, וכל ערכי המדדים הם מהסוג primitiveValue.

primitiveValue הוא מחרוזת פשוטה שמוקפת באובייקט. למשל:

{
  "primitiveValue": "2183"
}

conversionPathValue הוא אובייקט מוקף במערך אובייקטים, שבו כל אובייקט מכיל מחרוזת nodeValue ומחרוזת אופציונלית של interactionType. למשל:

{
  "conversionPathValue": [
    {
      "interactionType" : "CLICK",
      "nodeValue" : "google"
    },
    {
      "interactionType" : "CLICK",
      "nodeValue" : "google"
    }
  ]
}

חזרה למעלה

קודי שגיאה

ממשק ה-API לדיווח על משפכים מרובי-ערוצים מחזיר קוד מצב HTTP של 200 אם הבקשה מוצלחת. אם מתרחשת שגיאה במהלך העיבוד של שאילתה, ה-API מחזיר קוד שגיאה ותיאור. כל אפליקציה שמשתמשת ב-API של Analytics צריכה להטמיע לוגיקת טיפול נכונה בשגיאות. לקבלת פרטים על קודי השגיאה ועל הטיפול בהם, יש לקרוא את מדריך העזר לתשובות לשגיאות.

חזרה למעלה

רוצה לנסות?

כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, אתם צריכים להשתמש ב-APIs Explorer.

חזרה למעלה

דגימה

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

כדי לציין את רמת הדגימה שבה יש להשתמש בבקשה, אפשר להגדיר את הפרמטר דגימה.

אם תגובת MCF Reporting API מכילה נתונים שנדגמו, שדה התגובה containsSampledData יהיה true. בנוסף, שני נכסים יספקו מידע על רמת הדגימה עבור השאילתה: sampleSize וsampleSpace. בעזרת שני הערכים האלה, אפשר לחשב את אחוז הסשנים שבהם נעשה שימוש בשאילתה. לדוגמה, אם sampleSize הוא 201,000 ו-sampleSpace הוא 220,000, הדוח מבוסס על (201,000 / 220,000) * 100 = 91.36% מהביקורים.

בקטע דגימה יש תיאור כללי של הדגימה והשימוש בה ב-Google Analytics.

חזרה למעלה

טיפול בתוצאות נתונים גדולות

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

הקטנת המאפיינים לכל שאילתה

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

פיצול השאילתה לפי טווח תאריכים

במקום לעבור בין התוצאות עם מפתח התאריך של טווח תאריכים ארוך, כדאי ליצור שאילתות נפרדות לשבוע אחד – או אפילו ליום אחד – בכל פעם. כמובן, עבור מערך נתונים גדול, אפילו בקשה של יום אחד עשויה להחזיר יותר מ-max-results. במקרה כזה, אין אפשרות לעבור בין דפים. אבל בכל מקרה, אם מספר השורות התואמות לשאילתה יהיה גבוה מ-max-results, פיצול טווח התאריכים עלול לקצר את משך הזמן הכולל לאחזור התוצאות. הגישה הזו יכולה לשפר את הביצועים גם בשאילתות של שרשור אחד וגם בשאילתות מקבילות.

חלוקה לדפים

מעבר בין התוצאות יכול להיות דרך נוחה לפרוץ קבוצות גדולות של תוצאות בקבוצות שניתנות לניהול. השדה totalResults מציין את מספר השורות התואמות, ו-itemsPerPage מציין את המספר המקסימלי של שורות שניתן להחזיר בתוצאה. אם יש יחס גבוה של totalResults ביחס ל-itemsPerPage, ייתכן שהשאילתות הנפרדות יימשכו זמן רב יותר מהנדרש. אם צריך רק מספר מוגבל של שורות, למשל למטרות תצוגה, כדאי להגדיר מגבלה מפורשת על גודל התגובה באמצעות הפרמטר max-results. עם זאת, אם הבקשה תצטרך לעבד קבוצה גדולה של תוצאות בשלמותה, הבקשה לקבלת השורות המקסימליות המותרות עשויה להיות יעילה יותר.

שימוש ב-gzip

דרך קלה ונוחה לצמצום רוחב הפס הדרוש לכל בקשה היא להפעיל דחיסת Gzip. לשם כך צריך להשקיע זמן נוסף של מעבד (CPU) כדי לבטל את הדחיסה של התוצאות, אבל בדרך כלל הכדאיות של עלויות הרשת משתלמת במיוחד. כדי לקבל תגובה בקידוד gzip, עליך לבצע שתי פעולות: להגדיר כותרת Accept-Encoding, ולשנות את סוכן המשתמש כך שיכיל את המחרוזת gzip. הנה דוגמה לכותרות HTTP שנוצרו כראוי להפעלת דחיסת gzip:

Accept-Encoding: gzip
User-Agent: my program (gzip)