CohortSpec

Grup raporu için grupların özellikleri.

Kohort raporları, ilgili grup için kullanıcı elde tutma zaman serisi oluşturur. Örneğin, Eylül ayının ilk haftasında edinilen kullanıcı grubunu seçebilir ve bu grubu önümüzdeki altı hafta boyunca takip edebilirsiniz. Eylül ayının ilk haftasında edinilen kullanıcıların seçilmesi, cohort nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortu takip etmek için cohortsRange nesnesi kullanılır.

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

Rapor yanıtında, uygulamanızın üç hafta sonra bu kohortun% 60'ını, altı hafta sonra ise% 25'ini elinde tuttuğunu belirten haftalık bir zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriği kullanılarak hesaplanabilir ve raporda 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ı gruplara ayırmak için kullanılan seçim ölçütlerini tanımlar.

Çoğu kullanıcı grubu raporu yalnızca tek bir kullanıcı grubu tanımlar. Birden fazla kohort belirtilirse her kohort raporda adıyla tanınabilir.
cohortsRange

object (CohortsRange)

Grup raporları, genişletilmiş bir raporlama tarih aralığındaki grupları izler. Bu aralık, kohortları takip etmek için bir ofset süresi belirtir.
cohortReportSettings

object (CohortReportSettings)

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

Kohort

Kohort seçim ölçütlerini 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 kohort için bir ad atar. cohort boyutu, rapor yanıtında bu adla değerlenir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Ayarlanmamışsa kohortlar sıfır tabanlı dizinlerine göre (cohort_0, cohort_1 vb.) adlandırılır.
dimension

string

Grubun kullandığı 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, kohort raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Grup raporunda bu dateRange, cohortsRange'teki ayrıntı düzeyi ve ofset ile genişletilir; genişletilmiş raporlama tarih aralığı için etkinlik verileri grup 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üzeyinde kullanılıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyinde kullanılıyorsa bu dateRange, pazardan başlayıp cumartesi günü sona eren bir hafta sınırıyla hizalanabilir. CohortsRange aylık ayrıntı düzeyinde kullanılıyorsa bu dateRange, ayın ilk gününden başlayıp son gününde sona eren bir ayla uyumlu olabilir.

CohortsRange

Bir kohort raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortları takip etmek için bir başlangıç süresi belirtir.

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

enum (Granularity)

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

integer

startOffset, bir kohort raporu için genişletilmiş raporlama tarihi aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlar, kohortun edinilmesinden sonraki verileri içerir.

granularity DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri, kohortun startDate değerine startOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının startDate değeri, kohortun startDate değerine startOffset * 7 gün eklenerek hesaplanır.

granularity MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri, kohortun startDate değerine startOffset * 30 gün eklenerek hesaplanır.
endOffset

integer

Zorunlu. endOffset, kohort raporu için genişletilmiş raporlama tarihi aralığının bitiş tarihini belirtir. endOffset herhangi bir pozitif tam sayı olabilir ancak raporların sonraki birkaç ayrıntı düzeyi zaman aralığı için kohortla ilgili veriler içermesi amacıyla genellikle 5 ila 10 olarak ayarlanır.

granularity DAILY ise genişletilmiş raporlama tarih aralığının endDate değeri, kohortun endDate değerine endOffset gün eklenerek hesaplanır.

granularity WEEKLY ise genişletilmiş raporlama tarih aralığının endDate değeri, kohortun endDate değerine endOffset * 7 gün eklenerek hesaplanır.

granularity MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri, kohortun endDate değerine endOffset * 30 gün eklenerek hesaplanır.

Ayrıntı düzeyi

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

Sıralamalar
GRANULARITY_UNSPECIFIED Asla belirtilmemelidir.
DAILY Günlük ayrıntı düzeyi. Kohortun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa genellikle kullanılır.
WEEKLY Haftalık ayrıntı düzeyi. Kohortun dateRange özelliği bir hafta (Pazar'dan Cumartesi'ye kadar) süreliyse ve istek cohortNthWeek içeriyorsa genellikle kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Kullanıcı grubunun dateRange süresi bir ay ise ve istek cohortNthMonth içeriyorsa genellikle kullanılır.

CohortReportSettings

Kohort 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 sürümünde desteklenmez.