CohortSpec

동질 집단 보고서의 동질 집단 사양입니다.

동질 집단 보고서는 동질 집단의 사용자 유지율에 대한 시계열을 만듭니다. 예를 들어 9월 첫째 주에 획득한 사용자 집단을 선택하고 이후 6주 동안 해당 동질 집단을 팔로우할 수 있습니다. 9월 동질 집단의 첫째 주에 획득한 사용자를 선택하는 방법은 cohort 객체에서 지정합니다. 이 사용자 집단 다음에 이후 6주 동안은 cohortsRange 객체에 지정됩니다.

예를 보려면 동질 집단 보고서 예를 참고하세요.

보고서 응답에는 앱이 3주 후에 동질 집단의 60% 를 유지하고 6주 후에 이 동질 집단의 25% 를 유지한다고 말하는 주별 시계열이 표시될 수 있습니다. 이 두 비율은 cohortActiveUsers/cohortTotalUsers 측정항목으로 계산될 수 있으며 보고서에서 별도의 행으로 표시됩니다.

JSON 표현 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
필드
cohorts[]

object (Cohort)

사용자를 동질 집단으로 그룹화하기 위한 선택 기준을 정의합니다.

대부분의 동질 집단 보고서에서는 하나의 동질 집단만 정의합니다. 여러 동질 집단이 지정된 경우 각 동질 집단은 보고서에서 이름으로 인식될 수 있습니다.
cohortsRange

object (CohortsRange)

동질 집단 보고서는 확장된 보고 기간에 걸쳐 동질 집단을 추적합니다. 이 범위는 동질 집단을 따라가는 오프셋 기간을 지정합니다.
cohortReportSettings

object (CohortReportSettings)

동질 집단 보고서의 설정(선택사항)입니다.

코호트

동질 집단 선택 기준을 정의합니다. 동질 집단은 공통된 특징을 가진 사용자 그룹입니다. 예를 들어 firstSessionDate가 동일한 사용자는 동일한 동질 집단에 속합니다.

JSON 표현 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
필드
name

string

이 동질 집단에 이름을 할당합니다. 보고서 응답에서 측정기준 cohort의 값은 이 이름으로 지정됩니다. 설정된 경우 cohort_ 또는 RESERVED_로 시작할 수 없습니다. 설정하지 않으면 동질 집단의 이름이 0부터 시작하는 색인 cohort_0, cohort_1 등으로 지정됩니다.
dimension

string

동질 집단에서 사용하는 측정기준입니다. 필수이며 firstSessionDate만 지원합니다.
dateRange

object (DateRange)

동질 집단에서 첫 번째 터치 날짜가 dateRange에 정의된 시작일과 종료일 사이에 있는 사용자를 선택합니다. 이 dateRange은 동질 집단 보고서에 표시되는 이벤트 데이터의 전체 기간을 지정하지 않습니다. 동질 집단 보고서에서 이 dateRange는 cohortsRange에 있는 세부사항과 오프셋에 의해 확장됩니다. 확장된 보고 기간에 대한 이벤트 데이터가 동질 집단 보고서에 표시됩니다.

동질 집단 요청에서 이 dateRange는 필수이며 RunReportRequest 또는 RunPivotReportRequest의 dateRanges는 지정하지 않아야 합니다.

이 dateRange는 일반적으로 동질 집단의 세부사항과 일치해야 합니다. CohortsRange에서 일별 세부사항을 사용하는 경우 이 dateRange는 하루가 될 수 있습니다. CohortsRange에서 주별 세부사항을 사용하는 경우 이 dateRange는 일요일부터 토요일까지 주 경계로 정렬될 수 있습니다. CohortsRange에서 월별 단위를 사용하는 경우 이 dateRange는 해당 월의 첫 번째 날부터 마지막 날까지 월 단위로 정렬할 수 있습니다.

CohortsRange

동질 집단 보고서의 확장된 보고 기간을 구성합니다. 동질 집단을 따르는 오프셋 기간을 지정합니다.

JSON 표현 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
필드
granularity

enum (Granularity)

필수 항목입니다. 동질 집단 보고서의 확장된 보고 기간에 대한 startOffset 및 endOffset을 해석하는 데 사용되는 세부정보입니다.
startOffset

integer

startOffset은 동질 집단 보고서의 확장된 보고 기간의 시작일을 지정합니다. startOffset는 일반적으로 0으로 설정되므로 보고서에 동질 집단 획득 이후의 데이터가 포함됩니다.

granularity이(가) DAILY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset일을 더한 값입니다.

granularity이(가) WEEKLY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset * 7일을 더한 값입니다.

granularity이(가) MONTHLY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset * 30일을 더한 값입니다.
endOffset

integer

필수 항목입니다. endOffset은 동질 집단 보고서의 연장된 보고 기간의 종료일을 지정합니다. endOffset는 양의 정수일 수 있지만 일반적으로는 5~10으로 설정되므로 보고서에 다음 세밀한 기간에 대한 동질 집단 데이터가 포함됩니다.

granularity이(가) DAILY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset일을 더한 값입니다.

granularity이(가) WEEKLY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset * 7일을 더한 값입니다.

granularity이(가) MONTHLY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset * 30일을 더한 값입니다.

세부사항

동질 집단 보고서의 확장된 보고 기간에 대해 startOffset 및 endOffset를 해석하는 데 사용되는 세부정보입니다.

열거형
GRANULARITY_UNSPECIFIED 지정해서는 안 됩니다.
DAILY 일별 세분화. 동질 집단의 dateRange가 하루이고 요청에 cohortNthDay이 포함된 경우 일반적으로 사용됩니다.
WEEKLY 주별 세부정보 동질 집단의 dateRange가 1주일 (일요일부터 토요일까지)이고 요청에 cohortNthWeek이 포함된 경우 일반적으로 사용됩니다.
MONTHLY 월별 세부사항: 동질 집단의 dateRange가 1개월이고 요청에 cohortNthMonth이 포함된 경우 일반적으로 사용됩니다.

CohortReportSettings

동질 집단 보고서의 설정(선택사항)입니다.

JSON 표현 
{
  "accumulate": boolean
}
필드
accumulate

boolean

true인 경우 첫 번째 터치일부터 종료일까지 결과를 누적합니다. RunReportRequest에서는 지원되지 않습니다.