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이 1일이고 요청에 cohortNthDay가 포함된 경우 일반적으로 사용됩니다.
WEEKLY 주별 세부사항. 동질 집단의 dateRange가 1주일 기간 (일요일부터 토요일에 종료)이고 요청에 cohortNthWeek이 포함된 경우 일반적으로 사용됩니다.
MONTHLY 월별 세분화. 동질 집단의 dateRange가 한 달 동안 지속되고 요청에 cohortNthMonth가 포함된 경우 일반적으로 사용됩니다.

CohortReportSettings

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

JSON 표현 
{
  "accumulate": boolean
}
입력란
accumulate

boolean

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