Core Reporting API - सेगमेंट

इस दस्तावेज़ में Core Reporting API में सेगमेंट का इस्तेमाल करने के सिंटैक्स और ध्यान रखने वाली बातों की जानकारी दी गई है.

Google Analytics Reporting API का अपडेट किया गया वर्शन मौजूद है. हमारा सुझाव है कि एपीआई की नई मुख्य सुविधाओं का फ़ायदा पाने के लिए, आज ही अपने कोड को माइग्रेट करें.

शुरुआती जानकारी

Core Reporting API की सेगमेंटेशन सुविधा का इस्तेमाल करते समय, आप Core Reporting API में किसी सेगमेंट के लिए अनुरोध करने के दो तरीके हैं:

1. आईडी के हिसाब से सेगमेंट: बिल्ट-इन या कस्टम सेगमेंट के अंकों वाले आईडी का इस्तेमाल करके क्वेरी करें.
2. डाइनैमिक सेगमेंट: अनुरोध के समय, सेगमेंट की जानकारी डाइनैमिक तौर पर दें.

सेगमेंट के काम करने के तरीके और उनसे जुड़े कॉन्सेप्ट के बारे में जानने के लिए, सेगमेंट की सुविधा के रेफ़रंस और सेगमेंट (सहायता केंद्र) पर जाएं.

आईडी के हिसाब से सेगमेंट

बिल्ट-इन या कस्टम सेगमेंट के आईडी का इस्तेमाल करके, Core Reporting API में किसी सेगमेंट का अनुरोध किया जा सकता है. Google Analytics Management API में सेगमेंट कलेक्शन के list तरीके से, किसी उपयोगकर्ता के सभी उपलब्ध सेगमेंट वापस पाए जा सकते हैं. हर सेगमेंट के लिए, आईडी, सेगमेंट संसाधन की id प्रॉपर्टी में उपलब्ध होता है.

एपीआई अनुरोधों में सेगमेंट आईडी इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Core Reporting API का रेफ़रंस देखें.

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

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

1. उपयोगकर्ता बनाम सेशन चुनना
2. शर्तों बनाम क्रमों का इस्तेमाल करना
3. मेट्रिक स्कोप का इस्तेमाल करना

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

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

1. उपयोगकर्ता बनाम सेशन चुनना

बताएं कि आपको उपयोगकर्ता या सेशन या दोनों को चुनना है या नहीं.

• उपयोगकर्ताओं को चुनने के लिए, users:: का इस्तेमाल करें.
• सेशन चुनने के लिए, sessions:: का इस्तेमाल करें.
• अगर users:: और sessions::, दोनों के लिए शर्तें दी गई हों:
  1. मिलते-जुलते उपयोगकर्ताओं के सेशन जनरेट करने के लिए, सबसे पहले उपयोगकर्ता शर्तें लागू की जाती हैं.
  2. सेशन की शर्तें सिर्फ़ #1 से सेशन पर लागू होती हैं.

ध्यान दें: उपयोगकर्ता और सेशन की शर्तों को सिर्फ़ AND (यानी, ‘;’) ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए:

• उन उपयोगकर्ताओं को चुनें जिन्होंने अपने कम से कम किसी एक सेशन में Chrome ब्राउज़र का इस्तेमाल किया हो.
  • users::condition::ga:browser==Chrome
• वे सेशन चुनें जिनमें Chrome ब्राउज़र का इस्तेमाल किया गया था.
  • sessions::condition::ga:browser==Chrome
• लंदन शहर के उन उपयोगकर्ताओं में से चुनें जिन्होंने कम से कम एक सेशन में Chrome ब्राउज़र का इस्तेमाल किया था.
  • users::condition::ga:browser==Chrome;sessions::condition::ga:city==London

उपयोगकर्ताओं और सेशन को चुनने के बारे में जानने के लिए, सिंटैक्स रेफ़रंस का conditionScope सेक्शन देखें.

2. शर्तों बनाम क्रम का इस्तेमाल करना

उपयोगकर्ताओं या सेशन को सेगमेंट में बांटने का फ़ैसला करने के बाद, आपको एक या ज़्यादा शर्तें और/या क्रम तय करने होंगे.

शर्तें

शर्तों में condition:: प्रीफ़िक्स का इस्तेमाल किया जाता है. उदाहरण के लिए:

• लंदन के उन उपयोगकर्ताओं को चुनें जो Chrome ब्राउज़र का इस्तेमाल करके आए थे.
  • users::condition::ga:city==London;ga:browser==Chrome

क्रम

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

क्रम वाली शर्तों के बारे में बताने के लिए, sequence:: प्रीफ़िक्स और इनके बाद (;–>>) या इसके तुरंत बाद (;–>) ऑपरेटर का इस्तेमाल करें. उदाहरण के लिए:

• उन उपयोगकर्ताओं को चुनें जिन्होंने पहली बार डेस्कटॉप का इस्तेमाल किया और उसके बाद मोबाइल डिवाइस का इस्तेमाल किया. हम उपयोगकर्ताओं को सेगमेंट कर रहे हैं, इसलिए यह किसी उपयोगकर्ता के सभी सेशन की खोज करता है. साथ ही, यह जांच करता है कि उपयोगकर्ता ने किसी एक सेशन में डेस्कटॉप का इस्तेमाल किया है या नहीं. साथ ही, आगे के किसी सेशन में उपयोगकर्ता ने मोबाइल डिवाइस का इस्तेमाल किया है या नहीं.
  • users::sequence::ga:deviceCategory==desktop;->>ga:deviceCategory==mobile
• हर चरण के लिए कई शर्तों का इस्तेमाल भी किया जा सकता है.
  • users::sequence::ga:deviceCategory==desktop;ga:operatingSystem==Windows->>ga:deviceCategory==mobile;ga:operatingSystem==Android
• किसी सेगमेंट में शर्तों और क्रमों को जोड़ने के लिए, AND (यानी, ';') ऑपरेटर का इस्तेमाल करें.
  • users::condition::ga:totalEvents>10;sequence::ga:deviceCategory==desktop->>ga:deviceCategory==mobile

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

3. मेट्रिक के स्कोप का इस्तेमाल करना

मेट्रिक का स्कोप वह लेवल तय करता है जिस पर मेट्रिक तय की जाती है — HIT, SESSION या USER. उदाहरण के लिए, ga:pageviews और ga:transactions, हिट लेवल की मेट्रिक हैं, क्योंकि वे हिट में होती हैं. वहीं, ga:sessionDuration और ga:bounces सेशन लेवल की मेट्रिक हैं, क्योंकि हर सेशन के लिए एक वैल्यू होती है. सैद्धान्तिक तौर पर, USER सबसे ऊपर के लेवल का स्कोप है और एचआईटी सबसे कम लेवल का स्कोप है.

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

मेट्रिक की हर शर्त के लिए स्कोप तय किया जा सकता है. इससे, यह तय होगा कि वह शर्त किस लेवल पर लागू होगी. मेट्रिक के स्कोप perUser::, perSession:: या perHit:: प्रीफ़िक्स का इस्तेमाल करके तय किए जाते हैं.

उदाहरण के लिए:

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

  users::condition::perUser::ga:transactionRevenue>=10
  

• एक सत्र में कम से कम $10 खर्च करने वाले उपयोगकर्ताओं को चुनें.

  users::condition::perSession::ga:transactionRevenue>=10
  

दायरे की पाबंदियां

Core Reporting API की मदद से, मेट्रिक के स्कोप की पुष्टि की जाती है, ताकि यह पक्का किया जा सके कि दी गई क्वेरी मान्य है या नहीं. दायरे की पुष्टि करने के नियम ये हैं:

1. मेट्रिक का स्कोप हमेशा अपने पैरंट शर्त के स्कोप के बराबर या उससे कम होना चाहिए (जैसा कि users:: या sessions:: प्रीफ़िक्स से दिखाया गया है).
2. मेट्रिक का तय स्कोप, डेटा मॉडल में बताए गए मुख्य दायरे के बराबर या उससे बड़ा होना चाहिए. मेट्रिक की पूरी सूची और उनके मुख्य स्कोप की पूरी सूची देखने के लिए, मेट्रिक: प्राइमरी स्कोप का रेफ़रंस देखें.

उदाहरण के लिए, नीचे मेट्रिक के मान्य स्कोप दिए गए हैं:

• शर्त और मेट्रिक के स्कोप दोनों एक जैसे होते हैं. जैसे, USER लेवल).
  • users::condition::perUser::ga:transactionRevenue>10
• शर्त का स्कोप मेट्रिक के स्कोप से ज़्यादा है (जैसे, उपयोगकर्ता > सेशन).
  • users::condition::perSession::ga:transactionRevenue>10
• ga:totalEvents, हिट लेवल की मेट्रिक है. इसलिए, किसी शर्त में इसके स्कोप perHit::, perSession:: या perUser:: हो सकते हैं. ऐसा इसलिए, क्योंकि ये सभी एचआईटी लेवल की मेट्रिक हैं. इसलिए, ये सभी स्कोप एचआईटी लेवल के स्कोप से ज़्यादा या इसके बराबर हैं.
  • users::condition::perHit::ga:totalEvents>5
  • users::condition::perSession::ga:totalEvents>5

उदाहरण के लिए, यहां अमान्य मेट्रिक के दायरे दिए गए हैं:

• नीचे दिया गया सेगमेंट अमान्य है, क्योंकि पैरंट शर्त का स्कोप मेट्रिक के स्कोप से कम है (यानी, सेशन < उपयोगकर्ता).
  • sessions::condition::perUser::ga:transactionRevenue>10
• सेशन लेवल मेट्रिक और एचआईटी लेवल < सेशन लेवल के लिए, हिट लेवल के स्कोप का इस्तेमाल किया जा रहा है.
  • users::condition::perHit::ga:sessionDuration>60

अमान्य दायरों वाली किसी भी क्वेरी के लिए, 400 Bad Request गड़बड़ी दिखेगी.

डिफ़ॉल्ट दायरा

जब मेट्रिक की शर्त के लिए स्कोप के बारे में साफ़ तौर पर नहीं बताया गया होता, तो यह शर्त के स्कोप को डिफ़ॉल्ट रूप से लागू कर देता है. उदाहरण के लिए, यह सेगमेंट अपनी मेट्रिक की सभी शर्तों के लिए, उपयोगकर्ता लेवल के दायरे का इस्तेमाल करेगा: users::condition::ga:transactionRevenue>=10;ga:sessionDuration>60

डाइनैमिक सेगमेंट सिंटैक्स का रेफ़रंस

बेस सिंटैक्स

सेगमेंट तय करने के लिए सिंटैक्स इस तरह का होता है: segment=<segmentCondition>+. दूसरे शब्दों में, एक सेगमेंट में एक या उससे ज़्यादा segmentCondition स्टेटमेंट होते हैं.

<segmentCondition> को इस तरह परिभाषित किया गया है: <conditionScope><conditionType><dimensionOrMetricConditions>

जहां:
conditionScope, शर्तों के टॉप-लेवल स्कोप के बारे में बताता है.
conditionType शर्तों के टाइप की जानकारी देता है.
dimensionOrMetricConditions डाइमेंशन/मेट्रिक की शर्तों या क्रम के चरणों के बारे में बताता है.

conditionScope

शर्तों के टॉप-लेवल के स्कोप के बारे में बताता है. आपको ये वैल्यू दिख सकती हैं:

• उपयोगकर्ताओं को चुनने के लिए, users::.
• सेशन चुनने के लिए sessions::.

conditionScope के लिए सीमाएं और विचार:

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

conditionType

शर्तों के टाइप बताता है. आपको ये वैल्यू दिख सकती हैं:

• आसान शर्तों (जैसे, बिना क्रम के) के बारे में बताने के लिए condition::.
• क्रम पर आधारित शर्तों को तय करने के लिए sequence::.

conditionType के लिए सीमाएं और विचार:

• अगर एक से ज़्यादा 'आसान शर्तें' और 'क्रम' दिए गए हों, तो उन्हें हमेशा AND ऑपरेटर के साथ जोड़ा जाना चाहिए.
• क्रम पर आधारित शर्तों के लिए, हर सेगमेंट में ज़्यादा से ज़्यादा 10 चरण हो सकते हैं.

सामान्य शर्तें

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

सामान्य शर्तों के लिए मान्य शर्त ऑपरेटर ये हैं:

• AND या OR ऑपरेटर के साथ शर्तें जोड़ना.
• डाइमेंशन और मेट्रिक ऑपरेटर.

सामान्य शर्तों के लिए सिंटैक्स यह है:

condition::<dimensionOrMetricConditions>

सामान्य शर्तों के उदाहरण:

• users::condition::ga:transactionRevenue>10;ga:sessionDuration>60
• किसी टॉप-लेवल निगेशन ऑपरेटर की मदद से, किसी सामान्य शर्त में कई डाइमेंशन/मेट्रिक कंडिशन से मेल खाने वाले नतीजे पाए जा सकते हैं. उदाहरण, users::condition::!ga:transactionRevenue>10;ga:sessionDuration>60

शर्तों को बाहर रखना

बाहर रखने की शर्त का इस्तेमाल, ऐसा सेगमेंट बनाने के लिए किया जाता है जो तय की गई शर्त के मुताबिक नहीं है.

सिंटैक्स में किसी शर्त को नकारने और उस शर्त से मेल खाने वाले सेशन को बाहर रखने के लिए, NOT Operator (! वर्ण) का इस्तेमाल किया जाता है.

उन सेशन को बाहर रखें जिनमें एग्ज़िट पेज, रूट पेज के पाथ से पूरी तरह मैच करता है:
sessions::condition::!ga:exitPagePath==/

एक से ज़्यादा शर्तें

उपयोगकर्ता-लेवल की सभी शर्तों को एक ही users:: प्रीफ़िक्स के तहत रखा जा सकता है या हर शर्त के लिए एक अलग users:: प्रीफ़िक्स का इस्तेमाल किया जा सकता है. यही बात सेशन लेवल की शर्तों पर भी लागू होती है.

उदाहरण के लिए, नीचे दिए गए सेगमेंट एक जैसे हैं. दोनों ही मामलों में, चुनिंदा उपयोगकर्ताओं के लिए condition1 और condition2 AND की जाती है:
users::<condition1>;<condition2>
users::<condition1>users::<condition2>

क्रम की शर्तें

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

क्रम की शर्तों के लिए मान्य क्रम ऑपरेटर ये हैं:

• –>> ऑपरेटर बताता है कि पिछला चरण, अगले चरण से पहले है.
• –> ऑपरेटर बताता है कि पिछला चरण अगले चरण से ठीक पहले आता है.

क्रम की शर्तों के लिए सिंटैक्स यह है:

sequence:: NOT? FIRST_HIT_MATCHES_FIRST_STEP? (AND (PRECEDES|IMMEDIATELY_PRECEDES) <step>)*

कहां:

NOT को इससे दिखाया जाता है: !

FIRST_HIT_MATCHES_FIRST_STEP को इससे दिखाया जाता है: ^

PRECEDES को इससे दिखाया जाता है: ;–>>

IMMEDIATELY_PRECEDES को इससे दिखाया जाता है: ;–>

step को इससे दिखाया जाता है: <dimensionOrMetricConditions>

क्रम से जुड़ी शर्तों के उदाहरण:

• users::sequence::ga:deviceCategory==desktop;->ga:deviceCategory==tablet
• किसी टॉप-लेवल नेगेशन ऑपरेटर की मदद से, उस क्रम को पूरा किया जा सकता है जिसमें कई चरण और/या डाइमेंशन/मेट्रिक से जुड़ी शर्तें हो सकती हैं. उदाहरण, users::sequence::!ga:deviceCategory==desktop;->ga:deviceCategory==tablet
• ^ ऑपरेटर का इस्तेमाल यह बताने के लिए किया जा सकता है कि पहला चरण, दी गई तारीख की सीमा में पहले सेशन के पहले हिट से मेल खाता हो. उदाहरण, users::sequence::^ga:deviceCategory==desktop;->ga:deviceCategory==tablet

सेशन की शर्तों की तारीख

सेगमेंट में ऐसे तरह के विश्लेषण का इस्तेमाल किया जा सकता है जिसमें dateOfSession सिंटैक्स का इस्तेमाल होता है. <> ऑपरेटर के साथ मिलाकर, सेगमेंट को उन उपयोगकर्ताओं के ग्रुप तक सीमित किया जा सकता है जिन्होंने किसी तय तारीख की सीमा के दौरान सेशन शुरू किया है. dateOfSession के लिए, तारीख की ज़्यादा से ज़्यादा सीमा 31 दिन है. इसके इस्तेमाल से जुड़ी जानकारी के लिए, कृपया यहां सेशन की तारीख का उदाहरण देखें.

<> के बीच का ऑपरेटर सिर्फ़ dateOfSession एक्सप्रेशन में काम करता है.

डाइमेंशन और मेट्रिक की शर्तें

संयोजन की शर्तें

एक या उससे ज़्यादा डाइमेंशन की शर्तों को AND के साथ जोड़ा जा सकता है (यानी, ';') और OR (जैसे, ',') ऐसे ऑपरेटर जिनकी OR वैल्यू को प्राथमिकता दी जाती है.

सिंटैक्स वही है जिसका इस्तेमाल फ़िल्टर को मिलाने के लिए किया जाता है. ज़्यादा जानकारी के लिए, Core Reporting API के रेफ़रंस में फ़िल्टर जोड़ना देखें.

ऑपरेटर

नीचे दी गई टेबल में, सेगमेंट में इस्तेमाल किए जा सकने वाले सभी उपलब्ध ऑपरेटर के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि वे डाइमेंशन और/या मेट्रिक के साथ काम करते हैं या नहीं.

ऑपरेटर	ब्यौरा	आयाम शर्तों में समर्थित है?	क्या मेट्रिक की शर्तों में यह सुविधा काम करती है?
==	इसके बराबर या एग्ज़ैक्ट मैच.	हां उदाहरण: ga:city==London	हां उदाहरण: ga:adCost==10
!=	इसके बराबर नहीं है या एग्ज़ैक्ट मैच नहीं है.	हां उदाहरण: ga:city!=London	हां उदाहरण: ga:adCost!=10
<	इससे छोटा.	हां (सिर्फ़ अंकों वाली वैल्यू के लिए). उदाहरण: ga:hour<12	हां उदाहरण: ga:adCost<10
<=	इससे कम या इसके बराबर.	हां (सिर्फ़ अंकों वाली वैल्यू के लिए). उदाहरण: ga:hour<=12	हां उदाहरण: ga:adCost<=10
>	इससे बड़ा है.	हां (सिर्फ़ अंकों वाली वैल्यू के लिए). उदाहरण: ga:hour>12	हां उदाहरण: ga:adCost>10
>=	इससे ज़्यादा या इसके बराबर.	हां (सिर्फ़ अंकों वाली वैल्यू के लिए). उदाहरण: ga:hour>=12	हां उदाहरण: ga:adCost>=10
<>	इनके बीच (वैल्यू, दी गई रेंज के बीच है).^1	हां (सिर्फ़ अंकों वाली वैल्यू के लिए). उदाहरण: ga:hour<>1_12	हां उदाहरण: ga:adCost<>10_20
[]	सूची में (वैल्यू, सूची में दी गई वैल्यू में से एक है).^2	हां उदाहरण: ga:browser[]Chrome|Firefox|Opera	नहीं
=@	इसमें सबस्ट्रिंग शामिल है.	हां उदाहरण: ga:keyword=@shoes	नहीं
!@	इसमें सबस्ट्रिंग नहीं है.	हां उदाहरण: ga:keyword!@shoes	नहीं
=~	इसमें रेगुलर एक्सप्रेशन का मैच शामिल होता है.	हां उदाहरण: ga:keyword=~shoes	नहीं
!~	इसमें रेगुलर एक्सप्रेशन के लिए कोई मैच शामिल नहीं है.	हां उदाहरण: ga:keyword!~shoes	नहीं

¹ऑपरेटर के बीच <>
इससे, आपको किसी तय रेंज में वैल्यू के लिए क्वेरी करने की सुविधा मिलती है. इसकी रेंज वैल्यू शामिल हैं. इसका इस्तेमाल उन मेट्रिक और डाइमेंशन, दोनों के लिए किया जा सकता है जिनमें संख्या वाली वैल्यू होती हैं (उदाहरण के लिए, ga:hour). रेंज में कम से कम और ज़्यादा से ज़्यादा वैल्यू को अंडरस्कोर से अलग किया जाना चाहिए.

सिंटैक्स:
{dimensionOrMetricName}<>{minValue}_{maxValue}

उदाहरण:
12 से 23 घंटे के बीच होने वाले सेशन चुनें.
sessions::condition::ga:hour<>12_23

²सूची ऑपरेटर []
इससे, दी गई सूची में मौजूद वैल्यू के लिए क्वेरी की जा सकती है. इसका इस्तेमाल सिर्फ़ डाइमेंशन के साथ किया जा सकता है. वैल्यू की सूची को "|" वर्ण का इस्तेमाल करके अलग किया जाना चाहिए. अगर वैल्यू में "|" है, तो उसे एस्केप किया जाना चाहिए.

सिंटैक्स:
{dimensionName}[]{value1}|{value2}|...

पाबंदियां:
हर इन-लिस्ट डाइमेंशन शर्त के लिए ज़्यादा से ज़्यादा 10 वैल्यू की अनुमति है (उदाहरण के लिए, ga:city[]city1|city2|...|city10).

उदाहरण:
उन सेशन को चुनें जो Chrome, Firefox या Opera ब्राउज़र के हैं.
sessions::condition::ga:browser[]Chrome|Firefox|Opera

खास किरदारों को एस्केप करना

अगर खास वर्ण ',' और ';', वैल्यू एक्सप्रेशन में मौजूद हैं, तो उन्हें एस्केप किया जाना चाहिए. उदाहरण, ga:keyword==nike\,shoes

डाइमेंशन और मेट्रिक की शर्तों के बारे में ज़्यादा जानकारी के लिए, कोर रिपोर्टिंग एपीआई का रेफ़रंस देखें.

कंस्ट्रेंट

डाइमेंशन और मेट्रिक की शर्तों से जुड़ी सीमाएं यहां दी गई हैं:

• हर सेगमेंट के लिए ज़्यादा से ज़्यादा 10 डाइमेंशन या मेट्रिक शर्तें.
• डाइमेंशन की शर्तों के लिए, एक्सप्रेशन में ज़्यादा से ज़्यादा 1024 वर्ण हो सकते हैं.

लेगसी डाइनैमिक सेगमेंट को माइग्रेट करना

dynamic:: प्रीफ़िक्स का इस्तेमाल करने वाले लेगसी डाइनैमिक सेगमेंट, मौजूदा सिंटैक्स में डाइमेंशन और मेट्रिक की शर्तों वाले सेशन लेवल के सेगमेंट के बराबर होते हैं. अगर आपने लेगसी डाइनैमिक सेगमेंट का इस्तेमाल किया है, तो आपको dynamic:: प्रीफ़िक्स को sessions::condition:: प्रीफ़िक्स से बदलकर नए सिंटैक्स पर माइग्रेट करना चाहिए. उदाहरण के लिए, नीचे दिए गए दो सेगमेंट एक जैसे हैं:

dynamic::ga:browser==Chrome
इसके बराबर है:
sessions::condition::ga:browser==Chrome

ध्यान दें: dynamic:: प्रीफ़िक्स 27 मार्च, 2014 से काम नहीं करता है. हमारा सुझाव है कि आप जल्द से जल्द नए सिंटैक्स पर माइग्रेट करें.

सेगमेंट के उदाहरण

1. डेमोग्राफ़िक: पुरुषों की भाषा EN-US है, उनकी दिलचस्पी गेम में है, और वे अमेरिका से हैं.

उपयोगकर्ता-आधारित सेगमेंट सबसे पहले लागू किए जाते हैं. इसलिए, उपयोगकर्ता के हिसाब से शर्त तय करने से, ऐसे उपयोगकर्ता दिखते हैं जो पुरुष हैं और जिनकी गेम में दिलचस्पी है. इसके बाद, इन उपयोगकर्ताओं के सेशन पर आधारित शर्तें लागू होंगी. ऐसा करने पर, अमेरिका से जुड़े सेशन और भाषा EN-US से मिलेगी.

users::condition::ga:userGender==Male;users::condition::ga:interestAffinityCategory==Games ; sessions::condition::ga:region==Americas;sessions::condition::ga:language==en-u

2. व्यवहार: वे उपयोगकर्ता जिन्होंने 100 से ज़्यादा सेशन, पिछले सात दिनों में नहीं किए हैं, हर सेशन में दो लेन-देन किए हैं, और हर सेशन में साइट पर 100 सेकंड से ज़्यादा का समय लगा है.

users::condition::ga:sessions>100;ga:daysSinceLastSession>=7; perSession::ga:transactions>2;perSession::ga:sessionDuration>100

3. सेशन: वे सेशन चुनें जिनमें Chrome के तौर पर ब्राउज़र, देश को अमेरिका, और अपवाद हर हिट > 1 के तौर पर चुना गया हो. साथ ही, वे उपयोगकर्ता चुनें जिनसे हर सेशन में बाहर निकलने का समय < 2.

sessions::condition::ga:browser==Chrome;ga:country==US;perHit::ga:exceptions>1; users::condition::perSession::ga:exits<2

4. क्रम वाले सेशन: चरण वाले सेशन चुनें: Chrome और हर हिट के कुल इवेंट > 5. साथ ही, ऐसे उपयोगकर्ता चुनें जिनके पास 'चरण: डेस्कटॉप पर फ़ॉलो किया गया' चरण के हिसाब से: मोबाइल पर हो.

sessions::sequence::ga:browser==Chrome;condition::perHit::ga:totalEvents>5;users::sequence::ga:deviceCategory==desktop->>ga:deviceCategory=mobile

5. सेशन की तारीख: उन उपयोगकर्ताओं को चुनें जिन्होंने 20 मई, 2014 से 30 मई, 2014 के बीच अपना पहला सेशन किया और साइट पर 600 से ज़्यादा सेकंड बिताए.

users::sequence::^ga:sessionCount==1;dateOfSession<>2014-05-20_2014-05-30;->>ga:sessionDurationBucket>600

मेट्रिक: प्राइमरी स्कोप रेफ़रंस

मेट्रिक	मुख्य दायरा
ga:adClicks	हिट
ga:adCost	हिट
ga:adsenseAdsClicks	हिट
ga:adsenseAdsViewed	हिट
ga:adsenseAdUnitsViewed	हिट
ga:adsenseCTR	हिट
ga:adsenseECPM	हिट
ga:adsensePageImpressions	हिट
ga:adsenseRevenue	हिट
ga:avgDomainLookupTime	हिट
ga:avgDomContentLoadedTime	हिट
ga:avgDomInteractiveTime	हिट
ga:avgEventValue	हिट
ga:avgPageDownloadTime	हिट
ga:avgPageLoadTime	हिट
ga:avgRedirectionTime	हिट
ga:avgScreenviewDuration	हिट
ga:avgSearchDepth	हिट
ga:avgSearchDuration	हिट
ga:avgSearchResultViews	हिट
ga:avgServerConnectionTime	हिट
ga:avgServerResponseTime	हिट
ga:avgUserTimingValue	हिट
ga:costPerConversion	हिट
ga:costPerGoalConversion	हिट
ga:costPerTransaction	हिट
ga:CPC	हिट
ga:CPM	हिट
ga:CTR	हिट
ga:domainLookupTime	हिट
ga:domContentLoadedTime	हिट
ga:domInteractiveTime	हिट
ga:domLatencyMetricsSample	हिट
ga:eventValue	हिट
ga:exceptions	हिट
ga:exceptionsPerScreenview	हिट
ga:fatalExceptions	हिट
ga:fatalExceptionsPerScreenview	हिट
ga:goalAbandonRateAll	हिट
ga:goalAbandonsAll	हिट
ga:goalCompletionsAll	हिट
ga:goalStartsAll	हिट
ga:goalValueAll	हिट
ga:goalValueAllPerSearch	हिट
ga:goalXXAbandonRate	हिट
ga:goalXXAbandons	हिट
ga:goalXXCompletions	हिट
ga:goalXXStarts	हिट
ga:goalXXValue	हिट
ga:impressions	हिट
ga:itemQuantity	हिट
ga:itemRevenue	हिट
ga:itemsPerPurchase	हिट
ga:localItemRevenue	हिट
ga:localTransactionRevenue	हिट
ga:localTransactionShipping	हिट
ga:localTransactionTax	हिट
ga:margin	हिट
ga:metricXX	हिट
ga:pageDownloadTime	हिट
ga:pageLoadSample	हिट
ga:pageLoadTime	हिट
ga:pageValue	हिट
ga:pageviews	हिट
ga:percentSearchRefinements	हिट
ga:redirectionTime	हिट
ga:revenuePerItem	हिट
ga:revenuePerTransaction	हिट
ga:ROI	हिट
ga:RPC	हिट
ga:screenviews	हिट
ga:searchDepth	हिट
ga:searchDuration	हिट
ga:searchGoalConversionRateAll	हिट
ga:searchGoalXXConversionRate	हिट
ga:searchRefinements	हिट
ga:searchResultViews	हिट
ga:searchUniques	हिट
ga:serverConnectionTime	हिट
ga:serverResponseTime	हिट
ga:socialActivities	हिट
ga:socialInteractions	हिट
ga:socialInteractionsPerSession	हिट
ga:speedMetricsSample	हिट
ga:timeOnScreen	हिट
ga:totalEvents	हिट
ga:totalValue	हिट
ga:transactionRevenue	हिट
ga:transactions	हिट
ga:transactionShipping	हिट
ga:transactionTax	हिट
ga:uniqueAppviews	हिट
ga:uniqueEvents	हिट
ga:uniquePageviews	हिट
ga:uniquePurchases	हिट
ga:uniqueScreenviews	हिट
ga:uniqueSocialInteractions	हिट
ga:userTimingSample	हिट
ga:userTimingValue	हिट
ga:adsenseExits	सत्र
ga:avgTimeOnPage	सत्र
ga:avgSessionDuration	सत्र
ga:bounces	सत्र
ga:entranceBounceRate	सत्र
ga:entranceRate	सत्र
ga:entrances	सत्र
ga:eventsPerSessionWithEvent	सत्र
ga:exitRate	सत्र
ga:exits	सत्र
ga:goalConversionRateAll	सत्र
ga:goalValuePerSession	सत्र
ga:goalXXConversionRate	सत्र
ga:organicSearches	सत्र
ga:pageviewsPerSession	सत्र
ga:percentSessionsWithSearch	सत्र
ga:screenviewsPerSession	सत्र
ga:searchExitRate	सत्र
ga:searchExits	सत्र
ga:searchSessions	सत्र
ga:sessionDuration	सत्र
ga:transactionRevenuePerSession	सत्र
ga:transactionsPerSession	सत्र
ga:bounceRate	सत्र
ga:sessions	सत्र
ga:sessionsWithEvent	सत्र
ga:newSessions	उपयोगकर्ता
ga:percentNewSessions	उपयोगकर्ता
ga:users	उपयोगकर्ता