Reference documentation and code samples for the Google Analytics Data V1alpha Client class CohortSpec.
The specification of cohorts for a cohort report.
Cohort reports create a time series of user retention for the cohort. For
example, you could select the cohort of users that were acquired in the first
week of September and follow that cohort for the next six weeks. Selecting
the users acquired in the first week of September cohort is specified in thecohortobject. Following that cohort for the next six weeks is specified in
thecohortsRangeobject.
For examples, seeCohort Report
Examples.
The report response could show a weekly time series where say your app has
retained 60% of this cohort after three weeks and 25% of this cohort after
six weeks. These two percentages can be calculated by the metriccohortActiveUsers/cohortTotalUsersand will be separate rows in the report.
Generated from protobuf messagegoogle.analytics.data.v1alpha.CohortSpec
Defines the selection criteria to group users into cohorts. Most cohort reports define only a single cohort. If multiple cohorts are specified, each cohort can be recognized in the report by their name.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Analytics Data V1alpha Client - Class CohortSpec (0.22.3)\n\nVersion latestkeyboard_arrow_down\n\n- [0.22.3 (latest)](/php/docs/reference/analytics-data/latest/V1alpha.CohortSpec)\n- [0.22.2](/php/docs/reference/analytics-data/0.22.2/V1alpha.CohortSpec)\n- [0.21.1](/php/docs/reference/analytics-data/0.21.1/V1alpha.CohortSpec)\n- [0.20.1](/php/docs/reference/analytics-data/0.20.1/V1alpha.CohortSpec)\n- [0.19.0](/php/docs/reference/analytics-data/0.19.0/V1alpha.CohortSpec)\n- [0.18.0](/php/docs/reference/analytics-data/0.18.0/V1alpha.CohortSpec)\n- [0.17.1](/php/docs/reference/analytics-data/0.17.1/V1alpha.CohortSpec)\n- [0.16.4](/php/docs/reference/analytics-data/0.16.4/V1alpha.CohortSpec)\n- [0.14.0](/php/docs/reference/analytics-data/0.14.0/V1alpha.CohortSpec)\n- [0.13.0](/php/docs/reference/analytics-data/0.13.0/V1alpha.CohortSpec)\n- [0.12.0](/php/docs/reference/analytics-data/0.12.0/V1alpha.CohortSpec)\n- [0.11.2](/php/docs/reference/analytics-data/0.11.2/V1alpha.CohortSpec)\n- [0.10.1](/php/docs/reference/analytics-data/0.10.1/V1alpha.CohortSpec)\n- [0.9.5](/php/docs/reference/analytics-data/0.9.5/V1alpha.CohortSpec) \n| **Beta**\n|\n|\n| This library is covered by the [Pre-GA Offerings Terms](/terms/service-terms#1)\n| of the Terms of Service. Pre-GA libraries might have limited support,\n| and changes to pre-GA libraries might not be compatible with other pre-GA versions.\n| For more information, see the\n[launch stage descriptions](/products#product-launch-stages). \nReference documentation and code samples for the Google Analytics Data V1alpha Client class CohortSpec.\n\nThe specification of cohorts for a cohort report.\n\nCohort reports create a time series of user retention for the cohort. For\nexample, you could select the cohort of users that were acquired in the first\nweek of September and follow that cohort for the next six weeks. Selecting\nthe users acquired in the first week of September cohort is specified in the\n`cohort` object. Following that cohort for the next six weeks is specified in\nthe `cohortsRange` object.\nFor examples, see [Cohort Report\nExamples](https://developers.google.com/analytics/devguides/reporting/data/v1/advanced#cohort_report_examples).\nThe report response could show a weekly time series where say your app has\nretained 60% of this cohort after three weeks and 25% of this cohort after\nsix weeks. These two percentages can be calculated by the metric\n`cohortActiveUsers/cohortTotalUsers` and will be separate rows in the report.\n\nGenerated from protobuf message `google.analytics.data.v1alpha.CohortSpec`\n\nNamespace\n---------\n\nGoogle \\\\ Analytics \\\\ Data \\\\ V1alpha\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getCohorts\n\nDefines the selection criteria to group users into cohorts.\n\nMost cohort reports define only a single cohort. If multiple cohorts are\nspecified, each cohort can be recognized in the report by their name.\n\n### setCohorts\n\nDefines the selection criteria to group users into cohorts.\n\nMost cohort reports define only a single cohort. If multiple cohorts are\nspecified, each cohort can be recognized in the report by their name.\n\n### getCohortsRange\n\nCohort reports follow cohorts over an extended reporting date range. This\nrange specifies an offset duration to follow the cohorts over.\n\n### hasCohortsRange\n\n### clearCohortsRange\n\n### setCohortsRange\n\nCohort reports follow cohorts over an extended reporting date range. This\nrange specifies an offset duration to follow the cohorts over.\n\n### getCohortReportSettings\n\nOptional settings for a cohort report.\n\n### hasCohortReportSettings\n\n### clearCohortReportSettings\n\n### setCohortReportSettings\n\nOptional settings for a cohort report."]]
