इस पेज का अनुवाद Cloud Translation API से किया गया है.

फ़िल्टर करना

filters क्वेरी स्ट्रिंग पैरामीटर, AdSense मैनेजमेंट एपीआई रिपोर्ट में दिखने वाले डेटा को सीमित करता है. 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 लॉजिक को फ़िल्टर एक्सप्रेशन के अंदर कॉमा (,) का इस्तेमाल करके तय किया जाता है.

उदाहरण: (हर यूआरएल, कोड में बदला हुआ होना चाहिए)

देश का कोड (अमेरिका या यूनाइटेड किंगडम) है:
COUNTRY_CODE==US,COUNTRY_CODE==UK

AND लॉजिक

AND लॉजिक को एक से ज़्यादा फ़िल्टर पैरामीटर देकर हासिल किया जाता है. इससे क्लाइंट लाइब्रेरी में कई फ़िल्टर मिलते हैं.

उदाहरण:

देश का कोड अमेरिका है और प्रॉडक्ट कोड AFC है:
filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

AND और OR लॉजिक को जोड़ना

AND और OR लॉजिक को एक ही एक्सप्रेशन में जोड़ा जा सकता है.

ध्यान दें: सभी फ़िल्टर को AND लॉजिकल एक्सप्रेशन में जोड़े जाने से पहले, हर फ़िल्टर का अलग-अलग आकलन किया जाता है.