Tài liệu này mô tả các tính năng nâng cao của API Báo cáo Google Analytics phiên bản 4. Để tham khảo chi tiết về API này, hãy xem Hướng dẫn tham khảo.
Giới thiệu
Sau khi tạo một báo cáo đơn giản, hãy sử dụng các tính năng sau để tạo báo cáo nâng cao:
Tổng hợp
Google Analytics Reporting API phiên bản 4 cho phép bạn tạo Bảng tổng hợp.
Để tạo yêu cầu bằng bảng tổng hợp, hãy xác định trường Pivot (Trục) trong ReportRequest.
Đối tượng Tổng hợp có bộ phương diện và chỉ số riêng cũng như startGroup
và maxGroupCount
không bắt buộc để chỉ định số lượng phương diện cần đưa vào bảng tổng hợp.
Yêu cầu
Lệnh gọi API sau đây yêu cầu phiên theo quốc gia và chuyển hướng kết quả trên trình duyệt:
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"
}
]
}
]
}
]
}
Tiêu đề cột phản hồi
Trong đối tượng báo cáo được trả về cho một yêu cầu tổng hợp, metricHeader
có danh sách các đối tượng pivotHeaders có các trường pivotHeaderEntries
xác định thứ tự của các giá trị thứ nguyên tổng hợp và các giá trị chỉ số tương ứng, ví dụ:
"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
}
]
}
},
Hàng phản hồi
Mỗi hàng của đối tượng reportData xác định một mảng các đối tượng dateRangeValue, mỗi đối tượng chứa một tập hợp các đối tượng pivotValue; thứ tự của các giá trị tương ứng với thứ tự của các chỉ số được liệt kê trong tiêu đề tổng hợp trong tiêu đề cột phản hồi.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
Lưu ý rằng chỉ có ba giá trị tổng hợp trong báo cáo
vì trong yêu cầu ban đầu, maxGroupCount
là 3. Có thể có tối đa 7 giá trị do "totalPivotGroupsCount": 7
.
Ví dụ về hàng trong bảng tổng hợp
Trong phản hồi mẫu ở trên, hàng liên kết với quốc gia Hoa Kỳ sẽ được biểu thị trong bảng tổng hợp sau đây:
Quốc gia | Tổng số phiên |
phiên trên Internet Explorer |
FireFox phiên |
phiên trên trình duyệt Android |
---|---|---|---|---|
Ấn Độ | 12 | 3 | 2 | 4 |
Hoa Kỳ | Năm 192 | 21 | 18 | 1 |
Vương quốc Anh | 35 | 12 | 2 | 0 |
Nhóm thuần tập
Nhóm thuần tập là một nhóm người dùng có chung một đặc điểm. Ví dụ: tất cả người dùng có cùng Ngày thu nạp đều thuộc cùng một nhóm thuần tập. Báo cáo Phân tích theo nhóm thuần tập cho phép bạn tách riêng và phân tích hành vi của nhóm thuần tập. Để biết danh sách các phương diện và chỉ số cụ thể của Nhóm thuần tập, hãy xem phương diện và chỉ số về Nhóm thuần tập và giá trị vòng đời (LTV).
Để xác định yêu cầu nhóm thuần tập, bạn phải xác định một đối tượng nhóm thuần tập bằng name
, type
và 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"
}
}
]
}
}
]
}
Xem ví dụ ở trên trong API Explorer.
Các hạn chế đối với nhóm thuần tập
Yêu cầu nhóm thuần tập hợp lệ phải đáp ứng các quy định hạn chế sau:
- Phương diện
ga:cohort
được đưa vào khi và chỉ khi yêu cầu có một hoặc nhiều định nghĩa nhóm thuần tập. - Tên nhóm thuần tập phải là duy nhất.
- Số lượng nhóm thuần tập tối đa trong một yêu cầu là 12.
- Nếu
ga:cohortNthWeek
được xác định, thì ngày bắt đầu phải là Chủ Nhật và ngày kết thúc phải là thứ Bảy. Nếu bạn xác địnhga:cohortNthMonth
, thì ngày bắt đầu phải là ngày đầu tiên trong tháng và ngày kết thúc phải là ngày cuối cùng của tháng. Nếuga:cohortNthDay
được xác định, phạm vi ngày phải là đúng một ngày. - Không được phép sử dụng yêu cầu nhóm thuần tập có ngày hôm nay.
- Yêu cầu nhóm thuần tập và yêu cầu không theo nhóm thuần tập không được ở trong cùng một yêu cầu
batchGet
. - Phạm vi ngày trong các nhóm phải sau ngày 1 tháng 2 năm 2015.
Giá trị vòng đời (LTV)
Báo cáo Giá trị vòng đời cho biết giá trị người dùng (Doanh thu) và mức độ tương tác (Lượt xem ứng dụng, Số mục tiêu hoàn thành, Số phiên và Thời lượng phiên) tăng như thế nào trong 90 ngày sau khi thu nạp được người dùng. Xem các phương diện và chỉ số cụ thể về LTV.
Yêu cầu LTV được định nghĩa là một nhóm thuần tập với trường lifetimeValue
được đặt thành true
, ví dụ:
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
}
}
]
}
Hãy xem ví dụ trên trong API Explorer (Trình khám phá API).
Phương diện và chỉ số về nhóm thuần tập và giá trị vòng đời (LTV)
Kích thước
Tên phương diện | Định nghĩa |
---|---|
ga:cohort |
Tên của nhóm thuần tập mà người dùng thuộc về. Tuỳ thuộc vào cách xác định nhóm thuần tập, một người dùng có thể thuộc về nhiều nhóm thuần tập, tương tự như cách một người dùng có thể thuộc về nhiều phân khúc. |
ga:cohortNthDay |
Mức chênh lệch ngày dựa trên 0 so với ngày xác định nhóm thuần tập. Ví dụ: nếu một nhóm thuần tập được xác định với ngày truy cập đầu tiên là 2015-09-01 , thì đối với ngày 2015-09-04 , ga:cohortNthDay sẽ là 3. |
ga:cohortNthMonth |
Chênh lệch tháng dựa trên 0 so với ngày xác định nhóm thuần tập. |
ga:cohortNthWeek |
Mức chênh lệch tuần dựa trên 0 so với ngày xác định nhóm thuần tập. |
ga:acquisitionTrafficChannel |
Kênh lưu lượng truy cập mà qua đó người dùng được thu nạp. Mã này được trích xuất từ phiên hoạt động đầu tiên của người dùng. Kênh lưu lượng truy cập được tính toán dựa trên quy tắc nhóm kênh mặc định (ở cấp chế độ xem nếu có) tại thời điểm thu nạp người dùng. |
ga:acquisitionSource |
Nguồn đã thu nạp được người dùng. Bắt nguồn từ phiên hoạt động đầu tiên của người dùng. |
ga:acquisitionMedium |
Phương tiện mà qua đó người dùng được thu nạp. Bắt nguồn từ phiên hoạt động đầu tiên của người dùng. |
ga:acquisitionSourceMedium |
Giá trị kết hợp của ga:userAcquisitionSource và ga:acquisitionMedium . |
ga:acquisitionCampaign |
Chiến dịch mà thông qua đó người dùng được thu nạp. Bắt nguồn từ phiên hoạt động đầu tiên của người dùng. |
Chỉ số
Tên chỉ số | Định nghĩa |
---|---|
ga:cohortActiveUsers |
Chỉ số này có liên quan khi xét đến các phương diện bù trừ dựa trên 0 (ga:cohortNthDay , ga:cohortNthWeek hoặc ga:cohortNthMonth ). Chỉ số này cho biết số người dùng trong nhóm thuần tập đang hoạt động trong khoảng thời gian tương ứng với ngày/tuần/tháng của nhóm thuần tập. Ví dụ: đối với ga:cohortNthWeek = 1 , số người dùng (trong nhóm thuần tập) đang hoạt động trong tuần thứ hai. Nếu yêu cầu không có bất kỳ giá trị nào trong số ga:cohortNthDay , ga:cohortNthWeek hoặc ga:cohortNthMonth , thì chỉ số này sẽ có cùng giá trị với ga:cohortTotalUsers . |
ga:cohortTotalUsers |
Số người dùng thuộc nhóm thuần tập, còn gọi là quy mô nhóm thuần tập. |
ga:cohortAppviewsPerUser |
Số lượt xem ứng dụng trên mỗi người dùng cho một nhóm thuần tập. |
ga:cohortGoalCompletionsPerUser |
Số mục tiêu hoàn thành trên mỗi người dùng cho nhóm thuần tập. |
ga:cohortPageviewsPerUser |
Số lượt xem trang trên mỗi người dùng cho nhóm thuần tập. |
ga:cohortRetentionRate |
Tỷ lệ giữ chân nhóm thuần tập. |
ga:cohortRevenuePerUser |
Doanh thu trên mỗi người dùng cho một nhóm thuần tập. |
ga:cohortVisitDurationPerUser |
Thời lượng phiên trên mỗi người dùng trong một nhóm thuần tập. |
ga:cohortSessionsPerUser |
Số phiên hoạt động trên mỗi người dùng trong một nhóm thuần tập. |
Chỉ số giá trị vòng đời (LTV)
Tên chỉ số | Định nghĩa |
---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
Điều này có liên quan trong trường hợp yêu cầu có phương diện ga:acquisitionTrafficChannel , ga:acquisitionSource , ga:acquisitionMedium hoặc ga:acquisitionCampaign . Chỉ số này thể hiện số lượng người dùng trong các nhóm thuần tập mà bạn thu nạp được thông qua kênh, nguồn, phương tiện hoặc chiến dịch hiện tại. Ví dụ: đối với ga:acquisitionTrafficChannel=Direct , giá trị này đại diện cho số người dùng trong nhóm thuần tập đã được thu nạp trực tiếp. Nếu không có phương diện nào được đề cập, thì giá trị của phương diện đó sẽ bằng ga:cohortTotalUsers (chỉ dành cho chế độ xem ứng dụng). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Số lượt xem ứng dụng trên mỗi người dùng cho phương diện thu nạp người dùng cho một nhóm thuần tập (chỉ lượt xem ứng dụng). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
Số mục tiêu hoàn thành trên mỗi người dùng đối với phương diện thu nạp người dùng cho một nhóm thuần tập (chỉ lượt xem ứng dụng). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Số lượt xem trang trên mỗi người dùng cho phương diện thu nạp người dùng cho một nhóm thuần tập (chỉ lượt xem ứng dụng). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
Doanh thu trên mỗi người dùng cho phương diện thu nạp người dùng cho một nhóm thuần tập (chỉ lượt xem ứng dụng). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
Thời lượng phiên trên mỗi người dùng cho phương diện thu nạp người dùng cho một nhóm thuần tập (chỉ lượt xem ứng dụng). |