CohortSpec

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

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

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

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

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

object (Cohort)

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

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

cohortsRange

object (CohortsRange)

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

cohortReportSettings

object (CohortReportSettings)

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

जेएसओएन के काेड में दिखाना
{
  "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

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

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

boolean

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