CohortSpec

Bir grup raporu için kohortların spesifikasyonu.

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

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

Rapor yanıtında, uygulamanızın üç hafta sonra bu grubun% 60'ını, altı hafta sonra da bu kohortun% 25'ini koruduğunu belirten bir haftalık zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriğiyle hesaplanabilir ve raporda ayrı satırlar olur.

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 kohort raporu yalnızca tek bir kohort tanımlar. Birden fazla kohort belirtilirse her kohort raporda adlarıyla tanınabilir.
cohortsRange

object (CohortsRange)

Kohort raporları, geniş bir raporlama tarih aralığı boyunca kohortları 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ğe sahip 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 ayarlanır. 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 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 artırılır; Genişletilmiş raporlama tarih aralığına ait etkinlik verileri bir grup raporunda mevcut.

Bir kohort isteğinde bu dateRange gereklidir ve RunReportRequest ya da RunPivotReportRequest içindeki dateRanges belirtilmemelidir.

Bu dateRange, genellikle grubun 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üzeyini kullanıyorsa bu dateRange, Pazar gününden 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ünde sona erecek şekilde bir aya hizalanabilir.

CohortsRange

Bir 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 öğelerini yorumlamada kullanılan ayrıntı düzeyi.
startOffset

integer

startOffset, bir grup raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlarda, kohortun edinildiği tarihten sonraki veriler yer alır.

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

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

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset * 30 gün olur.
endOffset

integer

Zorunlu. endOffset, bir 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ö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ün olur.

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

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset * 30 gün olur.

Ayrıntı düzeyi

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

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

CohortReportSettings

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

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

boolean

True (doğru) ise, sonucu ilk temas gününden bitiş gününe kadar toplar. RunReportRequest sisteminde desteklenmiyor.