CohortSpec

Spesifikasi kelompok untuk laporan kelompok.

Laporan kelompok membuat deret waktu retensi pengguna untuk kelompok. Misalnya, Anda dapat memilih kelompok pengguna yang diperoleh pada minggu pertama bulan September dan mengikuti kelompok tersebut selama enam minggu ke depan. Memilih pengguna yang diperoleh pada minggu pertama kelompok September ditentukan di objek cohort. Mengikuti kohor tersebut selama enam minggu ke depan ditentukan dalam objek cohortsRange.

Untuk mengetahui contohnya, lihat Contoh Laporan Kelompok.

Respons laporan dapat menampilkan deret waktu mingguan, misalnya aplikasi Anda mempertahankan 60% dari kelompok ini setelah tiga minggu dan 25% dari kelompok ini setelah enam minggu. Kedua persentase ini dapat dihitung dengan metrik cohortActiveUsers/cohortTotalUsers dan akan merupakan baris terpisah dalam laporan.

Representasi JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Kolom
cohorts[]

object (Cohort)

Menentukan kriteria pemilihan untuk mengelompokkan pengguna ke dalam kelompok.

Sebagian besar laporan kelompok hanya menentukan satu kelompok. Jika beberapa kelompok ditentukan, setiap kelompok dapat dikenali dalam laporan berdasarkan namanya.
cohortsRange

object (CohortsRange)

Laporan kelompok mengikuti kelompok selama rentang tanggal pelaporan yang diperpanjang. Rentang ini menentukan durasi offset untuk mengikuti kelompok.
cohortReportSettings

object (CohortReportSettings)

Setelan opsional untuk laporan kelompok.

Kelompok

Menentukan kriteria pemilihan kelompok. Kelompok adalah sekelompok pengguna yang memiliki karakteristik yang sama. Misalnya, pengguna dengan firstSessionDate yang sama termasuk dalam kelompok yang sama.

Representasi JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Kolom
name

string

Menetapkan nama untuk kelompok ini. Dimensi cohort dinilai untuk nama ini dalam respons laporan. Jika ditetapkan, tidak boleh diawali dengan cohort_ atau RESERVED_. Jika tidak ditetapkan, kohor akan diberi nama berdasarkan indeks berbasis nol cohort_0, cohort_1, dll.
dimension

string

Dimensi yang digunakan oleh kelompok. Wajib dan hanya mendukung firstSessionDate.
dateRange

object (DateRange)

Kelompok memilih pengguna yang tanggal kontak pertamanya berada di antara tanggal mulai dan tanggal akhir yang ditentukan di dateRange. dateRange ini tidak menentukan rentang tanggal lengkap data peristiwa yang ada dalam laporan kelompok. Dalam laporan kelompok, dateRange ini diperluas menurut perincian dan offset yang ada di cohortsRange; data peristiwa untuk rentang tanggal pelaporan yang diperpanjang ada di laporan kelompok.

Dalam permintaan kelompok, dateRange ini wajib ada dan dateRanges dalam RunReportRequest atau RunPivotReportRequest tidak boleh ditentukan.

dateRange ini secara umum harus sesuai dengan perincian kelompok. Jika CohortsRange menggunakan perincian harian, dateRange ini dapat berupa satu hari. Jika CohortsRange menggunakan perincian mingguan, dateRange ini dapat diselaraskan dengan batas minggu, mulai hari Minggu dan berakhir pada hari Sabtu. Jika CohortsRange menggunakan perincian bulanan, dateRange ini dapat disejajarkan dengan satu bulan, mulai dari yang pertama dan berakhir pada hari terakhir bulan tersebut.

RentangKelompok

Mengonfigurasi rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok. Menentukan durasi offset untuk mengikuti kelompok.

Representasi JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Kolom
granularity

enum (Granularity)

Wajib diisi. Perincian yang digunakan untuk menafsirkan startOffset dan endOffset bagi rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok.
startOffset

integer

startOffset menentukan tanggal mulai rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok. startOffset biasanya ditetapkan ke 0 sehingga laporan berisi data dari akuisisi kelompok berikutnya.

Jika granularity adalah DAILY, startDate dari rentang tanggal pelaporan yang diperpanjang adalah startDate dari kelompok ditambah startOffset hari.

Jika granularity adalah WEEKLY, startDate dari rentang tanggal pelaporan yang diperpanjang adalah startDate dari kelompok ditambah startOffset * 7 hari.

Jika granularity adalah MONTHLY, startDate dari rentang tanggal pelaporan yang diperpanjang adalah startDate dari kelompok ditambah startOffset * 30 hari.
endOffset

integer

Wajib diisi. endOffset menentukan tanggal akhir rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok. endOffset dapat berupa bilangan bulat positif, tetapi biasanya ditetapkan ke 5 sampai 10 sehingga laporan berisi data pada kelompok selama beberapa jangka waktu perincian berikutnya.

Jika granularity adalah DAILY, endDate dari rentang tanggal pelaporan yang diperpanjang adalah endDate dari kelompok ditambah endOffset hari.

Jika granularity adalah WEEKLY, endDate dari rentang tanggal pelaporan yang diperpanjang adalah endDate dari kelompok ditambah endOffset * 7 hari.

Jika granularity adalah MONTHLY, endDate dari rentang tanggal pelaporan yang diperpanjang adalah endDate dari kelompok ditambah endOffset * 30 hari.

Tingkat perincian

Perincian yang digunakan untuk menafsirkan startOffset dan endOffset bagi rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok.

Enumerasi
GRANULARITY_UNSPECIFIED Tidak boleh ditentukan.
DAILY Perincian harian. Biasa digunakan jika dateRange kelompok adalah satu hari dan permintaan berisi cohortNthDay.
WEEKLY Perincian mingguan. Biasa digunakan jika dateRange kohor berdurasi seminggu (mulai hari Minggu dan berakhir pada hari Sabtu) dan permintaan berisi cohortNthWeek.
MONTHLY Perincian bulanan. Biasanya digunakan jika dateRange kelompok berdurasi satu bulan dan permintaannya berisi cohortNthMonth.

SetelanLaporanKelompok

Setelan opsional laporan kelompok.

Representasi JSON 
{
  "accumulate": boolean
}
Kolom
accumulate

boolean

Jika benar, akan mengakumulasi hasil dari hari kontak pertama ke hari akhir. Tidak didukung di RunReportRequest.