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 करोड़. ज़्यादा जानकारी के लिए, सीमाएं और कोटा से जुड़ा दस्तावेज़ देखें.

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

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

मुख्य रिस्पॉन्स क्लास, जो रिपोर्टिंग एपीआई 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

रिपोर्ट का अनुरोध

मुख्य अनुरोध की कैटगरी, जो रिपोर्टिंग एपीआई के अनुरोध के बारे में बताती है.

जेएसओएन के काेड में दिखाना
{
  "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: मौजूदा तारीख - 7 दिन, endDate: मौजूदा तारीख - 1 दिन) होती है. 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 का इस्तेमाल करने के लिए, एक डाइमेंशन या मेट्रिक दें, जिस पर फ़िल्टर करना है. इसके बाद फ़िल्टर एक्सप्रेशन का इस्तेमाल करें. उदाहरण के लिए, यहां दिया गया एक्सप्रेशन ga:browser डाइमेंशन चुनता है, जो Firefox; 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 कोर रिपोर्टिंग एपीआई हर अनुरोध के हिसाब से ज़्यादा से ज़्यादा 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 के बाद डाइमेंशन की वैल्यू को बकेट में डाल देते हैं. ऐसे डाइमेंशन की वैल्यू जो इंटिग्रल वैल्यू की स्ट्रिंग नहीं हैं, उन्हें शून्य में बदल दिया जाएगा. बकेट वैल्यू बढ़ते क्रम में होनी चाहिए. हर बकेट, निचले हिस्से पर बंद होती है और ऊपर की ओर खुलती है. "first" बकेट में पहली सीमा से कम सभी वैल्यू शामिल हैं, "last" बकेट में इनफ़िनिटी तक के सभी मान शामिल हैं. बकेट में आने वाले डाइमेंशन की वैल्यू को नए डाइमेंशन वैल्यू में बदल दिया जाता है. उदाहरण के लिए, अगर कोई &&tt0, 1, 3, 4, 7&quot की सूची देता है, तो हम ये बकेट दिखाते हैं:

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

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

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

और HISTOGRAM_BUCKET बढ़ते क्रम में:

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

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

आयाम फ़िल्टर उपनियम

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

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

enum(FilterLogicalOperator)

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

filters[]

object(DimensionFilter)

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

फ़िल्टर लॉगलॉजिकल ऑपरेटर

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

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

डाइमेंशन फ़िल्टर

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

जेएसओएन के काेड में दिखाना
{
  "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'ed होते हैं. उदाहरण के लिए:

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.

मेट्रिक टाइप

अलग-अलग तरह की मेट्रिक.

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

मेट्रिकफ़िल्टर क्लॉज़

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

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

enum(FilterLogicalOperator)

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

filters[]

object(MetricFilter)

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

मेट्रिकफ़िल्टर

मेट्रिकफ़िल्टर से मेट्रिक पर फ़िल्टर दिखता है.

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

string

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

not

boolean

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

operator

enum(Operator)

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

comparisonValue

string

तुलना करने के लिए वैल्यू.

ऑपरेटर

अलग-अलग तरह की तुलना के विकल्प.

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

ऑर्डर के हिसाब से

क्रम से लगाने के विकल्पों की जानकारी.

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

string

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

orderType

enum(OrderType)

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

sortOrder

enum(SortOrder)

फ़ील्ड के लिए क्रम से लगाने का क्रम.

ऑर्डर प्रकार

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.

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

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

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

string

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

userSegment

object(SegmentDefinition)

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

sessionSegment

object(SegmentDefinition)

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

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

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

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

object(SegmentFilter)

सेगमेंट को सेगमेंट फ़िल्टर के सेट से तय किया जाता है, जो एक लॉजिकल AND कार्रवाई के साथ जोड़े जाते हैं.

सेगमेंट फ़िल्टर

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

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

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

सामान्य सेगमेंट

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

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

object(OrFiltersForSegment)

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

सेगमेंट के लिए

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

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

object(SegmentFilterClause)

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

सेगमेंट फ़िल्टर क्लॉज़

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

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

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

सेगमेंट डाइमेंशन फ़िल्टर

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

जेएसओएन के काेड में दिखाना
{
  "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'ed होते हैं. उदाहरण के लिए:

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

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

NUMERIC_LESS_THAN

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

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

यह जांच करता है कि डाइमेंशन, मेल खाने वाले एक्सप्रेशन से अंकों में कम है या नहीं.

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

सेगमेंट मेट्रिकफ़िल्टर

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

जेएसओएन के काेड में दिखाना
{
  "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 का इस्तेमाल करेंगे.

क्रम सेगमेंट

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

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

object(SegmentSequenceStep)

क्रम में दिए गए चरणों की सूची.

firstStepShouldMatchFirstHit

boolean

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

सेगमेंट का क्रम

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

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

object(OrFiltersForSegment)

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

matchType

enum(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 कॉलम, "Chrome के लिए k कॉलम, Chrome" वगैरह मिलते हैं. कॉलम के ग्रुप का क्रम, k की वैल्यू के पहले क्रम के हिसाब से तय किया जाता है. टाई, पहले पिवट डाइमेंशन के शब्दकोश के क्रम के मुताबिक, और दूसरे पिवट डाइमेंशन के शब्दकोश के क्रम के मुताबिक होते हैं. उदाहरण के लिए, अगर Firefox, IE, और Chrome के पहले मान के योग का क्रम 8, 2, 8 था, तो कॉलम का क्रम Chrome, Firefox, IE होगा.

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

maxGroupCount

number

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

कोहॉर्ट ग्रुप

एक जैसे उपयोगकर्ताओं के ग्रुप के बारे में बताता है. उदाहरण के लिए:

"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 का अनुरोध करते समय, रविवार और endDate को आने वाले शनिवार की तारीख होनी चाहिए. ga:cohortNthMonth के लिए, startDate महीने की पहली तारीख होनी चाहिए और endDate महीने का आखिरी दिन होना चाहिए.

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

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

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

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

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

string

कोहॉर्ट के लिए यूनीक नाम. अगर यह नाम तय नहीं किया जाता है, तो एक जैसे उपयोगकर्ताओं के ग्रुप {0}[1234...] की वैल्यू अपने-आप जनरेट हो जाएंगी.

type

enum(Type)

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

dateRange

object(DateRange)

इसका इस्तेमाल, FIRST_VISIT_DATE कोहॉर्ट (एक जैसे उपयोगकर्ताओं के ग्रुप) के लिए किया जाता है. यह कोहॉर्ट, उन उपयोगकर्ताओं को चुनता है जिनकी पहली तारीख, तारीख की सीमा के हिसाब से शुरू होने की तारीख और खत्म होने की तारीख के बीच की होती है. तारीख की सीमा, एक जैसे उपयोगकर्ताओं के ग्रुप के अनुरोधों के मुताबिक होनी चाहिए. अगर अनुरोध में 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

नतीजों में अगला पेज फिर से पाने के लिए पेज टोकन.

कॉलम हेडर

कॉलम हेडर.

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

string

जवाब में डाइमेंशन के नाम.

metricHeader

object(MetricHeader)

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

मेट्रिक हेडर

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

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

object(MetricHeaderEntry)

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

pivotHeaders[]

object(PivotHeader)

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

मेट्रिक हेडर एंट्री

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

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

string

हेडर का नाम.

type

enum(MetricType)

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

पिवट हेडर

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

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

object(PivotHeaderEntry)

सिंगल पिवट सेक्शन का हेडर.

totalPivotGroupsCount

number

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

पिवटहेडर एंट्री

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

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

string

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

dimensionValues[]

string

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

metric

object(MetricHeaderEntry)

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

रिपोर्ट डेटा

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

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

क्वेरी से मेल खाने वाली सभी पंक्तियों के सेट के लिए, अनुरोध की गई हर वैल्यू के लिए कुल वैल्यू मिलती है. किसी वैल्यू फ़ॉर्मैट के कुल योग का हिसाब लगाने के लिए, सबसे पहले वैल्यू के फ़ॉर्मैट में बताई गई मेट्रिक और फिर स्केलर एक्सप्रेशन के तौर पर वैल्यू के फ़ॉर्मैट का आकलन किया जाता है. उदाहरण, "totals" 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".

रिपोर्ट की पंक्ति

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

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

string

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

metrics[]

object(DateRangeValues)

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

तारीख रेंज की वैल्यू

किसी एक तारीख श्रेणी / आयाम संयोजन की मेट्रिक की सूची लौटाने के लिए इस्तेमाल किया जाता है

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

string

हर वैल्यू, अनुरोध की हर मेट्रिक से मेल खाती है.

pivotValueRegions[]

object(PivotValueRegion)

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

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

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

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

string

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

संसाधन कोटा शेष

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

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

number

दैनिक संसाधन कोटा शेष.

hourlyQuotaTokensRemaining

number

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

इसे आज़माएं!