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는 월 1일부터 월 마지막 날까지의 기간에 맞춰 정렬할 수 있습니다.

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가 일주일 (일요일에 시작하여 토요일에 종료)이고 요청에 cohortNthWeek가 포함된 경우 일반적으로 사용됩니다.
MONTHLY 월별 세부사항 사용자 집단의 dateRange가 1개월이고 요청에 cohortNthMonth가 포함된 경우 일반적으로 사용됩니다.

CohortReportSettings

사용자 집단 보고서의 선택적 설정입니다.

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

boolean

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