CohortSpec

Thông số kỹ thuật về nhóm thuần tập trong báo cáo nhóm thuần tập.

Báo cáo nhóm thuần tập tạo ra một chuỗi thời gian giữ chân người dùng cho nhóm thuần tập. Ví dụ: bạn có thể chọn nhóm thuần tập những người dùng được thu nạp vào tuần đầu tiên của tháng 9 và theo dõi nhóm thuần tập đó trong 6 tuần tiếp theo. Việc chọn những người dùng thu nạp được trong tuần đầu tiên của nhóm thuần tập tháng 9 được chỉ định trong đối tượng cohort. Theo dõi nhóm thuần tập đó trong 6 tuần tiếp theo được chỉ định trong đối tượng cohortsRange.

Để biết ví dụ, hãy xem bài viết Ví dụ về báo cáo nhóm thuần tập.

Phản hồi trong báo cáo có thể cho thấy một chuỗi thời gian hằng tuần, trong đó ứng dụng của bạn đã giữ chân 60% nhóm thuần tập này sau 3 tuần và 25% nhóm thuần tập này sau 6 tuần. Hai tỷ lệ phần trăm này có thể được tính theo chỉ số cohortActiveUsers/cohortTotalUsers và sẽ là các hàng riêng biệt trong báo cáo.

Biểu diễn dưới dạng JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Trường
cohorts[]

object (Cohort)

Xác định tiêu chí lựa chọn để nhóm người dùng thành các nhóm thuần tập.

Hầu hết các báo cáo nhóm thuần tập chỉ xác định một nhóm thuần tập. Nếu bạn chỉ định nhiều nhóm thuần tập, thì báo cáo có thể nhận dạng từng nhóm thuần tập theo tên.
cohortsRange

object (CohortsRange)

Báo cáo nhóm thuần tập theo dõi các nhóm thuần tập trong một phạm vi ngày báo cáo mở rộng. Phạm vi này xác định thời lượng bù trừ để theo dõi các nhóm thuần tập.
cohortReportSettings

object (CohortReportSettings)

Các chế độ cài đặt không bắt buộc cho báo cáo nhóm thuần tập.

Nhóm thuần tập

Xác định tiêu chí lựa chọn nhóm thuần tập. Nhóm thuần tập là một nhóm người dùng có chung đặc điểm. Ví dụ: những người dùng có cùng firstSessionDate thuộc cùng một nhóm thuần tập.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Trường
name

string

Chỉ định tên cho nhóm thuần tập này. Phương diện cohort có giá trị đối với tên này trong một phản hồi báo cáo. Nếu đặt giá trị, không được bắt đầu bằng cohort_ hoặc RESERVED_. Nếu bạn không đặt chính sách này, các nhóm thuần tập sẽ được đặt tên theo chỉ mục dựa trên 0 cohort_0, cohort_1, v.v.
dimension

string

Phương diện mà nhóm thuần tập sử dụng. Bắt buộc và chỉ hỗ trợ firstSessionDate.
dateRange

object (DateRange)

Nhóm thuần tập chọn những người dùng có ngày tiếp xúc đầu tiên nằm trong khoảng từ ngày bắt đầu đến ngày kết thúc được xác định trong dateRange. dateRange này không chỉ định phạm vi ngày đầy đủ của dữ liệu sự kiện có trong báo cáo nhóm thuần tập. Trong một báo cáo nhóm thuần tập, dateRange này được mở rộng theo mức độ chi tiết và mức chênh lệch có trong cohortsRange; dữ liệu sự kiện cho phạm vi ngày báo cáo mở rộng sẽ xuất hiện trong báo cáo nhóm thuần tập.

Trong yêu cầu nhóm thuần tập, dateRange này là bắt buộc và không được chỉ định dateRanges trong RunReportRequest hoặc RunPivotReportRequest.

dateRange này thường phải phù hợp với độ chi tiết của nhóm thuần tập. Nếu CohortsRange sử dụng độ chi tiết hằng ngày, thì dateRange này có thể là một ngày. Nếu CohortsRange sử dụng độ chi tiết hằng tuần, thì dateRange này có thể được điều chỉnh theo giới hạn một tuần, bắt đầu từ Chủ Nhật và kết thúc vào thứ Bảy. Nếu CohortsRange sử dụng độ chi tiết hằng tháng, thì dateRange này có thể điều chỉnh theo một tháng, bắt đầu từ ngày đầu tiên và kết thúc vào ngày cuối cùng của tháng.

CohortsRange

Định cấu hình phạm vi ngày báo cáo mở rộng cho báo cáo nhóm thuần tập. Chỉ định khoảng thời gian bù trừ để theo dõi các nhóm thuần tập.

Biểu diễn dưới dạng JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Trường
granularity

enum (Granularity)

Bắt buộc. Độ chi tiết được dùng để diễn giải startOffset và endOffset cho phạm vi ngày báo cáo mở rộng cho một báo cáo nhóm thuần tập.
startOffset

integer

startOffset chỉ định ngày bắt đầu của phạm vi ngày báo cáo mở rộng cho một báo cáo nhóm thuần tập. startOffset thường được đặt thành 0 để các báo cáo chứa dữ liệu từ việc thu nạp nhóm thuần tập trở đi.

Nếu granularity là DAILY, thì startDate của phạm vi ngày báo cáo mở rộng là startDate của nhóm thuần tập cộng với startOffset ngày.

Nếu granularity là WEEKLY, thì startDate của phạm vi ngày báo cáo mở rộng là startDate của nhóm thuần tập cộng với startOffset * 7 ngày.

Nếu granularity là MONTHLY, thì startDate của phạm vi ngày báo cáo mở rộng là startDate của nhóm thuần tập cộng với startOffset * 30 ngày.
endOffset

integer

Bắt buộc. endOffset chỉ định ngày kết thúc của phạm vi ngày báo cáo mở rộng cho một báo cáo nhóm thuần tập. endOffset có thể là bất kỳ số nguyên dương nào, nhưng thường được đặt từ 5 đến 10 để báo cáo chứa dữ liệu về nhóm thuần tập trong một số khoảng thời gian chi tiết tiếp theo.

Nếu granularity là DAILY, thì endDate của phạm vi ngày báo cáo mở rộng là endDate của nhóm thuần tập cộng với endOffset ngày.

Nếu granularity là WEEKLY, thì endDate của phạm vi ngày báo cáo mở rộng là endDate của nhóm thuần tập cộng với endOffset * 7 ngày.

Nếu granularity là MONTHLY, thì endDate của phạm vi ngày báo cáo mở rộng là endDate của nhóm thuần tập cộng với endOffset * 30 ngày.

Độ chi tiết

Độ chi tiết được dùng để diễn giải startOffset và endOffset cho phạm vi ngày báo cáo mở rộng cho một báo cáo nhóm thuần tập.

Enum
GRANULARITY_UNSPECIFIED Không được chỉ định.
DAILY Độ chi tiết hằng ngày. Thường được dùng nếu dateRange của nhóm thuần tập là một ngày và yêu cầu chứa cohortNthDay.
WEEKLY Độ chi tiết hằng tuần. Thường được dùng nếu dateRange của nhóm thuần tập có thời lượng một tuần (bắt đầu từ Chủ Nhật và kết thúc vào thứ Bảy) và yêu cầu chứa cohortNthWeek.
MONTHLY Độ chi tiết hằng tháng. Thường được dùng nếu dateRange của nhóm thuần tập có thời lượng là một tháng và yêu cầu chứa cohortNthMonth.

CohortReportSettings

Các chế độ cài đặt không bắt buộc của báo cáo nhóm thuần tập.

Biểu diễn dưới dạng JSON 
{
  "accumulate": boolean
}
Trường
accumulate

boolean

Nếu đúng, thì kết quả sẽ tích luỹ từ ngày tiếp xúc đầu tiên cho đến ngày kết thúc. Chưa hỗ trợ ở RunReportRequest.