CohortSpec
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
同類群組報表的同類群組規格。
「同類群組」報表會為同類群組建立使用者留存時間序列。舉例來說,您可以選擇 9 月第一週所招攬的使用者同類群組,並在接下來的六週追蹤該同類群組。選取 9 月同類群組第一週招攬到的使用者,是在 cohort
物件中指定。系統會透過 cohortsRange
物件指定未來六週的同類群組。
如需範例,請參閱同類群組報表範例。
報表回應可能會顯示每週的時間序列,其中顯示您的應用程式在三週後,在這個同類群組中保留了 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_ 開頭。如未設定,同類群組會依照索引 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 不支援。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-05-02 (世界標準時間)。
[{
"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":"其他"
}]