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에서는 지원되지 않습니다.