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ı grubunu seçebilir ve sonraki altı hafta boyunca bu grubu takip edebilirsiniz. Eylül kohortunun ilk haftasında edinilen kullanıcıların seçilmesi cohort nesnesinde belirtilir. Sonraki altı hafta için bu kohortun ardından, cohortsRange nesnesinde belirtilir.

Örnekler için Kohort Raporu Örnekleri'ni inceleyin.

Rapor yanıtı, 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österebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriği ile hesaplanabilir ve rapordaki ayrı satırlar olarak gösterilir.

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 kohortu tanımlar. Birden çok kohort belirtilirse her kohort raporda adıyla tanınabilir.
cohortsRange

object (CohortsRange)

Grup raporları, daha geniş bir raporlama tarih aralığı boyunca grupları takip eder. Bu aralık, kohortların takip edilmesi için bir ofset süresi 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ı grubudur. Ö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. cohort boyutu, bir rapor yanıtında bu ada göre değerlendirilir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa gruplar sıfır tabanlı dizinleri cohort_0, cohort_1 vb. ile adlandırılır.
dimension

string

Grup tarafından kullanılan boyut. Zorunludur ve yalnızca firstSessionDate kullanımını 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 öğesinde mevcut olan ayrıntı düzeyi ve ofset ile genişletilir. Genişletilmiş raporlama tarih aralığına ait etkinlik verileri ise kohort raporunda bulunur.

Kohort isteğinde bu dateRange gereklidir ve RunReportRequest veya RunPivotReportRequest içindeki dateRanges belirtilmemelidir.

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

CohortsRange

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

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

enum (Granularity)

Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığına ait 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 olarak ayarlanır. Böylece raporlarda grup edinmeden ileriye yönelik veriler yer alır.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate değerine ek olarak startOffset gündür.

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

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate değerine ek olarak startOffset * 30 gündür.
endOffset

integer

Zorunlu. endOffset, grup raporu için genişletilmiş raporlama tarih 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ığının endDate değeri grubun endDate değerine ek olarak endOffset gündür.

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

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

Ayrıntı düzeyi

Grup raporunun genişletilmiş raporlama tarih aralığına ait 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 değerine ayarlanırsa ilk temas gününden bitiş gününe kadar sonucu toplar. RunReportRequest dilinde desteklenmiyor.