CohortSpec

同類群組報表的同類群組規格。

「同類群組」報表會為同類群組建立使用者留存時間序列。舉例來說，您可以選擇 9 月第一週所招攬的使用者同類群組，並在接下來的六週追蹤該同類群組。選取 9 月同類群組第一週招攬到的使用者，是在 cohort 物件中指定。系統會透過 cohortsRange 物件指定未來六週的同類群組。

如需範例，請參閱同類群組報表範例。

報表回應可能會顯示每週的時間序列，其中顯示您的應用程式在三週後，在這個同類群組中保留了 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_ 開頭。如未設定，同類群組會依照索引 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 為一週期間 (從星期日開始並在星期六結束)，且要求包含 cohortNthWeek 時。
MONTHLY 每月精細程度：通常用於同類群組的 dateRange 為一個月，且要求包含 cohortNthMonth。

CohortReportSettings

同類群組報表的選用設定。

JSON 表示法 
{
  "accumulate": boolean
}
欄位
accumulate

boolean

如果為 true，則會從第一個接觸日期開始累計結果。RunReportRequest 不支援。