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 में काम नहीं करता.