CohortSpec

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CohortSpec",
  "title": "CohortSpec",
  "description": "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 the `cohort` object. Following that cohort for the next six weeks is specified in the `cohortsRange` object. For examples, see [Cohort Report Examples](https://developers.google.com/analytics/devguides/reporting/data/v1/advanced#cohort_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 metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the report.",
  "properties": {
    "cohortReportSettings": {
      "$ref": "#/components/schemas/CohortReportSettings",
      "description": "Optional settings for a cohort report."
    },
    "cohorts": {
      "description": "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.",
      "items": {
        "$ref": "#/components/schemas/Cohort"
      },
      "type": "array"
    },
    "cohortsRange": {
      "$ref": "#/components/schemas/CohortsRange",
      "description": "Cohort reports follow cohorts over an extended reporting date range. This range specifies an offset duration to follow the cohorts over."
    }
  },
  "type": "object"
}