फ़िल्टर की गई रिपोर्ट

Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. नए एपीआई से कस्टम रिपोर्ट बनाने और डेटा को रिपोर्टिंग ऐप्लिकेशन में इंटिग्रेट करने की बेहतर सुविधा और प्रक्रियाएं शामिल हैं. Search Ads 360 के नए वर्शन की रिपोर्टिंग पर माइग्रेट करने और उसका इस्तेमाल करने के बारे में ज़्यादा जानें एपीआई.

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

उदाहरण के लिए, आपके पास किसी एजेंसी के सभी कीवर्ड की रिपोर्ट का अनुरोध करने का विकल्प है. इसके बाद तो आप एक फ़िल्टर बना कर सकते है ताकि केवल लैंडिंग पृष्ठ URL से शुरू होने वाले कीवर्ड ही रिपोर्ट में, www.example.com और www.another-example.com का इस्तेमाल किया जाएगा.

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

हर फ़िल्टर, फ़िल्टर किए जाने वाले कॉलम, एक ऑपरेटर और उन वैल्यू की सूची तय करता है जिन्हें तय किए गए कॉलम में होना चाहिए:

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
ध्यान दें: कुछ कॉलम को फ़िल्टर नहीं किया जा सकता. रिपोर्ट टाइप के हिसाब से, हर कॉलम बताता है कि अगर यह Filterable है.

फ़िल्टर ऑपरेटर

सभी फ़िल्टर केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. इसका मतलब है कि "www.Sprockets.com" वाला एक फ़िल्टर मेल नहीं खाएगा ऐसा कॉलम जिसमें "www.sprockets.com" हो.

ऑपरेटर ब्यौरा इस्तेमाल की जा सकने वाली वैल्यू की संख्या
equals कॉलम बताई गई वैल्यू से पूरी तरह मेल खाना चाहिए. 1
notEquals कॉलम तय मान से मेल नहीं खाना चाहिए. 1
in

कॉलम, फ़िल्टर की सूची में मौजूद किसी एक वैल्यू से पूरी तरह मैच करना चाहिए.

सूची डेटा टाइप के लिए मान्य नहीं है (जैसे कि String list).

अस्थिर
lessThan

कॉलम में कोई ऐसी वैल्यू होनी चाहिए जो बताई गई वैल्यू से कम हो.

अगर इस फ़िल्टर को Boolean कॉलम के लिए तय किया जाता है, तो Search Ads 360 API false को ग्राहक में बदल देता है वैल्यू, 0 और true से 1 की अंकों में होनी चाहिए. अगर आपने तो String कॉलम के लिए इस फ़िल्टर को तय करने पर, एपीआई लेक्सिकोग्राफ़िक क्रम में दिखता है.

सूची डेटा टाइप के लिए मान्य नहीं है (जैसे कि String list).

 1
greaterThan

कॉलम में कोई ऐसा मान होना चाहिए जो इसमें मौजूद किसी एक वैल्यू से बड़ा हो फ़िल्टर की सूची दिखेगी.

अगर Boolean कॉलम के लिए इस फ़िल्टर का इस्तेमाल किया जाता है, तो एपीआई false को कन्वर्ट कर देता है वैल्यू, 0 और true से 1 की अंकों में होनी चाहिए. अगर आपने तो String कॉलम के लिए इस फ़िल्टर को तय करने पर, एपीआई लेक्सिकोग्राफ़िक क्रम में दिखता है.

सूची डेटा टाइप के लिए मान्य नहीं है (जैसे कि String list).

1
lessThanOrEqual

कॉलम में कोई ऐसा मान होना चाहिए जो फ़िल्टर की सूची में मौजूद वैल्यू.

अगर Boolean कॉलम के लिए इस फ़िल्टर का इस्तेमाल किया जाता है, तो एपीआई false को कन्वर्ट कर देता है वैल्यू, 0 और true से 1 की अंकों में होनी चाहिए. अगर आपने तो String कॉलम के लिए इस फ़िल्टर को तय करने पर, एपीआई लेक्सिकोग्राफ़िक क्रम में दिखता है.

सूची डेटा टाइप के लिए मान्य नहीं है (जैसे कि String list).

1
greaterThanOrEqual

कॉलम में कोई ऐसा मान होना चाहिए जो फ़िल्टर की सूची में मौजूद वैल्यू.

अगर Boolean कॉलम के लिए इस फ़िल्टर का इस्तेमाल किया जाता है, तो एपीआई false को कन्वर्ट कर देता है वैल्यू, 0 और true से 1 की अंकों में होनी चाहिए. अगर आपने तो String कॉलम के लिए इस फ़िल्टर को तय करने पर, एपीआई लेक्सिकोग्राफ़िक क्रम में दिखता है.

सूची डेटा टाइप के लिए मान्य नहीं है (जैसे कि String list).

1
isNull कॉलम खाली होना चाहिए. उदाहरण के लिए, अगर आपने isNull कीवर्ड रिपोर्ट में keywordMaxCpc कॉलम के लिए, रिपोर्ट इसमें केवल वही कीवर्ड होंगे, जिन्होंने अधिकतम CPC तय नहीं की है. 0
isNotNull कॉलम में वैल्यू होनी चाहिए. 0
startsWith

कॉलम की शुरुआत, फ़िल्टर की सूची की किसी एक स्ट्रिंग से होनी चाहिए.

सिर्फ़ String कॉलम के लिए मान्य है.

अस्थिर
containsSubstring

कॉलम में फ़िल्टर की सूची.

उदाहरण के लिए,
वैल्यू वाला containsSubstring फ़िल्टर ["ham", "cheese"]
इस वैल्यू वाली पंक्तियां दिखाएगा:
hamburger
cheeseburger

लेकिन इन मानों वाली पंक्तियां नहीं लौटाएगा:
lobster roll
lettuce
high amplitude (high amplitude में शामिल हैं सबस्ट्रिंग "h am", लेकिन सभी वर्णों—जिसमें स्पेस शामिल हैं—का मूल्यांकन फ़िल्टर के ज़रिए किया जाता है)

सिर्फ़ String कॉलम के लिए मान्य है.

अस्थिर
doesNotContainSubstring

कॉलम में फ़िल्टर की सूची में से कोई भी स्ट्रिंग नहीं होनी चाहिए.

उदाहरण के लिए,
वैल्यू वाला doesNotContainSubstring फ़िल्टर ["ham", "cheese"]
इस वैल्यू वाली पंक्तियां दिखाएगा:
lobster roll
lettuce

लेकिन इन मानों वाली पंक्तियां नहीं लौटाएगा:
हैमबर्गर
चीज़बर्गर

सिर्फ़ String कॉलम के लिए मान्य है.

अस्थिर
containsElement

कॉलम में, फ़िल्टर की सूची की कम से कम एक वैल्यू होनी चाहिए. सिर्फ़ सूची डेटा टाइप वाले कॉलम के लिए मान्य है (जैसे कि String list).

उदाहरण के लिए, campaign रिपोर्ट में, इस वैल्यू वाला containsElement फ़िल्टर:
["foo", "bar"]
effectiveLabels कॉलम पर फ़िल्टर किया जा रहा है सिर्फ़ foo, bar या दोनों के लेबल वाले कैंपेन दिखाएगा.

अस्थिर