CohortSpec

Grup raporu için grupların özellikleri.

Grup raporları, grup için bir zaman serisi kullanıcı elde tutma işlemi oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı kohortunu seçebilir ve bu kohortu sonraki altı hafta boyunca 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 sonraki altı haftası cohortsRange nesnesinde belirtilir.

Örnekler için Kohort Raporu Örnekleri bölümüne bakın.

Rapora verilen yanıtta, uygulamanızın üç hafta sonra bu kohortun% 60'ını ve bu kohortun% 25'ini altı hafta sonra 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 olacaktı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 kohortu tanımlar. Birden fazla kohort belirtilirse her kohort raporda adlarıyla tanınabilir.
cohortsRange

object (CohortsRange)

Grup raporları, genişletilmiş bir raporlama tarihi aralığı boyunca kohortları 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ı 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. cohort boyutu, bir rapor yanıtında bu ada göre değerlendirilir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Politika ayarlanmadan bırakılırsa 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 desteklenir.
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, bir grup raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Bir grup raporunda bu dateRange, cohortsRange öğesinde bulunan ayrıntı düzeyi ve ofsetle genişletilir; genişletilmiş raporlama tarih aralığına ait etkinlik verileri bir grup raporunda mevcuttur.

Grup isteğinde, bu dateRange gereklidir 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ü bitecek şekilde bir 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ü 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 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 edinilmesinden sonraki verileri içerir.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri, grubun startDate kadarı artı startOffset gündür.

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

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri, grubun startDate kadarı artı 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-10 olarak 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 kadarı artı endOffset gündür.

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

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri, grubun endDate kadarı artı 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 eriyor) ve istek cohortNthWeek içeriyorsa yaygın olarak kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Grubun dateRange değeri bir ayysa ve istek cohortNthMonth içeriyorsa yaygın olarak kullanılır.

Grup Raporu Ayarları

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

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

boolean

Doğru ise sonucu ilk temas gününden bitiş gününe kadar toplar. RunReportRequest uygulamasında desteklenmiyor.