CohortSpec

Thông số kỹ thuật của nhóm thuần tập cho báo cáo nhóm thuần tập.

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

Phản hồi 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 toán bằng 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ạn có thể nhận ra từng nhóm thuần tập trong báo cáo theo tên của nhóm thuần tập đó.
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 chỉ định khoảng thời gian chênh lệch để theo dõi các nhóm thuần tập.
cohortReportSettings

object (CohortReportSettings)

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 tập hợp những người dùng có một đặc điểm chung. Ví dụ: những người dùng có cùng firstSessionDate sẽ 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 gán giá trị cho tên này trong phản hồi báo cáo. Nếu được đặt, không được bắt đầu bằng cohort_ hoặc RESERVED_. Nếu không được đặt, các nhóm thuần tập sẽ được đặt tên theo chỉ mục dựa trên số 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 này sẽ chọn những người dùng có ngày tiếp xúc đầu tiên nằm trong khoảng ngày bắt đầu và 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 báo cáo nhóm thuần tập, dateRange này được mở rộng theo mức độ chi tiết và độ 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 về nhóm thuần tập, bạn phải có dateRange này và không được chỉ định dateRanges trong RunReportRequest hoặc RunPivotReportRequest.

dateRange này thường phải phù hợp với mức độ chi tiết của nhóm thuần tập. Nếu CohortsRange sử dụng mức độ chi tiết hằng ngày, thì dateRange này có thể là một ngày. Nếu CohortsRange sử dụng mức độ chi tiết hằng tuần, thì dateRange này có thể được căn chỉnh theo ranh giới 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 mức độ chi tiết hằng tháng, thì dateRange này có thể được điều chỉnh cho phù hợp với 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ù để 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. Mức độ chi tiết dùng để diễn giải startOffset và endOffset cho phạm vi ngày báo cáo mở rộng của 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 báo cáo nhóm thuần tập. startOffset thường được đặt thành 0 để báo cáo chứa dữ liệu từ thời điểm 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 sẽ 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 sẽ 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 sẽ 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 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 thành 5 đến 10 để báo cáo chứa dữ liệu về nhóm thuần tập trong vài 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 sẽ 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 sẽ 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 sẽ là endDate của nhóm thuần tập cộng với endOffset * 30 ngày.

Độ chi tiết

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

Enum
GRANULARITY_UNSPECIFIED Không bao giờ đượ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 là một tuần (bắt đầu vào Chủ Nhật và kết thúc vào thứ Bảy) và yêu cầu chứa cohortNthWeek.
MONTHLY Mức độ 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, hãy tích luỹ kết quả từ ngày tiếp xúc đầu tiên đến ngày kết thúc. Không được hỗ trợ trong RunReportRequest.