同類群組報表的同類群組規格。
「同類群組」報表會為同類群組建立使用者留存時間序列。舉例來說,您可以選擇 9 月第一週所招攬的使用者同類群組,並在接下來的六週追蹤該同類群組。選取 9 月同類群組第一週招攬到的使用者,是在 cohort
物件中指定。系統會透過 cohortsRange
物件指定未來六週的同類群組。
如需範例,請參閱同類群組報表範例。
報表回應可能會顯示每週的時間序列,其中顯示您的應用程式在三週後,在這個同類群組中保留了 60%,6 週後則保留 25% 的同類群組。這兩個百分比可由指標「cohortActiveUsers/cohortTotalUsers
」計算,在報表中則會以個別資料列顯示。
JSON 表示法 |
---|
{ "cohorts": [ { object ( |
欄位 | |
---|---|
cohorts[] |
定義選取條件,將使用者歸入同類群組。 多數同類群組報表只會定義單一同類群組。如果指定多個同類群組,報表中的各個同類群組皆可依名稱識別。 |
cohortsRange |
「同類群組」報表會在較長的報表日期範圍內追蹤同類群組。這個範圍可指定隨著同類群組追蹤的偏移時間長度。 |
cohortReportSettings |
同類群組報表的選用設定。 |
同類群組
定義同類群組選取條件。同類群組是指具有共同特徵的一群使用者。舉例來說,firstSessionDate
相同的使用者屬於同一個同類群組。
JSON 表示法 |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
欄位 | |
---|---|
name |
為這個同類群組命名。報表回應中的維度 |
dimension |
同類群組使用的維度。必要,且僅支援 |
dateRange |
同類群組會選取開始日期落在 在同類群組要求中,這個 這個 |
CohortsRange
設定同類群組報表的延長報表日期範圍。指定要追蹤同類群組的偏移時間長度。
JSON 表示法 |
---|
{
"granularity": enum ( |
欄位 | |
---|---|
granularity |
必要欄位。這個精細程度可用於解讀同類群組報表中延伸報表日期範圍的 |
startOffset |
如果 如果 如果 |
endOffset |
必要欄位。 如果 如果 如果 |
精細程度
這個精細程度可用於解讀同類群組報表中延伸報表日期範圍的 startOffset
和 endOffset
。
列舉 | |
---|---|
GRANULARITY_UNSPECIFIED |
一律不得指定。 |
DAILY |
每日精細程度。如果同類群組的 dateRange 為一天,且要求包含 cohortNthDay ,通常會使用這個選項。 |
WEEKLY |
每週精細程度。通常用於在同類群組的 dateRange 為一週期間 (從星期日開始並在星期六結束),且要求包含 cohortNthWeek 時。 |
MONTHLY |
每月精細程度:通常用於同類群組的 dateRange 為一個月,且要求包含 cohortNthMonth 。 |
CohortReportSettings
同類群組報表的選用設定。
JSON 表示法 |
---|
{ "accumulate": boolean } |
欄位 | |
---|---|
accumulate |
如果為 true,則會從第一個接觸日期開始累計結果。 |