מסמך זה מתאר את התכונות המתקדמות של Google Analytics Reporting API v4. מידע מפורט על ה-API זמין במדריך העזר.
מבוא
אחרי שיוצרים דוח פשוט, כדאי להשתמש בתכונות הבאות כדי ליצור דוחות מתקדמים:
צירים
ב-Google Analytics Reporting API v4 אפשר ליצור טבלאות צירים.
כדי ליצור בקשה באמצעות טבלת צירים, מגדירים את השדה Pivot ב-ReportRequest.
לאובייקט Pivot יש קבוצה משלו של מאפיינים ומדדים. אפשר גם startGroup
ו-maxGroupCount
לציין את מספר המאפיינים שייכללו בטבלת הצירים.
בקשה
ההפעלות הבאות של בקשות לקריאה ל-API מוצגות לפי מדינה, ומחזירות את התוצאות בדפדפן:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
כותרת העמודה של התשובה
באובייקט report שמוחזר לבקשת ציר, ב-metricHeader
יש רשימה של אובייקטים pivotHeaders
בשדות pivotHeaderEntries
שלהם מגדירים את הסדר של ערכי המאפיינים
ואת ערכי המדדים התואמים, לדוגמה:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
שורות תגובה
כל שורה באובייקט reportData מגדירה מערך של אובייקטים מסוג dateRangeValue, שכל אחד מהם מכיל קבוצה של אובייקטים מסוג pivotValue. סדר הערכים תואם לסדר המדדים המפורטים בכותרות הצירים בכותרת עמודת התגובה.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
שימו לב שבדוח יש רק שלושה ערכי צירים, כי בבקשה המקורית הערך maxGroupCount
הוא 3. יכולים
להיות עד שבעה ערכים בגלל "totalPivotGroupsCount": 7
.
דוגמה לשורה בטבלת צירים
בתגובה לדוגמה שלמעלה, השורה המשויכת למדינה ארצות הברית מיוצגת בטבלת הצירים הבאה:
מדינה | סה"כ פעילויות באתר |
הפעלות של Internet Explorer |
פעילויות ב-FireFox |
סשנים של בדפדפן Android |
---|---|---|---|---|
הודו | 12 | 3 | 2 | 4 |
ארה"ב | 192 | 22 | 18 | 1 |
בריטניה | 35 | 12 | 2 | 0 |
קבוצות בעלות מאפיינים משותפים (cohorts)
קבוצה בעלת מאפיינים משותפים היא קבוצה של משתמשים שחולקים מאפיין משותף. לדוגמה, כל המשתמשים שתאריך הצירוף שלהם זהה שייכים לאותה קבוצה בעלת מאפיינים משותפים. הדוח 'ניתוח קבוצות משתמשים' מאפשר לך לבודד ולנתח את ההתנהגות של קבוצות בעלות עניין משותף. לרשימת מאפיינים ומדדים ספציפיים לקבוצה בעלת מאפיינים משותפים, אפשר לעיין במאמר מאפיינים ומדדים של קבוצה בעלת מאפיינים משותפים וערך חיי המשתמש.
כדי להגדיר בקשה לקבוצה בעלת מאפיינים משותפים, עליך להגדיר אובייקט של קבוצה בעלת מאפיינים משותפים עם name
, type
ו-dateRange
:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
אפשר לראות את הדוגמה שלמעלה ב-API Explorer.
הגבלות על קבוצה בעלת מאפיינים משותפים
בקשה תקפה לקבוצה בעלת מאפיינים משותפים חייבת לעמוד בהגבלות הבאות:
- המאפיין
ga:cohort
נכלל אם ורק אם הבקשה מכילה הגדרה אחת או יותר של קבוצה בעלת מאפיינים משותפים. - השם של הקבוצה בעלת המאפיינים המשותפים חייב להיות ייחודי.
- הבקשה יכולה לכלול עד 12 קבוצות בעלות מאפיינים משותפים.
- אם מגדירים את הערך
ga:cohortNthWeek
, תאריך ההתחלה צריך להיות יום ראשון ותאריך הסיום חייב להיות יום שבת. אם מגדירים את הערךga:cohortNthMonth
, תאריך ההתחלה צריך להיות היום הראשון בחודש ותאריך הסיום חייב להיות היום האחרון בחודש. אם מגדירים את הערךga:cohortNthDay
, טווח התאריכים חייב להיות יום אחד בדיוק. - אסור לשלוח בקשות לקבוצה בעלת מאפיינים משותפים עם התאריך של היום.
- בקשות לקבוצה בעלת מאפיינים משותפים ובקשות שלא בעלות מאפיינים משותפים לא יכולות להיכלל באותה בקשת
batchGet
. - טווח התאריכים בקבוצות בעלות עניין משותף חייב להיות אחרי 1 בפברואר 2015.
ערך חיי המשתמש (LTV)
הדוח 'ערך חיי המשתמש' מראה את הגידול בערך המשתמש (הכנסה) ובמעורבות (צפיות באפליקציה, יעדים שהושלמו, פעילויות באתר ומשך פעילות באתר) במהלך 90 הימים שאחרי צירוף משתמש. בקישור הבא אפשר לעיין במאפיינים ובמדדים ספציפיים של ערך חיי המשתמש.
בקשת ערך חיי המשתמש מוגדרת כקבוצה בעלת מאפיינים משותפים והשדה lifetimeValue
מוגדר ל-true
. לדוגמה:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
אפשר לראות את הדוגמה שלמעלה ב-API Explorer.
מאפיינים ומדדים של קבוצה בעלת מאפיינים משותפים וערך חיי המשתמש (LTV)
מאפיינים
שם המאפיין | הגדרה |
---|---|
ga:cohort |
השם של הקבוצה בעלת המאפיינים המשותפים שאליה משתייך משתמש. בהתאם להגדרה של קבוצות בעלות מאפיינים משותפים, משתמש יכול להשתייך לכמה קבוצות בעלות מאפיינים משותפים, בדומה לאופן שבו משתמש יכול להשתייך למספר פלחים. |
ga:cohortNthDay |
קיזוז ימים מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, אם קבוצה בעלת מאפיינים משותפים (cohort) מוגדרת עם תאריך הביקור הראשון כ-2015-09-01 , הערך של ga:cohortNthDay יהיה 3 עבור תאריך 2015-09-04 . |
ga:cohortNthMonth |
קיזוז חודשים מבוסס-0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים. |
ga:cohortNthWeek |
קיזוז שבועות מבוסס 0 ביחס לתאריך ההגדרה של הקבוצה בעלת המאפיינים המשותפים. |
ga:acquisitionTrafficChannel |
ערוץ התנועה שדרכו המשתמש צורף. הוא מחולץ מהסשן הראשון של המשתמש. ערוץ התנועה מחושב על סמך כללי ברירת המחדל לקיבוץ ערוצים (ברמת התצוגה המפורטת, אם הם זמינים) במועד צירוף המשתמשים. |
ga:acquisitionSource |
המקור שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש. |
ga:acquisitionMedium |
אמצעי ההגעה לאתר שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש. |
ga:acquisitionSourceMedium |
הערך המשולב של ga:userAcquisitionSource ו-ga:acquisitionMedium . |
ga:acquisitionCampaign |
הקמפיין שדרכו המשתמש צורף. נגזר מהסשן הראשון של המשתמש. |
מדדים
שם המדד | הגדרה |
---|---|
ga:cohortActiveUsers |
המדד הזה רלוונטי בהקשר של מאפייני ההיסט שמבוססים על 0 (ga:cohortNthDay , ga:cohortNthWeek או ga:cohortNthMonth ). הוא מציין את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שפעילים בחלון הזמן התואם ליום/שבוע/חודש של הקבוצה בעלת המאפיינים המשותפים. לדוגמה, עבור ga:cohortNthWeek = 1 , מספר המשתמשים (בקבוצה בעלת מאפיינים משותפים) שהיו פעילים בשבוע השני. אם הבקשה לא כוללת את הערכים ga:cohortNthDay , ga:cohortNthWeek או ga:cohortNthMonth , למדד הזה יהיה אותו ערך כמו ga:cohortTotalUsers . |
ga:cohortTotalUsers |
מספר המשתמשים ששייכים לקבוצה בעלת מאפיינים משותפים, שנקראים גם 'גודל קבוצה בעלת מאפיינים משותפים'. |
ga:cohortAppviewsPerUser |
צפיות באפליקציה לכל משתמש בקבוצה בעלת מאפיינים משותפים. |
ga:cohortGoalCompletionsPerUser |
מטרות עסקיות שהושלמו לכל משתמש בקבוצה בעלת מאפיינים משותפים. |
ga:cohortPageviewsPerUser |
צפיות בדף לכל משתמש בקבוצה בעלת מאפיינים משותפים. |
ga:cohortRetentionRate |
שיעור השימור של קבוצה בעלת מאפיינים משותפים. |
ga:cohortRevenuePerUser |
הכנסה למשתמש בקבוצה בעלת מאפיינים משותפים. |
ga:cohortVisitDurationPerUser |
משך הסשן לכל משתמש בקבוצה בעלת מאפיינים משותפים. |
ga:cohortSessionsPerUser |
ביקורים לכל משתמש בקבוצה בעלת מאפיינים משותפים. |
מדדים של ערך חיי המשתמש (LTV)
שם המדד | הגדרה |
---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
הדבר רלוונטי בהקשר של בקשה עם המאפיינים ga:acquisitionTrafficChannel , ga:acquisitionSource , ga:acquisitionMedium או ga:acquisitionCampaign . המדד הזה מייצג את מספר המשתמשים בקבוצות בעלות מאפיינים משותפים שצורפו דרך הערוץ, המקור, אמצעי ההגעה לאתר או הקמפיין הנוכחיים. לדוגמה, עבור ga:acquisitionTrafficChannel=Direct , הוא מייצג את מספר המשתמשים בקבוצה בעלת המאפיינים המשותפים שצורפו ישירות. אם אף אחד מהמאפיינים שצוינו לא קיים, הערך שלו שווה ל-ga:cohortTotalUsers (רק צפיות באפליקציה). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
צפיות באפליקציה לכל משתמש במאפיין צירוף המשתמשים של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
מטרות עסקיות שהושלמו לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
צפיות בדף לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
הכנסה לכל משתמש במאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
משך הסשן לכל משתמש ביחס למאפיין 'צירוף משתמשים' של קבוצה בעלת מאפיינים משותפים (צפיות באפליקציה בלבד). |