CohortSpec
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
동질 집단 보고서를 위한 동질 집단 사양입니다.
동질 집단 보고서는 동질 집단의 사용자 유지 시계열을 만듭니다. 예를 들어 9월 첫째 주에 획득한 사용자 동질 집단을 선택하고 다음 6주 동안 해당 동질 집단을 팔로우할 수 있습니다. 9월 동질 집단의 첫째 주에 획득한 사용자는 cohort
객체에서 지정됩니다. 다음 6주간의 사용자 집단 다음에 오는 정보는 cohortsRange
객체에 지정됩니다.
예를 보려면 동질 집단 보고서 예를 참고하세요.
보고서 응답에는 앱이 3주 후에 이 사용자 집단의 60% 를 유지하고 6주 후에 이 사용자 집단의 25% 를 유지했다는 주간 시계열이 표시될 수 있습니다. 이 두 비율은 cohortActiveUsers/cohortTotalUsers
측정항목으로 계산할 수 있으며 보고서에서 별도의 행에 표시됩니다.
입력란 |
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 에서는 지원되지 않습니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-05-02(UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]