CohortSpec

कोहॉर्ट रिपोर्ट के लिए कोहॉर्ट की खास जानकारी.

कोहॉर्ट रिपोर्ट, कोहॉर्ट के लिए उपयोगकर्ता को अपने साथ जोड़े रखने की टाइम सीरीज़ बनाती हैं. उदाहरण के लिए, उन उपयोगकर्ताओं के कोहॉर्ट को चुना जा सकता है जिन्हें सितंबर के पहले हफ़्ते में हासिल किया गया था. इसके बाद, अगले छह हफ़्तों तक उस कोहॉर्ट को फ़ॉलो किया जा सकता है. सितंबर के पहले हफ़्ते में हासिल किए गए उपयोगकर्ताओं को चुनने के बारे में cohort ऑब्जेक्ट में बताया गया है. अगले छह हफ़्तों के लिए कोहॉर्ट को फ़ॉलो करने के बारे में cohortsRange ऑब्जेक्ट में बताया गया है.

उदाहरणों के लिए, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के उदाहरण देखें.

इस जवाब में, एक हफ़्ते की टाइम सीरीज़ दिख सकती है. इसमें यह कहा जाता है कि तीन हफ़्ते बाद, एक जैसे उपयोगकर्ताओं के ग्रुप का 60% हिस्सा आपके ऐप्लिकेशन पर बना रहता है. वहीं, छह हफ़्ते बाद, 25% लोग एक जैसे उपयोगकर्ताओं के इस ग्रुप में बने रहते हैं. इन दोनों प्रतिशतों का हिसाब, cohortActiveUsers/cohortTotalUsers मेट्रिक से लगाया जा सकता है और ये रिपोर्ट की अलग-अलग पंक्तियों में होंगी.

JSON के काेड में दिखाना 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
फ़ील्ड
cohorts[]

object (Cohort)

इस नीति से, उपयोगकर्ताओं को कोहॉर्ट में ग्रुप करने के लिए चुनने का नियम तय होता है.

ज़्यादातर कोहॉर्ट रिपोर्ट सिर्फ़ एक कोहॉर्ट के बारे में बताती हैं. अगर एक से ज़्यादा कोहॉर्ट तय किए गए हैं, तो रिपोर्ट में हर कोहॉर्ट को उनके नाम से पहचाना जा सकता है.
cohortsRange

object (CohortsRange)

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट, रिपोर्ट की लंबी तारीख की सीमा के दौरान एक जैसे उपयोगकर्ताओं के ग्रुप को फ़ॉलो करती हैं. इस रेंज से, कोहॉर्ट को फ़ॉलो करने के लिए ऑफ़सेट की अवधि तय होती है.
cohortReportSettings

object (CohortReportSettings)

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए वैकल्पिक सेटिंग.

समानता रखने वाले लोग

कोहॉर्ट को चुनने का तरीका तय करता है. कोहॉर्ट, उन उपयोगकर्ताओं के ग्रुप को कहते हैं जिनकी विशेषताएं एक जैसी होती हैं. उदाहरण के लिए, एक जैसी firstSessionDate वाले उपयोगकर्ता, एक ही समानता रखने वाले लोगों के ग्रुप में शामिल होते हैं.

JSON के काेड में दिखाना 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
फ़ील्ड
name

string

इस कोहॉर्ट को कोई नाम असाइन करता है. रिपोर्ट में मिले जवाब में इस नाम के लिए, डाइमेंशन cohort की वैल्यू दी गई है. अगर यह नीति सेट है, तो इसे cohort_ या RESERVED_ से शुरू नहीं किया जा सकता. अगर यह नीति सेट नहीं की गई है, तो कोहॉर्ट को उनके शून्य आधारित इंडेक्स cohort_0, cohort_1 वगैरह के हिसाब से नाम दिया जाता है.
dimension

string

कोहॉर्ट में इस्तेमाल किया गया डाइमेंशन. ज़रूरी है और सिर्फ़ firstSessionDate के साथ काम करता है.
dateRange

object (DateRange)

कोहॉर्ट, उन उपयोगकर्ताओं को चुना जाता है जिनका पहला टच किए जाने की तारीख, dateRange में बताई गई शुरू होने और खत्म होने की तारीख के बीच की होती है. यह dateRange, किसी एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट में मौजूद, तारीख की पूरी सीमा के बारे में नहीं बताता है. एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट में, इस dateRange को cohortsRange में मौजूद जानकारी के स्तर और ऑफ़सेट के हिसाब से बढ़ाया जाता है; रिपोर्टिंग की तारीख की बढ़ाई गई सीमा का इवेंट डेटा, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट में मौजूद होता है.

एक जैसे उपयोगकर्ताओं के ग्रुप के अनुरोध में, यह dateRange ज़रूरी है. साथ ही, RunReportRequest या RunPivotReportRequest में मौजूद dateRanges के बारे में नहीं बताया जाना चाहिए.

आम तौर पर, यह dateRange एक जैसे उपयोगकर्ताओं के ग्रुप के स्तर के हिसाब से होना चाहिए. अगर CohortsRange हर दिन के हिसाब से जानकारी का इस्तेमाल करता है, तो इस dateRange को एक दिन के लिए किया जा सकता है. अगर CohortsRange, हफ़्ते के हिसाब से जानकारी का लेवल इस्तेमाल करता है, तो इस dateRange को हफ़्ते की सीमा के हिसाब से अलाइन किया जा सकता है. यह सीमा, रविवार से शुरू होती है और शनिवार को खत्म होती है. अगर CohortsRange, हर महीने के लेवल के हिसाब से जानकारी का इस्तेमाल करता है, तो इस dateRange को महीने के हिसाब से अलाइन किया जा सकता है. यह समय, महीने के पहले दिन से शुरू होता है और महीने के आखिरी दिन पर खत्म होता है.

CohortsRange

यह नीति, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए, ज़्यादा समय तक रिपोर्टिंग की तारीख की सीमा कॉन्फ़िगर करती है. कोहॉर्ट को फ़ॉलो करने के लिए ऑफ़सेट की अवधि तय करता है.

JSON के काेड में दिखाना 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
फ़ील्ड
granularity

enum (Granularity)

ज़रूरी है. एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट की बढ़ी हुई तारीख की सीमा के लिए, startOffset और endOffset को समझने के लिए इस्तेमाल किया गया डेटा.
startOffset

integer

startOffset, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा के शुरू होने की तारीख के बारे में बताता है. आम तौर पर, startOffset को 0 पर सेट किया जाता है, ताकि रिपोर्ट में, कोहॉर्ट में उपयोगकर्ता हासिल करने का डेटा शामिल हो.

अगर granularity DAILY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा startDate, समानता रखने वाले लोगों के startDate और startOffset दिन होगी.

अगर granularity WEEKLY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा startDate, समानता रखने वाले लोगों के startDate और startOffset * 7 दिन होगी.

अगर granularity MONTHLY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा startDate, समानता रखने वाले लोगों के startDate और startOffset * 30 दिन होगी.
endOffset

integer

ज़रूरी है. endOffset, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के खत्म होने की तारीख की सीमा के बारे में बताता है. endOffset कोई भी धनात्मक पूर्णांक हो सकता है. हालांकि, आम तौर पर इसे 5 से 10 पर सेट किया जाता है, ताकि रिपोर्ट में अगली कुछ जानकारी वाली समयावधि के लिए कोहॉर्ट का डेटा शामिल हो.

अगर granularity DAILY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा endDate, समानता रखने वाले लोगों के endDate और endOffset दिन होगी.

अगर granularity WEEKLY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा endDate, समानता रखने वाले लोगों के endDate और endOffset * 7 दिन होगी.

अगर granularity MONTHLY है, तो रिपोर्टिंग की बढ़ी हुई तारीख की सीमा endDate, समानता रखने वाले लोगों के endDate और endOffset * 30 दिन होगी.

जानकारी का स्तर

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट की बढ़ी हुई तारीख की सीमा के लिए, startOffset और endOffset को समझने के लिए इस्तेमाल किया गया डेटा.

Enums
GRANULARITY_UNSPECIFIED कभी भी तय नहीं किया जाना चाहिए.
DAILY कंट्रोल के चुने गए हर दिन के आंकड़े. आम तौर पर, इसका इस्तेमाल तब किया जाता है, जब कोहॉर्ट का dateRange एक दिन हो और अनुरोध में cohortNthDay शामिल हो.
WEEKLY जानकारी का हर हफ़्ते का लेवल. आम तौर पर, इसका इस्तेमाल तब किया जाता है, जब कोहॉर्ट का dateRange एक हफ़्ता हो (रविवार से शुरू होकर शनिवार को खत्म होता है) और अनुरोध में cohortNthWeek शामिल हो.
MONTHLY हर महीने का डेटा का स्तर. आम तौर पर, इसका इस्तेमाल तब किया जाता है, जब समानता रखने वाले लोगों का dateRange एक महीने का हो और अनुरोध में cohortNthMonth शामिल हो.

CohortReportSettings

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट की वैकल्पिक सेटिंग.

JSON के काेड में दिखाना 
{
  "accumulate": boolean
}
फ़ील्ड
accumulate

boolean

अगर सही है, तो पहले टच दिन से आखिरी दिन तक के नतीजे को इकट्ठा किया जाता है. यह सुविधा RunReportRequest में उपलब्ध नहीं है.