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 ra 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 thuần tập gồm 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. 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 Ví dụ về báo cáo nhóm thuần tập.

Phản hồi trong báo cáo có thể hiển thị một chuỗi thời gian hằng tuần, trong đó giả sử ứng dụng của bạn đã giữ lại 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ì hệ thống có thể nhận dạng từng nhóm 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 một khoảng thời gian 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 một đặ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 đánh giá bằng tên này trong phản hồi báo cáo. Nếu được đặt thì 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 xuất hiện 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 độ chi tiết và mức bù trừ có trong cohortsRange; dữ liệu sự kiện cho phạm vi ngày báo cáo mở rộng 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à dateRanges trong RunReportRequest hoặc RunPivotReportRequest phải không được chỉ định.

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 độ 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 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 độ chi tiết hằng tháng, thì dateRange này có thể được căn chỉnh thành 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

Thiết lập 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 một 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 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ừ hoạt động 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à số nguyên dương bất kỳ, nhưng thường được đặt thành từ 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

Độ 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 được chỉ định.
DAILY Độ chi tiết hằng ngày. Thường được sử 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 kéo dài 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 Thông tin chi tiết hằng tháng. Thường được sử dụng nếu dateRange của nhóm thuần tập 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 chạm đầu tiên đến ngày kết thúc. Không được hỗ trợ trong RunReportRequest.