CohortSpec

Kohort raporu için kohortların spesifikasyonu.

Kohort raporları, grup için kullanıcıları elde tutma ile ilgili bir zaman serisi oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı kohortunu seçebilir ve sonraki altı hafta boyunca bu kohortu takip edebilirsiniz. Eylül grubunun ilk haftasında edinilen kullanıcıların seçilmesi cohort nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortun ardından gelen kohort cohortsRange nesnesinde belirtilir.

Örnekler için Kohort Raporu Örnekleri başlıklı makaleyi inceleyin.

Rapor yanıtında, uygulamanızın üç hafta sonra bu kohortun% 60'ını ve altı hafta sonra bu kohortun% 25'ini elinde tuttuğunu belirten haftalık bir zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriği ile hesaplanabilir ve rapordaki ayrı satırlar olarak kullanılır.

JSON gösterimi
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Alanlar
cohorts[]

object (Cohort)

Kullanıcıları kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar.

Çoğu grup raporu yalnızca bir grubu tanımlar. Birden çok kohort belirtilirse her kohort, raporda adıyla tanınabilir.

cohortsRange

object (CohortsRange)

Kohort raporları, daha geniş bir raporlama tarih aralığı boyunca grupları takip eder. Bu aralık, kohortların takip edileceği ofset süresini belirtir.

cohortReportSettings

object (CohortReportSettings)

Grup raporu için isteğe bağlı ayarlar.

Kohort

Kohort seçim ölçütü tanımlar. Kohort, ortak bir özelliği paylaşan kullanıcı gruplarıdır. Örneğin, aynı firstSessionDate değerine sahip kullanıcılar aynı kohorta dahildir.

JSON gösterimi
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Alanlar
name

string

Bu gruba bir ad atar. Bir rapor yanıtında cohort boyutu bu ada değerlendirilir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Politika ayarlanmazsa kohortlar sıfır tabanlı dizinlerine (cohort_0, cohort_1 vb.) göre adlandırılır.

dimension

string

Grup tarafından kullanılan boyut. Zorunludur ve yalnızca firstSessionDate destekler.

dateRange

object (DateRange)

Grup, ilk temas tarihi dateRange içinde tanımlanan başlangıç tarihi ile bitiş tarihi arasında olan kullanıcıları seçer. Bu dateRange, grup raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Grup raporunda bu dateRange, cohortsRange öğesindeki ayrıntı düzeyi ve ofset ile genişletilir. Genişletilmiş raporlama tarih aralığına ait etkinlik verileri, grup raporunda mevcuttur.

Grup isteğinde, bu dateRange zorunludur ve RunReportRequest veya RunPivotReportRequest içindeki dateRanges belirtilmemiş olmalıdır.

Bu dateRange, genellikle kohortun ayrıntı düzeyiyle uyumlu olmalıdır. CohortsRange, günlük ayrıntı düzeyini kullanıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyi kullanıyorsa bu dateRange, Pazar günü başlayıp Cumartesi günü sona erecek şekilde hafta sınırına hizalanabilir. CohortsRange, aylık ayrıntı düzeyi kullanıyorsa bu dateRange, ayın ilk gününden başlayıp son günü bitecek şekilde bir aya hizalanabilir.

CohortsRange

Grup raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortların takip edileceği ofset süresini belirtir.

JSON gösterimi
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Alanlar
granularity

enum (Granularity)

Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset değerlerini yorumlamak için kullanılan ayrıntı düzeyi.

startOffset

integer

startOffset, grup raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset genellikle 0 değerine ayarlanır. Böylece raporlar kohortun alınmasından ileriye yönelik verileri içerir.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığındaki startDate, grubun startDate kadarına ek olarak startOffset gündür.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığındaki startDate, grubun startDate kadarına ek olarak startOffset * 7 gündür.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığındaki startDate, grubun startDate kadarına ek olarak startOffset * 30 gündür.

endOffset

integer

Zorunlu. endOffset, grup raporu için genişletilmiş raporlama tarihi aralığının bitiş tarihini belirtir. endOffset herhangi bir pozitif tam sayı olabilir ancak genellikle 5 ile 10 arasında bir değere ayarlanır. Böylece raporlar, sonraki birkaç ayrıntı düzeyi dönemi için kohortla ilgili verileri içerir.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığındaki endDate, grubun endDate kadarına ek olarak endOffset gündür.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığındaki endDate, grubun endDate kadarına ek olarak endOffset * 7 gündür.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığındaki endDate, grubun endDate kadarına ek olarak endOffset * 30 gündür.

Ayrıntı düzeyi

Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset değerlerini yorumlamak için kullanılan ayrıntı düzeyi.

Sıralamalar
GRANULARITY_UNSPECIFIED Hiçbir zaman belirtilmemelidir.
DAILY Günlük ayrıntı düzeyi. Grubun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa genellikle kullanılır.
WEEKLY Haftalık ayrıntı düzeyi. Grubun dateRange değeri bir haftaysa (Pazar günü başlayıp Cumartesi günü sona erer) ve istek cohortNthWeek değerini içeriyorsa genellikle kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Grubun dateRange değeri bir ayysa ve istek cohortNthMonth içeriyorsa genellikle kullanılır.

CohortReportSettings

Grup raporunun isteğe bağlı ayarları.

JSON gösterimi
{
  "accumulate": boolean
}
Alanlar
accumulate

boolean

Doğru ise ilk temas gününden bitiş gününe kadar sonucu toplar. RunReportRequest içinde desteklenmiyor.