コホート レポートのコホートの仕様。
コホート レポートでは、コホートのユーザー維持率の時系列が作成されます。たとえば、9 月の第 1 週に獲得したユーザーのコホートを選択して、そのコホートを次の 6 週間フォローします。9 月のコホートの最初の週に獲得したユーザーの選択は、cohort
オブジェクトで指定します。その後、次の 6 週間のコホートを cohortsRange
オブジェクトで指定します。
例については、コホート レポートの例をご覧ください。
レポートの回答では、アプリがこのコホートの 60% を 3 週間後に、このコホートの 25% が 6 週間後に保持しているという週単位の時系列を表示できます。この 2 つの割合は指標 cohortActiveUsers/cohortTotalUsers
で計算でき、レポートでは別々の行に表示されます。
JSON 表現 |
---|
{ "cohorts": [ { object ( |
フィールド | |
---|---|
cohorts[] |
ユーザーをコホートにグループ化するための選択条件を定義します。 ほとんどのコホート レポートでは、定義されるコホートは 1 つのみです。複数のコホートを指定すると、レポートで各コホートを名前で識別できます。 |
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 が 1 日で、リクエストに cohortNthDay が含まれている場合に使用されます。 |
WEEKLY |
週単位の粒度。一般的に、コホートの dateRange が 1 週間(日曜日から土曜日まで)で、リクエストに cohortNthWeek が含まれている場合に使用されます。 |
MONTHLY |
月単位の粒度。一般的に、コホートの dateRange の期間が 1 か月で、リクエストに cohortNthMonth が含まれている場合に使用されます。 |
CohortReportSettings
コホート レポートのオプション設定。
JSON 表現 |
---|
{ "accumulate": boolean } |
フィールド | |
---|---|
accumulate |
true の場合、最初の接触日から終了日までの結果が累積されます。 |