Method: reports.batchGet

Analytics का डेटा दिखाता है.

एचटीटीपी अनुरोध

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
फ़ील्ड
reportRequests[]

object(ReportRequest)

हर अनुरोध का अलग जवाब होगा. ज़्यादा से ज़्यादा पांच अनुरोध किए जा सकते हैं. सभी अनुरोध एक ही होने चाहिए, dateRanges, viewId, segments, samplingLevel, और cohortGroup.

useResourceQuotas

boolean

संसाधन आधारित कोटा चालू करता है, (डिफ़ॉल्ट रूप से False पर सेट होता है). अगर यह फ़ील्ड True पर सेट है, तो हर व्यू (प्रोफ़ाइल) के कोटे को अनुरोध की कंप्यूटेशनल लागत के हिसाब से कंट्रोल किया जाता है. ध्यान दें कि लागत के हिसाब से कोटा इस्तेमाल करने से, सैंपलिंग रेट बढ़ जाएगा. (SMALL के लिए 1 करोड़, LARGE के लिए 10 करोड़. ज़्यादा जानकारी के लिए, सीमाओं और कोटा से जुड़ा दस्तावेज़ देखें.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

मुख्य रिस्पॉन्स क्लास, जिसमें Reporting API batchGet कॉल से मिलने वाली रिपोर्ट शामिल होती हैं.

जेएसओएन के काेड में दिखाना 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
फ़ील्ड
reports[]

object(Report)

हर अनुरोध से जुड़े जवाब.

queryCost

number

क्वेरी चलाने के लिए काटी गई संसाधन कोटा टोकन की संख्या. सभी जवाब शामिल हैं.

resourceQuotasRemaining

object(ResourceQuotasRemaining)

प्रॉपर्टी के लिए बचे हुए संसाधन कोटा की संख्या.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ReportRequest

मुख्य अनुरोध की क्लास, Reporting API के अनुरोध के बारे में बताती है.

जेएसओएन के काेड में दिखाना 
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
फ़ील्ड
viewId

string

वह Analytics व्यू आईडी जिससे डेटा वापस पाना है. batchGet तरीके में हर ReportRequest में एक ही viewId होना चाहिए.

dateRanges[]

object(DateRange)

अनुरोध में तारीख की सीमाएं. अनुरोध की ज़्यादा से ज़्यादा दो तारीख की सीमाएं हो सकती हैं. जवाब में अनुरोध की हर तारीख की सीमा के लिए, डाइमेंशन के हर कॉम्बिनेशन के लिए मेट्रिक वैल्यू का एक सेट शामिल होगा. इसलिए, अगर तारीख की दो सीमाएं हैं, तो मेट्रिक वैल्यू के दो सेट होंगे, एक मूल तारीख की सीमा के लिए और दूसरा तारीख की दूसरी सीमा के लिए. reportRequest.dateRanges फ़ील्ड को कोहॉर्ट या लाइफ़टाइम वैल्यू के अनुरोधों के लिए नहीं बताया जाना चाहिए. अगर तारीख की कोई सीमा नहीं दी गई है, तो तारीख की डिफ़ॉल्ट सीमा होगी (startDate: मौजूदा तारीख - सात दिन, खत्म होने की तारीख: मौजूदा तारीख - एक दिन). batchGet तरीके में हर ReportRequest में एक ही dateRanges परिभाषा होनी चाहिए.

samplingLevel

enum(Sampling)

पसंदीदा रिपोर्ट का सैंपल साइज़. अगर samplingLevel फ़ील्ड की जानकारी नहीं दी गई है, तो DEFAULT के सैंपल लेवल का इस्तेमाल किया जाता है. batchGet तरीके में हर ReportRequest में एक ही samplingLevel परिभाषा होनी चाहिए. ज़्यादा जानकारी के लिए डेवलपर गाइड देखें.

dimensions[]

object(Dimension)

अनुरोध किए गए डाइमेंशन. अनुरोध में कुल नौ डाइमेंशन हो सकते हैं.

dimensionFilterClauses[]

object(DimensionFilterClause)

डाइमेंशन वैल्यू को फ़िल्टर करने के लिए, डाइमेंशन फ़िल्टर क्लॉज़. ये लॉजिकल तरीके से AND ऑपरेटर के साथ जोड़े जाते हैं. ध्यान दें कि किसी भी डाइमेंशन को एग्रीगेट करने से पहले फ़िल्टर किया जाता है, ताकि दिखाई गई मेट्रिक सिर्फ़ काम के डाइमेंशन की कुल वैल्यू दिखा सकें.

metrics[]

object(Metric)

अनुरोध की गई मेट्रिक. अनुरोधों में कम से कम एक मेट्रिक का ज़िक्र होना चाहिए. अनुरोध में कुल 10 मेट्रिक हो सकती हैं.

metricFilterClauses[]

object(MetricFilterClause)

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

filtersExpression

string

डाइमेंशन या मेट्रिक फ़िल्टर, जो आपके अनुरोध के लिए लौटाए गए डेटा को सीमित करते हैं. filtersExpression का इस्तेमाल करने के लिए, पहले वह डाइमेंशन या मेट्रिक डालें जिसे फ़िल्टर करना है. इसके बाद, फ़िल्टर एक्सप्रेशन का इस्तेमाल करें. उदाहरण के लिए, यहां दिया गया एक्सप्रेशन, Firefox से शुरू होने वाले ga:browser डाइमेंशन को चुनता है; ga:browser=~^Firefox. डाइमेंशन और मेट्रिक फ़िल्टर के बारे में ज़्यादा जानकारी के लिए, फ़िल्टर का रेफ़रंस लेख पढ़ें.

orderBys[]

object(OrderBy)

आउटपुट पंक्तियों पर क्रम से लगाएं. दो पंक्तियों की तुलना करने के लिए, नीचे दिए गए एलिमेंट को क्रम से तब तक लागू किया जाता है, जब तक कि कोई अंतर नहीं मिलता. आउटपुट में मौजूद तारीख की सभी सीमाओं के लिए, लाइन का क्रम एक जैसा होता है.

segments[]

object(Segment)

अनुरोध करने पर मिले डेटा को सेगमेंट में बांटना. सेगमेंट डेफ़िनिशन की मदद से, सेगमेंट अनुरोध के सबसेट को देखा जा सकता है. एक अनुरोध में ज़्यादा से ज़्यादा चार सेगमेंट हो सकते हैं. batchGet तरीके में हर ReportRequest में एक ही segments परिभाषा होनी चाहिए. सेगमेंट वाले अनुरोधों में ga:segment डाइमेंशन होना ज़रूरी है.

pivots[]

object(Pivot)

पिवट परिभाषाएं. अनुरोधों में ज़्यादा से ज़्यादा दो पिवट हो सकते हैं.

cohortGroup

object(CohortGroup)

इस अनुरोध से जुड़ा, एक जैसे उपयोगकर्ताओं का ग्रुप. अगर अनुरोध में कोई कोहॉर्ट ग्रुप मौजूद है, तो ga:cohort डाइमेंशन मौजूद होना चाहिए. batchGet तरीके में हर ReportRequest में एक ही cohortGroup परिभाषा होनी चाहिए.

pageToken

string

नतीजों का अगला पेज पाने के लिए कंटिन्यूशन टोकन. इसे अनुरोध में जोड़ने पर pageToken के बाद वाली लाइनें दिखेंगी. pageToken, report.batchGet अनुरोध के जवाब के तौर पर दी गई वैल्यू, NextPageToken पैरामीटर में होना चाहिए.

pageSize

number

पेज का साइज़, पेजिंग के लिए होता है और इससे तय होता है कि ज़्यादा से ज़्यादा कितनी लाइनें दिखाई जा सकती हैं. पेज का साइज़ >= 0 होना चाहिए. क्वेरी में डिफ़ॉल्ट रूप से 1,000 लाइनें दिखती हैं. Analytics Core Reporting API हर अनुरोध के लिए ज़्यादा से ज़्यादा 1,00,000 लाइनें दिखाता है, चाहे आपने कितनी भी लाइनें मांगी हों. अगर आपकी उम्मीद के मुताबिक डाइमेंशन सेगमेंट नहीं हैं, तो हो सकता है कि नतीजे अनुरोध की तुलना में कम लाइनें दिखें. उदाहरण के लिए, ga:country के लिए 300 से कम वैल्यू हो सकती हैं. इसलिए, सिर्फ़ देश के हिसाब से सेगमेंट करने पर, आपको 300 से ज़्यादा लाइनें नहीं मिल सकतीं. भले ही, pageSize को ज़्यादा वैल्यू पर सेट किया गया हो.

includeEmptyRows

boolean

अगर 'गलत है' पर सेट किया जाता है, तो हासिल की गई सभी मेट्रिक की वैल्यू शून्य होने पर, जवाब में लाइनें शामिल नहीं होंगी. डिफ़ॉल्ट 'गलत' पर सेट होता है, जिससे ये लाइनें शामिल नहीं होती हैं.

hideTotals

boolean

अगर नीति को 'सही है' पर सेट किया जाता है, तो तारीख की हर सीमा के लिए, मैच होने वाली सभी लाइनों की सभी मेट्रिक का कुल डेटा छिप जाता है. डिफ़ॉल्ट 'गलत' पर सेट होती है और कुल वैल्यू दिखाता है.

hideValueRanges

boolean

अगर वैल्यू को 'सही है' पर सेट किया जाता है, तो मैच करने वाली सभी पंक्तियों के लिए, कम से कम और ज़्यादा से ज़्यादा वैल्यू को छिपा देता है. डिफ़ॉल्ट तौर पर, 'गलत' पर सेट होता है और वैल्यू की रेंज दिखाई जाती हैं.

सैंपलिंग

सैंपलिंग लेवल के लिए वैल्यू.

Enums
SAMPLING_UNSPECIFIED अगर samplingLevel फ़ील्ड की जानकारी नहीं दी गई है, तो DEFAULT के सैंपल लेवल का इस्तेमाल किया जाता है.
DEFAULT जवाब के तौर पर नमूने के साइज़ के साथ, जो रफ़्तार और सटीक जवाब देता है.
SMALL यह छोटे साइज़ के सैंपल के साथ तेज़ी से रिस्पॉन्स देता है.
LARGE यह फ़ंक्शन बड़े सैंपल साइज़ का इस्तेमाल करके, ज़्यादा सटीक जवाब देता है. हालांकि, इस वजह से जवाब मिलने में ज़्यादा समय लग सकता है.

डाइमेंशन

डाइमेंशन आपके डेटा के एट्रिब्यूट होते हैं. उदाहरण के लिए, ga:city डाइमेंशन से यह जानकारी मिलती है कि सेशन किस जगह से शुरू हुआ है, जैसे कि "पेरिस" से या "न्यूयॉर्क" से.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
फ़ील्ड
name

string

फ़ेच किए जाने वाले डाइमेंशन का नाम, जैसे कि ga:browser.

histogramBuckets[]

string (int64 format)

अगर फ़ील्ड खाली नहीं है, तो हम डाइमेंशन वैल्यू को स्ट्रिंग के बाद int64 की मदद से बकेट में रखते हैं. जो डाइमेंशन वैल्यू, इंटिग्रल वैल्यू को स्ट्रिंग के तौर पर नहीं दिखा सकतीं, उन्हें शून्य में बदल दिया जाएगा. बकेट की वैल्यू बढ़ते क्रम में होनी चाहिए. हर बकेट को निचले हिस्से पर बंद किया जाता है और ऊपर वाले हिस्से पर खोला जाता है. "पहली" बकेट में पहली सीमा से कम के सभी मान शामिल होते हैं, "अंतिम" बकेट में अनंत तक सभी मान शामिल होते हैं. बकेट में आने वाली डाइमेंशन वैल्यू, नई डाइमेंशन वैल्यू में बदल जाती हैं. उदाहरण के लिए, अगर कोई "0, 1, 3, 4, 7" की सूची देता है, तो हम इन बकेट को दिखाते हैं:

  • बकेट #1: वैल्यू < 0, डाइमेंशन वैल्यू "<0"
  • बकेट #2: [0,1 में वैल्यू), डाइमेंशन वैल्यू "0"
  • बकेट #3: [1,3 में वैल्यू), डाइमेंशन वैल्यू "1-2"
  • बकेट #4: [3,4 में वैल्यू), डाइमेंशन वैल्यू "3"
  • बकेट #5: [4,7 में वैल्यू), डाइमेंशन वैल्यू "4-6"
  • बकेट #6: वैल्यू >= 7, डाइमेंशन वैल्यू "7+"

ध्यान दें: अगर किसी डाइमेंशन पर हिस्टोग्राम म्यूटेशन लागू किया जा रहा है और उस डाइमेंशन का इस्तेमाल क्रम से किया जा रहा है, तो इसके लिए आपको क्रम से लगाने के लिए HISTOGRAM_BUCKET टाइप का इस्तेमाल करना होगा. ऐसा न करने पर, डाइमेंशन वैल्यू को डिक्शनरी (लेक्सिकोग्राफ़िक) के क्रम के हिसाब से क्रम में लगाया जाएगा. उदाहरण के लिए, बढ़ते क्रम में शब्दकोश का क्रम यह है:

"<50", "1001+", "121-1000", "50-120"

और बढ़ते हुए क्रम में HISTOGRAM_BUCKET का क्रम है:

"<50", "50 से 120", "121-1000", "1001 से ज़्यादा"

क्लाइंट को हिस्टोग्राम में बदलाव किए गए डाइमेंशन के लिए, "orderType": "HISTOGRAM_BUCKET" का साफ़ तौर पर अनुरोध करना होगा.

DimensionFilterClause

डाइमेंशन फ़िल्टर का ग्रुप. फ़िल्टर को लॉजिकल रूप से जोड़ने का तरीका बताने के लिए, ऑपरेटर की वैल्यू सेट करें.

जेएसओएन के काेड में दिखाना 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
फ़ील्ड
operator

enum(FilterLogicalOperator)

एक से ज़्यादा डाइमेंशन फ़िल्टर को जोड़ने के लिए ऑपरेटर. अगर इसके बारे में नहीं बताया गया है, तो इसे OR माना जाता है.

filters[]

object(DimensionFilter)

फ़िल्टर का दोहराया गया सेट. ये तय किए गए ऑपरेटर के आधार पर, लॉजिकल तरीके से जोड़े जाते हैं.

FilterLogicalOperator

फ़िल्टर कैसे लॉजिकल तरीके से जोड़े जाते हैं.

Enums
OPERATOR_UNSPECIFIED ऑपरेटर की जानकारी नहीं है. इसे OR माना जाता है.
OR लॉजिकल OR ऑपरेटर.
AND लॉजिकल AND ऑपरेटर.

DimensionFilter

डाइमेंशन फ़िल्टर, किसी डाइमेंशन पर फ़िल्टर करने के विकल्प तय करता है.

जेएसओएन के काेड में दिखाना 
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
फ़ील्ड
dimensionName

string

जिस डाइमेंशन के हिसाब से फ़िल्टर करना है. आयाम फ़िल्टर में एक आयाम शामिल होना चाहिए.

not

boolean

लॉजिकल NOT ऑपरेटर. अगर इस बूलियन को 'सही' पर सेट किया जाता है, तो रिपोर्ट में मैच करने वाली डाइमेंशन वैल्यू को शामिल नहीं किया जाएगा. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

operator

enum(Operator)

डाइमेंशन को एक्सप्रेशन से मैच करने का तरीका. डिफ़ॉल्ट REGEXP होता है.

expressions[]

string

स्ट्रिंग या रेगुलर एक्सप्रेशन, जिससे मैच करना है. जब तक ऑपरेटर IN_LIST न हो, तब तक सूची की सिर्फ़ पहली वैल्यू का इस्तेमाल तुलना के लिए किया जाता है. अगर IN_LIST ऑपरेटर, तो पूरी सूची का इस्तेमाल डाइमेंशन को फ़िल्टर करने के लिए किया जाता है. इसके बारे में, IN_LIST ऑपरेटर के ब्यौरे में बताया गया है.

caseSensitive

boolean

क्या मैच केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होना चाहिए? डिफ़ॉल्ट रूप से गलत पर सेट होती है.

ऑपरेटर

अलग-अलग मैच टाइप इस्तेमाल किए जा सकते हैं.

Enums
OPERATOR_UNSPECIFIED अगर मैच टाइप की जानकारी नहीं दी जाती है, तो उसे REGEXP माना जाता है.
REGEXP मैच एक्सप्रेशन को रेगुलर एक्सप्रेशन के तौर पर माना जाता है. सभी मैच टाइप को रेगुलर एक्सप्रेशन नहीं माना जाता.
BEGINS_WITH दिए गए मैच एक्सप्रेशन से शुरू होने वाली वैल्यू से मैच करता है.
ENDS_WITH दिए गए मैच एक्सप्रेशन से खत्म होने वाली वैल्यू से मैच करता है.
PARTIAL सबस्ट्रिंग का मिलान हुआ.
EXACT वैल्यू, मैच एक्सप्रेशन से पूरी तरह मैच होनी चाहिए.
NUMERIC_EQUAL

पूर्णांक तुलना फ़िल्टर. इनके लिए केस संवेदनशीलता पर ध्यान नहीं दिया जाता है और एक्सप्रेशन को पूर्णांक को दिखाने वाली स्ट्रिंग माना जाता है. असफलता की शर्तें:

  • अगर एक्सप्रेशन मान्य int64 नहीं है, तो क्लाइंट को गड़बड़ी दिख सकती है.
  • जो इनपुट डाइमेंशन मान्य int64 वैल्यू नहीं हैं वे कभी भी फ़िल्टर से मैच नहीं करेंगे.
NUMERIC_GREATER_THAN यह जांच करता है कि डाइमेंशन, मैच एक्सप्रेशन से संख्या में ज़्यादा है या नहीं. पाबंदियों के बारे में जानने के लिए, NUMERIC_EQUALS से जुड़ी जानकारी पढ़ें.
NUMERIC_LESS_THAN यह जांच करता है कि डाइमेंशन, मैच एक्सप्रेशन से संख्या के हिसाब से कम है या नहीं. पाबंदियों के बारे में जानने के लिए, NUMERIC_EQUALS से जुड़ी जानकारी पढ़ें.
IN_LIST

इस विकल्प का इस्तेमाल उस डाइमेंशन फ़िल्टर को तय करने के लिए किया जाता है जिसका एक्सप्रेशन, वैल्यू की चुनी गई सूची से कोई भी वैल्यू ले सकता हो. इससे एग्ज़ैक्ट मैच वाले ऐसे कई डाइमेंशन फ़िल्टर का आकलन करने से बचा जा सकता है जो जवाब वाली हर लाइन के लिए OR लगाए जाते हैं. उदाहरण के लिए:

expressions: ["A", "B", "C"]

जवाब वाली ऐसी कोई भी पंक्ति जिसके डाइमेंशन की वैल्यू A, B या C है, इस डाइमेंशन फ़िल्टर से मैच करती है.

मेट्रिक

मेट्रिक, संख्यात्मक माप होती हैं. उदाहरण के लिए, ga:users मेट्रिक, अनुरोध की गई समयावधि के लिए उपयोगकर्ताओं की कुल संख्या दिखाती है.

जेएसओएन के काेड में दिखाना 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
फ़ील्ड
expression

string

अनुरोध में मौजूद मेट्रिक एक्सप्रेशन. एक्सप्रेशन एक या ज़्यादा मेट्रिक और संख्याओं से बनाया जाता है. स्वीकार किए जाने वाले ऑपरेटर में ये शामिल हैं: प्लस (+), माइनस (-), नेगेशन (यूनरी -), से भाग दिया गया (/), से गुणा किया गया (*), ब्रैकेट, पॉज़िटिव कार्डनल नंबर (0-9), में दशमलव शामिल हो सकते हैं और इसमें ज़्यादा से ज़्यादा 1024 वर्ण हो सकते हैं. ga:totalRefunds/ga:users का उदाहरण, ज़्यादातर मामलों में मेट्रिक एक्सप्रेशन, मेट्रिक का सिर्फ़ एक नाम होता है, जैसे कि ga:users. मिला-जुला MetricType जोड़ा जा रहा है (जैसे, CURRENCY + PERCENTAGE) मेट्रिक से अनचाहे नतीजे मिलेंगे.

alias

string

मेट्रिक एक्सप्रेशन के लिए उपनाम, एक्सप्रेशन का वैकल्पिक नाम होता है. उपनाम का इस्तेमाल फ़िल्टर करने और क्रम से लगाने के लिए किया जा सकता है. यह फ़ील्ड ज़रूरी नहीं है. अगर एक्सप्रेशन सिर्फ़ एक मेट्रिक न हो, लेकिन एक जटिल एक्सप्रेशन हो, जिसका इस्तेमाल फ़िल्टर करने और क्रम से लगाने में नहीं किया जा सकता, तो यह फ़ील्ड ज़रूरी नहीं है. उपनाम का इस्तेमाल जवाब वाले कॉलम के हेडर में भी किया जाता है.

formattingType

enum(MetricType)

इससे तय होता है कि मेट्रिक एक्सप्रेशन को कैसे फ़ॉर्मैट किया जाना चाहिए, उदाहरण के लिए, INTEGER.

MetricType

मेट्रिक के टाइप.

Enums
METRIC_TYPE_UNSPECIFIED मेट्रिक के टाइप की जानकारी नहीं दी गई है.
INTEGER पूर्णांक मेट्रिक.
FLOAT फ़्लोट मेट्रिक.
CURRENCY मुद्रा की मेट्रिक.
PERCENT प्रतिशत मेट्रिक.
TIME HH:MM:SS फ़ॉर्मैट में समय मेट्रिक.

MetricFilterClause

मेट्रिक फ़िल्टर के ग्रुप के बारे में बताता है. फ़िल्टर को लॉजिकल रूप से जोड़ने का तरीका बताने के लिए, ऑपरेटर की वैल्यू सेट करें.

जेएसओएन के काेड में दिखाना 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
फ़ील्ड
operator

enum(FilterLogicalOperator)

एक से ज़्यादा मेट्रिक फ़िल्टर को जोड़ने का ऑपरेटर. अगर इसके बारे में नहीं बताया गया है, तो इसे OR माना जाता है.

filters[]

object(MetricFilter)

फ़िल्टर का दोहराया गया सेट. ये तय किए गए ऑपरेटर के आधार पर, लॉजिकल तरीके से जोड़े जाते हैं.

MetricFilter

मेट्रिकफ़िल्टर, मेट्रिक पर फ़िल्टर तय करता है.

जेएसओएन के काेड में दिखाना 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
फ़ील्ड
metricName

string

वह मेट्रिक जिस पर फ़िल्टर किया जाएगा. मेट्रिकफ़िल्टर में मेट्रिक का नाम होना चाहिए. मेट्रिक के नाम को पहले मेट्रिक के तौर पर परिभाषित किया जा सकता है या यह एक मेट्रिक एक्सप्रेशन भी हो सकता है.

not

boolean

लॉजिकल NOT ऑपरेटर. अगर इस बूलियन को 'सही है' पर सेट किया जाता है, तो रिपोर्ट में, मैच करने वाली मेट्रिक की वैल्यू को शामिल नहीं किया जाएगा. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

operator

enum(Operator)

क्या मेट्रिक EQUAL, LESS_THAN या GREATER_THAN ComparisonValue है, डिफ़ॉल्ट तौर पर यह EQUAL पर सेट होती है. अगर ऑपरेटर IS_MISSING है, तो यह जांच करता है कि मेट्रिक मौजूद नहीं है या नहीं. वह ComparisonValue को अनदेखा कर देगा.

comparisonValue

string

वह वैल्यू जिसकी तुलना करनी है.

ऑपरेटर

तुलना के अलग-अलग टाइप के विकल्प.

Enums
OPERATOR_UNSPECIFIED अगर ऑपरेटर की जानकारी नहीं दी गई है, तो उसे EQUAL माना जाता है.
EQUAL मेट्रिक की वैल्यू, कंपैरिज़न वैल्यू के बिलकुल बराबर होनी चाहिए.
LESS_THAN मेट्रिक की वैल्यू, कंपैरिज़न वैल्यू से कम होनी चाहिए.
GREATER_THAN मेट्रिक की वैल्यू, कंपैरिज़न वैल्यू से ज़्यादा होनी चाहिए.
IS_MISSING मेट्रिक मौजूद न होने पर पुष्टि करता है. ComparisonValue को ध्यान में नहीं रखा जाता है.

OrderBy

क्रम से लगाने के विकल्पों के बारे में बताता है.

जेएसओएन के काेड में दिखाना 
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
फ़ील्ड
fieldName

string

वह फ़ील्ड जिसके हिसाब से क्रम में लगाना है. क्रम से लगाने का डिफ़ॉल्ट क्रम बढ़ते क्रम में है. उदाहरण: ga:browser. ध्यान दें, यहां क्रम से लगाने के लिए सिर्फ़ एक फ़ील्ड चुना जा सकता है. उदाहरण के लिए, ga:browser, ga:city मान्य नहीं है.

orderType

enum(OrderType)

ऑर्डर किस तरह का है. डिफ़ॉल्ट ऑर्डर टाइप VALUE है.

sortOrder

enum(SortOrder)

फ़ील्ड को क्रम से लगाने का ऑर्डर.

OrderType

OrderType यह कंट्रोल करता है कि क्रम से लगाने का ऑर्डर कैसे तय किया जा रहा है.

Enums
ORDER_TYPE_UNSPECIFIED तय नहीं किए गए ऑर्डर टाइप को, वैल्यू के आधार पर क्रम से लगाने के तौर पर माना जाएगा.
VALUE क्रम से लगाने का क्रम, चुने गए कॉलम की वैल्यू के आधार पर तय होता है. इसमें तारीख की सिर्फ़ पहली सीमा पर ध्यान दिया जाता है.
DELTA क्रम से लगाने का क्रम, चुने गए कॉलम की पहली दो तारीख की सीमाओं के बीच की वैल्यू के अंतर पर आधारित होता है. सिर्फ़ दो तारीख की सीमाएं होने पर ही इस्तेमाल किया जा सकता है.
SMART क्रम से लगाने का क्रम, चुने गए कॉलम की अहमियत के हिसाब से तय होता है. अगर कॉलम में n/d फ़ॉर्मैट है, तो इस अनुपात की वेट वैल्यू (n + totals.n)/(d + totals.d) होगी. इसका इस्तेमाल सिर्फ़ उन मेट्रिक के लिए किया जा सकेगा जो रेशियो दिखाती हैं.
HISTOGRAM_BUCKET हिस्टोग्राम क्रम प्रकार केवल गैर-खाली हिस्टोग्राम-बकेट वाले आयाम कॉलम पर लागू होता है.
DIMENSION_AS_INTEGER अगर डाइमेंशन तय लंबाई की संख्याएं हैं, तो सामान्य सॉर्ट सही तरीके से काम करेगा. DIMENSION_AS_INTEGER का इस्तेमाल तब किया जा सकता है, जब डाइमेंशन वैरिएबल की लंबाई वाली संख्याएं हों.

SortOrder

क्रम से लगाने का क्रम.

Enums
SORT_ORDER_UNSPECIFIED अगर क्रम से लगाने का क्रम तय नहीं किया गया है, तो डिफ़ॉल्ट वैल्यू बढ़ते क्रम में होगी.
ASCENDING बढ़ते क्रम में लगाएं. फ़ील्ड को बढ़ते क्रम में लगाया जाएगा.
DESCENDING घटते क्रम में लगाएं. फ़ील्ड को घटते क्रम में लगाया जाएगा.

सेगमेंट करें

सेगमेंट की परिभाषा, अगर रिपोर्ट को सेगमेंट में बांटना है. सेगमेंट, Analytics डेटा का सबसेट होता है. उदाहरण के लिए, हो सकता है कि उपयोगकर्ताओं के पूरे ग्रुप में से उन उपयोगकर्ताओं का एक सेगमेंट बनाया जाए जो किसी खास देश या शहर में रहते हैं.

जेएसओएन के काेड में दिखाना 
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
फ़ील्ड
यूनियन फ़ील्ड dynamicOrById. डाइनैमिक सेगमेंट का इस्तेमाल करके या बिल्ट-इन या कस्टम सेगमेंट का आईडी इस्तेमाल करके, सेगमेंट को डाइनैमिक तौर पर तय किया जा सकता है. dynamicOrById इनमें से सिर्फ़ एक हो सकती है:
dynamicSegment

object(DynamicSegment)

अनुरोध में मौजूद डाइनैमिक सेगमेंट की परिभाषा.

segmentId

string

पहले से मौजूद किसी सेगमेंट का सेगमेंट आईडी या कस्टम सेगमेंट, जैसे कि gaid::-3.

DynamicSegment

अनुरोध में मौजूद सेगमेंट की जानकारी देने के लिए, डाइनैमिक सेगमेंट की परिभाषा. सेगमेंट में उपयोगकर्ता, सेशन या दोनों को चुना जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
फ़ील्ड
name

string

डाइनैमिक सेगमेंट का नाम.

userSegment

object(SegmentDefinition)

उपयोगकर्ताओं को सेगमेंट में शामिल करने के लिए, उपयोगकर्ता सेगमेंट.

sessionSegment

object(SegmentDefinition)

सेगमेंट में शामिल करने के लिए सेशन चुनने के लिए, सेशन सेगमेंट.

SegmentDefinition

सेगमेंट परिभाषा, सेगमेंट को सेगमेंट फ़िल्टर का एक सेट मानती है. ये ऐसे सेगमेंट होते हैं जो लॉजिकल AND ऑपरेशन के साथ जुड़े होते हैं.

जेएसओएन के काेड में दिखाना 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
फ़ील्ड
segmentFilters[]

object(SegmentFilter)

सेगमेंट को, सेगमेंट फ़िल्टर के सेट से तय किया जाता है. ये फ़िल्टर, लॉजिकल AND ऑपरेशन के साथ जोड़े जाते हैं.

SegmentFilter

सेगमेंट फ़िल्टर, सेगमेंट को या तो सामान्य या क्रम वाले सेगमेंट के तौर पर तय करता है. सेगमेंट की एक सामान्य शर्त में, सेशन या उपयोगकर्ताओं को चुनने के लिए डाइमेंशन और मेट्रिक की शर्तें होती हैं. क्रम सेगमेंट की शर्त का इस्तेमाल, क्रम में चलने वाली शर्तों के आधार पर उपयोगकर्ताओं या सेशन को चुनने के लिए किया जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
फ़ील्ड
not

boolean

अगर सही है, तो आसान या क्रम वाले सेगमेंट के कॉम्प्लिमेंट से मैच करें. उदाहरण के लिए, "न्यूयॉर्क" से नहीं की गई सभी विज़िट से मिलान करने के लिए, हम सेगमेंट को इस प्रकार परिभाषित कर सकते हैं:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

यूनियन फ़ील्ड simpleOrSequence. क्या यह कोई आसान सेगमेंट है या क्रम वाले सेगमेंट की परिभाषा. simpleOrSequence इनमें से सिर्फ़ एक हो सकती है:
simpleSegment

object(SimpleSegment)

सेगमेंट की सामान्य शर्तों में एक या उससे ज़्यादा डाइमेंशन/मेट्रिक की शर्तें होती हैं, जिन्हें जोड़ा जा सकता है

sequenceSegment

object(SequenceSegment)

क्रम की शर्तों में एक या ज़्यादा चरण होते हैं. इसके हर चरण को एक या उससे ज़्यादा डाइमेंशन/मेट्रिक की शर्तों के हिसाब से तय किया जाता है. कई चरणों को खास क्रम ऑपरेटर के साथ जोड़ा जा सकता है.

SimpleSegment

सेगमेंट की आसान शर्तों में एक या उससे ज़्यादा डाइमेंशन/मेट्रिक की शर्तें होती हैं, जिन्हें जोड़ा जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
फ़ील्ड
orFiltersForSegment[]

object(OrFiltersForSegment)

लॉजिकल AND ऑपरेटर के साथ जुड़े सेगमेंट फ़िल्टर ग्रुप की सूची.

OrFiltersForSegment

OR ग्रुप में मौजूद सेगमेंट फ़िल्टर की सूची, लॉजिकल OR ऑपरेटर के साथ जोड़ दी जाती है.

जेएसओएन के काेड में दिखाना 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
फ़ील्ड
segmentFilterClauses[]

object(SegmentFilterClause)

OR ऑपरेटर के साथ जोड़े जाने वाले सेगमेंट फ़िल्टर की सूची.

SegmentFilterClause

फ़िल्टर के उपनियम का इस्तेमाल सेगमेंट की परिभाषा में किया जा सकता है. इसे किसी मेट्रिक या डाइमेंशन फ़िल्टर को मिटाया जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
फ़ील्ड
not

boolean

फ़िल्टर के पूरक (!) से मेल खाता है.

यूनियन फ़ील्ड dimensionOrMetricFilter. डाइमेंशन या मेट्रिक फ़िल्टर. dimensionOrMetricFilter इनमें से सिर्फ़ एक हो सकती है:
dimensionFilter

object(SegmentDimensionFilter)

सेगमेंट की परिभाषा के लिए डाइमेंशन फ़िल्टर.

metricFilter

object(SegmentMetricFilter)

सेगमेंट की परिभाषा के लिए मेट्रिक फ़िल्टर.

SegmentDimensionFilter

डाइमेंशन फ़िल्टर, किसी डाइमेंशन पर फ़िल्टर करने के विकल्प तय करता है.

जेएसओएन के काेड में दिखाना 
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
फ़ील्ड
dimensionName

string

उस डाइमेंशन का नाम जिसके लिए फ़िल्टर लागू किया जा रहा है.

operator

enum(Operator)

डाइमेंशन से मैच करने के लिए इस्तेमाल होने वाला ऑपरेटर.

caseSensitive

boolean

मैच केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होना चाहिए, लेकिन IN_LIST ऑपरेटर के लिए इसे अनदेखा कर दिया जाता है.

expressions[]

string

एक्सप्रेशन की सूची. इसमें सभी ऑपरेटर के लिए सिर्फ़ पहला एलिमेंट इस्तेमाल किया जाता है

minComparisonValue

string

BETWEEN मैच टाइप के लिए, तुलना के लिए कम से कम वैल्यू.

maxComparisonValue

string

BETWEEN मैच टाइप के लिए, तुलना करने के लिए ज़्यादा से ज़्यादा वैल्यू.

ऑपरेटर

अलग-अलग मैच टाइप इस्तेमाल किए जा सकते हैं.

Enums
OPERATOR_UNSPECIFIED अगर मैच टाइप की जानकारी नहीं दी गई है, तो इसे REGEXP के तौर पर माना जाता है.
REGEXP मैच एक्सप्रेशन को रेगुलर एक्सप्रेशन के तौर पर माना जाता है. अन्य सभी मैच टाइप को रेगुलर एक्सप्रेशन नहीं माना जाता.
BEGINS_WITH दिए गए मैच एक्सप्रेशन से शुरू होने वाली वैल्यू से मैच करता है.
ENDS_WITH दिए गए मैच एक्सप्रेशन से खत्म होने वाली वैल्यू से मैच करता है.
PARTIAL सबस्ट्रिंग का मिलान हुआ.
EXACT वैल्यू, मैच एक्सप्रेशन से पूरी तरह मैच होनी चाहिए.
IN_LIST

इस विकल्प का इस्तेमाल उस डाइमेंशन फ़िल्टर को तय करने के लिए किया जाता है जिसका एक्सप्रेशन, वैल्यू की चुनी गई सूची से कोई भी वैल्यू ले सकता हो. इससे एग्ज़ैक्ट मैच वाले ऐसे कई डाइमेंशन फ़िल्टर का आकलन करने से बचा जा सकता है जो जवाब वाली हर लाइन के लिए OR लगाए जाते हैं. उदाहरण के लिए:

expressions: ["A", "B", "C"]

जवाब वाली ऐसी कोई भी पंक्ति जिसके डाइमेंशन की वैल्यू A, B या C है, इस डाइमेंशन फ़िल्टर से मैच करती है.
NUMERIC_LESS_THAN

पूर्णांक तुलना फ़िल्टर. इनके लिए केस संवेदनशीलता पर ध्यान नहीं दिया जाता है और एक्सप्रेशन को पूर्णांक को दिखाने वाली स्ट्रिंग माना जाता है. असफलता की शर्तें:

  • अगर एक्सप्रेशन मान्य int64 नहीं है, तो क्लाइंट को गड़बड़ी दिख सकती है.
  • ऐसे इनपुट डाइमेंशन जो मान्य int64 वैल्यू नहीं हैं वे कभी भी फ़िल्टर से मैच नहीं करेंगे.

यह जांच करता है कि डाइमेंशन, मैच एक्सप्रेशन से संख्या के हिसाब से कम है या नहीं.
NUMERIC_GREATER_THAN यह जांच करता है कि डाइमेंशन, मैच एक्सप्रेशन से संख्या में ज़्यादा है या नहीं.
NUMERIC_BETWEEN यह जांच करता है कि डाइमेंशन, मैच एक्सप्रेशन के कम से कम और ज़्यादा से ज़्यादा, बाहर रखी गई सीमाओं के बीच अंकों में है या नहीं.

SegmentMetricFilter

सेगमेंट फ़िल्टर क्लॉज़ में इस्तेमाल किया जाने वाला मेट्रिक फ़िल्टर.

जेएसओएन के काेड में दिखाना 
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
फ़ील्ड
scope

enum(Scope)

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

metricName

string

वह मेट्रिक जिस पर फ़िल्टर किया जाएगा. metricFilter में मेट्रिक का नाम होना चाहिए.

operator

enum(Operator)

मेट्रिक से तुलना करने के लिए की जाने वाली कार्रवाई के बारे में बताता है. डिफ़ॉल्ट वैल्यू EQUAL है.

comparisonValue

string

वह वैल्यू जिसकी तुलना करनी है. अगर ऑपरेटर BETWEEN है, तो इस वैल्यू को कंपैरिज़न वैल्यू के तौर पर माना जाता है.

maxComparisonValue

string

तुलना की ज़्यादा से ज़्यादा वैल्यू का इस्तेमाल, सिर्फ़ BETWEEN ऑपरेटर के लिए किया जाता है.

स्कोप

मेट्रिक का स्कोप वह लेवल तय करता है जिस पर मेट्रिक तय की जाती है - PRODUCT, HIT, SESSION या USER. मेट्रिक वैल्यू को, उसके मुख्य स्कोप से बड़े दायरे में भी रिपोर्ट किया जा सकता है. उदाहरण, ga:pageviews और ga:transactions को SESSION और USER लेवल पर रिपोर्ट किया जा सकता है. इसके लिए, उन्हें सिर्फ़ उन सेशन में होने वाले या हर उपयोगकर्ता के हर हिट के लिए जोड़ना होगा.

Enums
UNSPECIFIED_SCOPE अगर स्कोप की जानकारी नहीं दी गई है, तो यह शर्त के स्कोप, USER या SESSION पर डिफ़ॉल्ट रूप से लागू हो जाता है. यह इस बात पर निर्भर करता है कि सेगमेंट, उपयोगकर्ताओं या सेशन को चुनने की कोशिश कर रहा है या नहीं.
PRODUCT प्रॉडक्ट का स्कोप.
HIT हिट का दायरा.
SESSION सेशन का स्कोप.
USER उपयोगकर्ता का स्कोप.

ऑपरेटर

तुलना के अलग-अलग टाइप के विकल्प.

Enums
UNSPECIFIED_OPERATOR जिस ऑपरेटर के बारे में जानकारी नहीं दी गई है उसे LESS_THAN ऑपरेटर माना जाता है.
LESS_THAN जांच करता है कि मेट्रिक वैल्यू, कंपैरिज़न वैल्यू से कम है या नहीं.
GREATER_THAN जांच करता है कि मेट्रिक वैल्यू, तुलना के वैल्यू से ज़्यादा है या नहीं.
EQUAL बराबर ऑपरेटर.
BETWEEN ऑपरेटर के बीच, कम से कम और ज़्यादा से ज़्यादा वैल्यू, दोनों शामिल नहीं होती हैं. हम तुलना के लिए LT और GT का इस्तेमाल करेंगे.

SequenceSegment

क्रम की शर्तों में एक या ज़्यादा चरण होते हैं. इसके हर चरण को एक या उससे ज़्यादा डाइमेंशन/मेट्रिक की शर्तों के हिसाब से तय किया जाता है. कई चरणों को खास क्रम ऑपरेटर के साथ जोड़ा जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
फ़ील्ड
segmentSequenceSteps[]

object(SegmentSequenceStep)

क्रम में चरणों की सूची.

firstStepShouldMatchFirstHit

boolean

अगर यह शर्त सेट की जाती है, तो पहले चरण की शर्त, वेबसाइट पर आने वाले व्यक्ति के पहले हिट (तारीख की सीमा में) से मैच होनी चाहिए.

SegmentSequenceStep

सेगमेंट के क्रम की परिभाषा.

जेएसओएन के काेड में दिखाना 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
फ़ील्ड
orFiltersForSegment[]

object(OrFiltersForSegment)

क्रम को, ग्रुप किए गए या AND ऑपरेटर के साथ जोड़े गए फ़िल्टर की सूची के साथ दिखाया जाता है.

matchType

enum(MatchType)

इससे पता चलता है कि क्या चरण अगले चरण से ठीक पहले आता है या इससे पहले का कोई भी समय हो सकता है.

MatchType

क्रम के लिए मैच टाइप.

Enums
UNSPECIFIED_MATCH_TYPE अनिर्दिष्ट मिलान प्रकार को पूर्ववर्ती माना जाता है.
PRECEDES ऑपरेटर बताता है कि पिछला चरण अगले चरण से पहले आता है.
IMMEDIATELY_PRECEDES ऑपरेटर से पता चलता है कि पिछला चरण, अगले चरण से ठीक पहले आता है.

पिवट

पिवट, अनुरोध में पिवट सेक्शन के बारे में बताता है. पिवट की मदद से, कुछ रिपोर्ट के लिए टेबल में मौजूद जानकारी को फिर से व्यवस्थित किया जा सकता है. इसके लिए, आपके डेटा को दूसरे डाइमेंशन में पिवट किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
फ़ील्ड
dimensions[]

object(Dimension)

पिवट कॉलम के तौर पर दिखने वाले डाइमेंशन की सूची. किसी पिवट में ज़्यादा से ज़्यादा चार डाइमेंशन हो सकते हैं. पिवट डाइमेंशन, अनुरोध में इस्तेमाल किए जा सकने वाले डाइमेंशन की कुल संख्या पर लगी पाबंदी का हिस्सा होते हैं.

dimensionFilterClauses[]

object(DimensionFilterClause)

आयाम फ़िल्टर क्लॉज़ को AND ऑपरेटर के साथ सही तरीके से जोड़ा जाता है: सिर्फ़ वही डेटा इस पिवट क्षेत्र की वैल्यू में योगदान करता है जो इन सभी आयामफ़िल्टर क्लॉज़ में शामिल किया गया है. पिवट क्षेत्र में दिखाए जाने वाले कॉलम को सीमित करने के लिए, डाइमेंशन फ़िल्टर का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर पिवट क्षेत्र में डाइमेंशन के तौर पर ga:browser मौजूद है और आपने ga:browser को सिर्फ़ "IE" या "Firefox" तक सीमित करने के लिए कुंजी फ़िल्टर तय किए हैं, तो सिर्फ़ वे दो ब्राउज़र कॉलम के तौर पर दिखेंगे.

metrics[]

object(Metric)

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

startGroup

number

अगर k मेट्रिक का अनुरोध किया गया था, तो जवाब में रिपोर्ट के कॉलम में से कुछ डेटा पर निर्भर कई k कॉलम शामिल होंगे. उदाहरण के लिए, ga:browser डाइमेंशन से पिवट करने पर आपको "Firefox" के लिए k कॉलम, "IE" के लिए k कॉलम, "Chrome" वगैरह के लिए k कॉलम मिलेंगे. कॉलम के ग्रुप का क्रम, पहले k वैल्यू के लिए "कुल" के घटते क्रम में तय किया जाएगा. पहले पिवट डाइमेंशन के लेक्सिकोग्राफ़िक क्रम से टाई को बांटा जाता है, फिर दूसरे पिवट डाइमेंशन के लेक्सिकोग्राफ़िक ऑर्डर से नया सेगमेंट बनाया जाता है. इसी तरह आगे भी. उदाहरण के लिए, अगर Firefox, IE, और Chrome के लिए पहले वैल्यू का कुल योग 8, 2, 8 था, तो कॉलम का क्रम Chrome, Firefox, IE होगा.

नीचे दिए गए विकल्पों से यह चुना जा सकता है कि जवाब में k कॉलम के किन ग्रुप को शामिल किया जाए.
maxGroupCount

number

इससे पता चलता है कि ज़्यादा से ज़्यादा कितने ग्रुप लौटाए जा सकते हैं. डिफ़ॉल्ट वैल्यू 10 है और ज़्यादा से ज़्यादा वैल्यू भी 1,000 है.

CohortGroup

कोहॉर्ट ग्रुप के बारे में बताता है. उदाहरण के लिए:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
जेएसओएन के काेड में दिखाना 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
फ़ील्ड
cohorts[]

object(Cohort)

कोहॉर्ट की परिभाषा.

lifetimeValue

boolean

लाइफ़ टाइम वैल्यू (लाइफ़टाइम वैल्यू) चालू करें. लाइफ़टाइम वैल्यू में, अलग-अलग चैनलों से हासिल किए गए उपयोगकर्ताओं की लाइफ़टाइम वैल्यू मेज़र की जाती है. कृपया देखें: अगर लाइफ़टाइम वैल्यू की वैल्यू गलत है, तो कोहॉर्ट विश्लेषण और लाइफ़टाइम वैल्यू करें:

  • मेट्रिक की वैल्यू, वेब इंटरफ़ेस की कोहॉर्ट रिपोर्ट में दी गई वैल्यू से मिलती-जुलती होती हैं.
  • कोहॉर्ट डेफ़िनिशन की तारीख की सीमाएं, हफ़्ते और महीने के हिसाब से होनी चाहिए. इसका मतलब है कि ga:cohortNthWeek का अनुरोध करते समय, कोहॉर्ट डेफ़िनिशन में startDate की वैल्यू रविवार होनी चाहिए और endDate अगले शनिवार होना चाहिए. ga:cohortNthMonth के लिए, startDate महीने की पहली तारीख और endDate महीने का आखिरी दिन होना चाहिए.

लाइफ़टाइम वैल्यू के सही होने पर:

  • मेट्रिक की वैल्यू, वेब इंटरफ़ेस की LifeTime वैल्यू रिपोर्ट में दी गई वैल्यू के मुताबिक होंगी.
  • लाइफ़टाइम वैल्यू की रिपोर्ट से पता चलता है कि किसी उपयोगकर्ता को हासिल करने के 90 दिनों बाद, उपयोगकर्ता की वैल्यू (रेवेन्यू) और यूज़र ऐक्टिविटी (ऐप्लिकेशन व्यू, लक्ष्य पूरे होने, सेशन, और सेशन की अवधि) में किस तरह बढ़ोतरी हुई.
  • मेट्रिक को समय की बढ़ोतरी के हिसाब से, हर उपयोगकर्ता के कुल औसत के तौर पर कैलकुलेट किया जाता है.
  • समानता रखने वाले लोगों की परिभाषा की तारीख की सीमाओं को कैलेंडर के हफ़्ते और महीने की सीमाओं से मेल खाना ज़रूरी नहीं है.
  • viewId, ऐप्लिकेशन व्यू आईडी होना चाहिए

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

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

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
फ़ील्ड
name

string

समानता रखने वाले लोगों के लिए यूनीक नाम. अगर कोई नाम तय नहीं किया गया है, तो वह कोहॉर्ट_[1234...] वैल्यू के साथ अपने-आप जनरेट हो जाएगा.

type

enum(Type)

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

dateRange

object(DateRange)

इसका इस्तेमाल FIRST_VISIT_DATE कोहॉर्ट के लिए किया जाता है. यह कोहॉर्ट, उन उपयोगकर्ताओं को चुनता है जिनकी पहली विज़िट की तारीख, DateRange में बताई गई शुरू होने की तारीख और खत्म होने की तारीख के बीच की है. एक जैसे उपयोगकर्ताओं के ग्रुप के अनुरोधों के लिए, तारीख की सीमाओं को अलाइन करना चाहिए. अगर अनुरोध में ga:cohortNthDay शामिल है, तो यह ठीक एक दिन का होना चाहिए. अगर ga:cohortNthWeek है, तो इसे हफ़्ते की सीमा (रविवार से शुरू और शनिवार को खत्म होने वाले) के मुताबिक होना चाहिए. साथ ही, ga:cohortNthMonth के लिए, तारीख की सीमा महीने की समयसीमा (महीने के पहले दिन से शुरू और महीने के आखिरी दिन खत्म) से अलाइन होनी चाहिए. लाइफ़टाइम वैल्यू के अनुरोधों पर इस तरह की कोई पाबंदी नहीं है. reportsRequest.dateRanges फ़ील्ड के लिए आपको तारीख की सीमा देने की ज़रूरत नहीं है.

टाइप

कोहॉर्ट का टाइप.

Enums
UNSPECIFIED_COHORT_TYPE अगर जानकारी नहीं दी गई है, तो उसे FIRST_VISIT_DATE माना जाता है.
FIRST_VISIT_DATE पहली विज़िट की तारीख के आधार पर चुने गए कोहॉर्ट.

शिकायत करें

अनुरोध से जुड़ा डेटा रिस्पॉन्स.

जेएसओएन के काेड में दिखाना 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
फ़ील्ड
columnHeader

object(ColumnHeader)

कॉलम के हेडर.

data

object(ReportData)

जवाब का डेटा.

nextPageToken

string

पेज टोकन का इस्तेमाल करें.

ColumnHeader

कॉलम हेडर.

जेएसओएन के काेड में दिखाना 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
फ़ील्ड
dimensions[]

string

रिस्पॉन्स में डाइमेंशन के नाम.

metricHeader

object(MetricHeader)

रिस्पॉन्स में मौजूद मेट्रिक के मेट्रिक हेडर.

MetricHeader

मेट्रिक के हेडर.

जेएसओएन के काेड में दिखाना 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
फ़ील्ड
metricHeaderEntries[]

object(MetricHeaderEntry)

रिस्पॉन्स में मेट्रिक के लिए हेडर.

pivotHeaders[]

object(PivotHeader)

जवाब में पिवट के लिए हेडर.

MetricHeaderEntry

मेट्रिक का हेडर.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "type": enum(MetricType)
}
फ़ील्ड
name

string

हेडर का नाम.

type

enum(MetricType)

मेट्रिक किस तरह की है, जैसे कि INTEGER.

PivotHeader

अनुरोध में तय किए गए हर पिवट सेक्शन के हेडर.

जेएसओएन के काेड में दिखाना 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
फ़ील्ड
pivotHeaderEntries[]

object(PivotHeaderEntry)

एक पिवट सेक्शन का हेडर.

totalPivotGroupsCount

number

इस पिवट के लिए ग्रुप की कुल संख्या.

PivotHeaderEntry

जवाब के पिवट सेक्शन में अनुरोध की गई मेट्रिक से जुड़े हर मेट्रिक कॉलम का हेडर.

जेएसओएन के काेड में दिखाना 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
फ़ील्ड
dimensionNames[]

string

पिवट रिस्पॉन्स में डाइमेंशन का नाम.

dimensionValues[]

string

पिवट में डाइमेंशन की वैल्यू.

metric

object(MetricHeaderEntry)

पिवट में मेट्रिक के लिए मेट्रिक हेडर.

ReportData

रिपोर्ट का डेटा वाला हिस्सा.

जेएसओएन के काेड में दिखाना 
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
फ़ील्ड
rows[]

object(ReportRow)

डाइमेंशन के हर यूनीक कॉम्बिनेशन के लिए, एक reportRow होता है.

totals[]

object(DateRangeValues)

अनुरोध की गई तारीख की हर सीमा के लिए, क्वेरी से मैच करने वाली सभी लाइनों के सेट के लिए, अनुरोध किए गए हर वैल्यू फ़ॉर्मैट की कुल संख्या मिलती है. किसी वैल्यू फ़ॉर्मैट की कुल वैल्यू का हिसाब, पहले वैल्यू फ़ॉर्मैट में बताई गई मेट्रिक को जोड़कर लगाया जाता है. इसके बाद, वैल्यू फ़ॉर्मैट का आकलन स्केलर एक्सप्रेशन के तौर पर किया जाता है. उदाहरण, 3 / (ga:sessions + 2) के लिए "कुल योग" का हिसाब लगाने के लिए, 3 / ((sum of all relevant ga:sessions) + 2) का इस्तेमाल किया जाता है. पेज पर नंबर डालने से पहले कुल योग का हिसाब लगाया जाता है.

rowCount

number

इस क्वेरी से मेल खाने वाली पंक्तियों की कुल संख्या.

minimums[]

object(DateRangeValues)

मेल खाने वाली सभी पंक्तियों में, कम से कम और ज़्यादा से ज़्यादा वैल्यू देखी गईं. अनुरोध में hideValueRanges के गलत होने या पंक्ति काउंट शून्य होने पर, ये दोनों खाली होते हैं.

maximums[]

object(DateRangeValues)

मेल खाने वाली सभी पंक्तियों में, कम से कम और ज़्यादा से ज़्यादा वैल्यू देखी गईं. अनुरोध में hideValueRanges के गलत होने या पंक्ति काउंट शून्य होने पर, ये दोनों खाली होते हैं.

samplesReadCounts[]

string (int64 format)

अगर नतीजों का सैंपल है, तो यह पढ़े गए सैंपल की कुल संख्या दिखाता है. जैसे, हर तारीख की सीमा के लिए एक एंट्री. अगर नतीजों का सैंपल नहीं लिया गया है, तो इस फ़ील्ड को नहीं दिखाया जाएगा. ज़्यादा जानकारी के लिए डेवलपर गाइड देखें.

samplingSpaceSizes[]

string (int64 format)

अगर नतीजों का सैंपल है, तो यह मौजूद सैंपल की कुल संख्या दिखाता है. जैसे, हर तारीख की सीमा के लिए एक एंट्री. अगर नतीजों का सैंपल नहीं लिया गया है, तो इस फ़ील्ड को नहीं दिखाया जाएगा. ज़्यादा जानकारी के लिए डेवलपर गाइड देखें.

isDataGolden

boolean

इससे पता चलता है कि इस अनुरोध का जवाब सुनहरा है या नहीं. उस समय डेटा गोल्डन होता है, जब एक ही अनुरोध से कोई नया नतीजा नहीं मिलता. ऐसा तब होता है, जब बाद में उसी अनुरोध के बारे में पूछा जाता है.

dataLastRefreshed

string (Timestamp format)

रिपोर्ट में पिछली बार रीफ़्रेश किए जाने का समय. इस टाइमस्टैंप से पहले मिलने वाले सभी हिट को रिपोर्ट की कैलकुलेशन में शामिल किया जाता है.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड तक सटीक होता है. उदाहरण: "2014-10-02T15:01:23.045123456Z".

ReportRow

रिपोर्ट में एक लाइन.

जेएसओएन के काेड में दिखाना 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
फ़ील्ड
dimensions[]

string

अनुरोध किए गए डाइमेंशन की सूची.

metrics[]

object(DateRangeValues)

अनुरोध की गई हर तारीख की सीमा के लिए मेट्रिक की सूची.

DateRangeValues

इसका इस्तेमाल, एक समयसीमा / डाइमेंशन कॉम्बिनेशन के लिए मेट्रिक की सूची दिखाने के लिए किया जाता है

जेएसओएन के काेड में दिखाना 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
फ़ील्ड
values[]

string

हर वैल्यू, अनुरोध में मौजूद हर मेट्रिक से जुड़ी होती है.

pivotValueRegions[]

object(PivotValueRegion)

हर पिवट क्षेत्र की वैल्यू.

PivotValueRegion

पिवट क्षेत्र में मेट्रिक की वैल्यू.

जेएसओएन के काेड में दिखाना 
{
  "values": [
    string
  ]
}
फ़ील्ड
values[]

string

हर पिवट क्षेत्र में मेट्रिक की वैल्यू.

ResourceQuotasRemaining

अनुरोध पूरा होने के बाद, प्रॉपर्टी के लिए बचे हुए रिसॉर्स कोटा टोकन.

जेएसओएन के काेड में दिखाना 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
फ़ील्ड
dailyQuotaTokensRemaining

number

बचा हुआ रोज़ का संसाधन कोटा.

hourlyQuotaTokensRemaining

number

हर घंटे के हिसाब से संसाधन कोटा टोकन बचे हैं.

इसे आज़माएं!