מסמך זה מספק את ההפניה המלאה לשאילתה ולתגובה לממשק ה-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 | רמת הדגימה הרצויה. ערכים מורשים:
|
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.
פורמט תגובה
{
"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 לשאילתות גדולות זמין בקטע החלפה.
|
selfLink |
string |
קישור לדף התוצאות הזה עבור שאילתת הנתונים הזו. |
previousLink |
string |
קישור לדף התוצאות הקודם של שאילתת הנתונים הזו. |
nextLink |
string |
קישור לדף התוצאות הבא עבור שאילתת הנתונים הזו. |
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 |
דיווח על שורות נתונים, כאשר כל שורה מכילה רשימה של
אובייקט
{ "primitiveValue": "2183" }
{ "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)