filters
क्वेरी स्ट्रिंग पैरामीटर, दिखाए जाने वाले डेटा को सीमित करता है
को अपडेट किया जा सकता है. filters
पैरामीटर का इस्तेमाल करने पर,
जिस डाइमेंशन के हिसाब से आपको फ़िल्टर करना है उसे डालें. इसके बाद, आपको फ़िल्टर एक्सप्रेशन का इस्तेमाल करना होगा.
फ़िल्टर की गई क्वेरी, नतीजे में शामिल की जाने वाली लाइनों पर पाबंदी लगाती हैं. हर लाइन नतीजे में फ़िल्टर के हिसाब से जांच की जाती है: अगर फ़िल्टर मेल खाता है, तो पंक्ति बनाए रखा जाता है और अगर यह मेल नहीं खाता है, तो पंक्ति छोड़ दी जाती है.
- यूआरएल एन्कोडिंग: क्लाइंट लाइब्रेरी, कोड में अपने-आप फ़िल्टर ऑपरेटर का इस्तेमाल करें. हालांकि, अगर सीधे प्रोटोकॉल से अनुरोध किया जाता है, तो जैसा कि नीचे दी गई टेबल में बताया गया है, आपको फ़िल्टर ऑपरेटर को साफ़ तौर पर कोड में बदलना होगा.
- फ़िल्टर करने की प्राथमिकता: फ़िल्टर करने की प्रोसेस, किसी भी कार्रवाई से पहले होती है डाइमेंशन एग्रीगेट किए जाते हैं, ताकि लौटाए गए मेट्रिक से कुल सिर्फ़ काम के डाइमेंशन के लिए.
फ़िल्टर सिंटैक्स
एक फ़िल्टर इस फ़ॉर्म का इस्तेमाल करता है:
name operator expression
इस सिंटैक्स में:
- name — उस डाइमेंशन का नाम जिस पर फ़िल्टर करना है.
उदाहरण के लिए:
AD_CLIENT_ID
, विज्ञापन क्लाइंट आईडी के हिसाब से फ़िल्टर करेगा. - ऑपरेटर — यह बताता है कि किस तरह के फ़िल्टर मैच का इस्तेमाल किया जाना है.
- एक्सप्रेशन — यह नतीजों में शामिल वैल्यू दिखाता है.
वे सभी डाइमेंशन जो
रिपोर्ट की जाने वाली मेट्रिक पर लागू करने के विकल्प का इस्तेमाल फ़िल्टर के तौर पर किया जा सकता है.
इसके अपवाद हैं, जिनमें तारीख से जुड़े डाइमेंशन (DATE
, WEEK
,
और MONTH
) है. तारीख के हिसाब से फ़िल्टर करने के लिए, यह जानकारी दें
तारीख की सीमा चुनें.
फ़िल्टर ऑपरेटर
दो फ़िल्टर ऑपरेटर होते हैं. ऑपरेटर को यूआरएल को कोड में बदलना होगा, ताकि यूआरएल क्वेरी स्ट्रिंग में शामिल किया जाता है.
ऑपरेटर | ब्यौरा | यूआरएल एन्कोडेड फ़ॉर्म | उदाहरण |
---|---|---|---|
== |
एग्ज़ैक्ट मैच वाला कीवर्ड | %3D%3D |
वे एग्रीगेट मेट्रिक जिनमें देश का नाम कनाडा है:
filters=COUNTRY_NAME%3D%3DCanada |
=@ |
इसमें सबस्ट्रिंग शामिल है | %3D@ |
ऐसी एग्रीगेट मेट्रिक जिनमें देश के नाम में यूनाइटेड शामिल हो, इस
अमेरिका और यूनाइटेड किंगडम से मैच होता है, उदाहरण के लिए:
filters=COUNTRY_NAME%3D@United |
फ़िल्टर एक्सप्रेशन
फ़िल्टर एक्सप्रेशन के लिए कुछ ज़रूरी नियम ये हैं:
- यूआरएल-रिज़र्व किए गए वर्ण — वर्ण, जैसे कि
&
को सामान्य तरीके से यूआरएल-एन्कोडेड किया जाना चाहिए. क्लाइंट लाइब्रेरी अपने लिए इस बात का ध्यान रखें, इसलिए आपको इस एन्कोडिंग के बारे में केवल तब चिंता करनी होती है जब आप प्रोटोकॉल को डायरेक्ट कॉल कर रहे हैं. - रिज़र्व्ड वर्ण — कॉमा और बैकस्लैश
किसी एक्सप्रेशन में दिखने पर, बैकस्लैश एस्केप्ड हो सकता है.
- बैकस्लैश
\\
- कॉमा
\,
- बैकस्लैश
ध्यान दें: पहले बैकस्लैश से बचें कॉमा, ताकि दो बार एस्केप न किया जा सके.
फ़िल्टर जोड़ना
OR
और AND
बूलियन का इस्तेमाल करके फ़िल्टर जोड़े जा सकते हैं
लॉजिक.
OR लॉजिक
OR
लॉजिक को, कॉमा (,
) का इस्तेमाल करके तय किया जाता है
फ़िल्टर एक्सप्रेशन का इस्तेमाल किया जा सकता है.
उदाहरण: (हर यूआरएल को कोड में बदला जाना चाहिए)
देश का कोड (US या UK) है:
COUNTRY_CODE==US,COUNTRY_CODE==UK
AND लॉजिक
AND
लॉजिक, कई फ़िल्टर पैरामीटर जोड़कर हासिल किया जाता है
इस सुविधा का इस्तेमाल करके, क्लाइंट लाइब्रेरी में कई फ़िल्टर दिए जा सकते हैं.
उदाहरण:
देश का कोड US है और प्रॉडक्ट कोड AFC है:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC
AND और OR लॉजिक को जोड़ना
एक ही एक्सप्रेशन में AND और OR लॉजिक को मिलाया जा सकता है.
ध्यान दें: हर फ़िल्टर का आकलन अलग-अलग किया जाता है इससे पहले कि सभी फ़िल्टर को AND लॉजिकल एक्सप्रेशन में जोड़ा जाए.
उदाहरण:
देश का कोड (US OR UK) है और प्रॉडक्ट कोड AFC है:
filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC