本文說明 Google Analytics Reporting API v4 的進階功能。如需 API 的詳細參考資料,請參閱參考指南。
簡介
建立簡易報表後,請使用下列功能建立進階報表:
資料透視
Google Analytics Reporting API v4 可讓您產生資料透視表。如要透過資料透視表建構要求,請在 ReportRequest 中定義「Pivot」欄位。「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 個 | 21 | 18 | 1 |
英國 | 35 | 12 | 2 | 0 |
同類群組
同類群組是指具有共同特徵的一群使用者。舉例來說,「轉換日期」是同一天的所有使用者,會歸入相同的同類群組。您可以用「同類群組分析」報表劃分出同類群組行為,並加以分析。 如需同類群組專屬維度和指標清單,請參閱「同類群組和生命週期價值 (LTV) 維度和指標」一文。
如要定義同類群組要求,您必須使用 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
要求中。 - 同類群組中的日期範圍必須晚於 2015 年 2 月 1 日。
生命週期價值 (LTV)
生命週期價值報表會顯示使用者價值 (收益) 和參與度 (應用程式瀏覽量、目標達成數、工作階段數和工作階段持續時間) 在招攬到使用者後的 90 天內的成長情況。請參閱 LTV 專屬維度和指標。
LTV 要求是定義為 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 天偏移量。舉例來說,如果同類群組的首次造訪日期為 2015-09-01 ,則 2015-09-04 當天的 ga:cohortNthDay 會是 3。 |
ga:cohortNthMonth |
相對於同類群組定義日期,為期 0 個月的偏移量。 |
ga:cohortNthWeek |
相對於同類群組定義日期,為期 0 週的差距。 |
ga:acquisitionTrafficChannel |
招攬到使用者的流量管道。這個 ID 擷取自使用者的第一個工作階段擷取,流量管道的計算依據為獲取新客時的預設管道分組規則 (如適用,如適用)。 |
ga:acquisitionSource |
招攬到使用者的來源,從使用者的第一個工作階段衍生。 |
ga:acquisitionMedium |
招攬到使用者的媒介。從使用者的第一個工作階段衍生。 |
ga:acquisitionSourceMedium |
ga:userAcquisitionSource 和 ga:acquisitionMedium 的總值。 |
ga:acquisitionCampaign |
招攬到使用者的廣告活動。從使用者的第一個工作階段衍生。 |
指標
指標名稱 | 定義 |
---|---|
ga:cohortActiveUsers |
這項指標與 0 個以偏移量為基礎的偏移維度 (ga:cohortNthDay 、ga:cohortNthWeek 或 ga:cohortNthMonth ) 相關,而是該同類群組中落在與第 n 天/週/月相關的同類群組中活躍的使用者人數。舉例來說,如果是 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 |
同類群組的獲客維度每位使用者的工作階段持續時間 (僅限應用程式資料檢視)。 |