Google Ads क्वेरी बिल्डर एक इंटरैक्टिव टूल है. इसे इस तरह से डिज़ाइन किया गया है कि इसकी मदद से, Google Ads क्वेरी लैंग्वेज (GAQL) का इस्तेमाल करके क्वेरी को इंटरैक्टिव तरीके से बनाया और पुष्टि किया जा सके. चाहे आप GAQL का इस्तेमाल पहली बार कर रहे हों या पहले से इसका इस्तेमाल कर रहे हों, क्वेरी बिल्डर की मदद से, Google Ads API से अपनी ज़रूरत का डेटा आसानी से फ़ेच किया जा सकता है.
फ़ायदे
- इस्तेमाल में आसान: इससे GAQL क्वेरी लिखने की प्रोसेस आसान हो जाती है. इसके लिए, खास सिंटैक्स और उपलब्ध फ़ील्ड के बारे में जानकारी होना ज़रूरी नहीं है.
- खोजने में आसानी: इससे Google Ads API के डेटा मॉडल में उपलब्ध संसाधनों, फ़ील्ड, सेगमेंट, और मेट्रिक को एक्सप्लोर और खोजने में मदद मिलती है.
- गड़बड़ियों में कमी: स्ट्रक्चर्ड इंटरफ़ेस और मान्य विकल्पों वाले ड्रॉप-डाउन मेन्यू उपलब्ध कराने से, सिंटैक्स की गड़बड़ियों और टाइपिंग की गलतियों को रोकने में मदद मिलती है. इससे यह पक्का किया जा सकता है कि जनरेट की गई क्वेरी मान्य हो.
- क्वेरी तेज़ी से बनाना: क्वेरी स्ट्रिंग जनरेट करने की प्रोसेस को अपने-आप होने वाली सुविधा के ज़रिए तेज़ किया जाता है. इससे डेवलपमेंट प्रोसेस में लगने वाला समय कम हो जाता है.
- पुष्टि करना: यह टूल, API Explorer और Query Validator से लिंक होता है. इससे क्वेरी को लागू करने से पहले, एपीआई के नियमों के हिसाब से उनकी जांच की जाती है.
यह कैसे काम करता है
Google Ads क्वेरी बिल्डर, GAQL क्वेरी को विज़ुअल तरीके से असेंबल करने के लिए, उपयोगकर्ता के लिए आसान इंटरफ़ेस उपलब्ध कराता है. यहां बुनियादी वर्कफ़्लो दिया गया है:
- कोई संसाधन चुनें: आपको उस वर्शन के लिए रेफ़रंस टैब से प्राइमरी संसाधन चुनना होगा जिसके बारे में आपको क्वेरी करनी है. यह संसाधन,
FROMक्लॉज़ में होगा. संसाधन, Google Ads में मौजूद इकाइयों को दिखाते हैं. जैसे,campaign,ad_groupयाkeyword_view. बिल्डर में, सभी उपलब्ध संसाधन दिखते हैं. - फ़ील्ड चुनें: किसी संसाधन को चुनने के बाद, यह टूल चुनने लायक सभी फ़ील्ड दिखाता है. इनमें उस संसाधन और उससे जुड़े (अपने-आप जुड़ने वाले) संसाधनों से जुड़े एट्रिब्यूट, सेगमेंट, और मेट्रिक शामिल होती हैं.
SELECTक्लॉज़ में फ़ील्ड शामिल करने के लिए, चेक बॉक्स चुने जा सकते हैं. आपके चुने गए विकल्पों के आधार पर, यह टूल GAQL क्वेरी स्ट्रिंग को डाइनैमिक तरीके से जनरेट करता है. साथ ही, गड़बड़ियां दिखाता है और ऐसे फ़ील्ड कॉम्बिनेशन को फ़िल्टर करता है जिनका इस्तेमाल नहीं किया जा सकता. - फ़िल्टर लागू करें: नतीजों को फ़िल्टर करने के लिए,
WHEREक्लॉज़ की शर्तें जोड़ी जा सकती हैं. बिल्डर की मदद से, फ़ील्ड, ऑपरेटर, और वैल्यू चुनी जा सकती हैं. इससे सही सिंटैक्स का इस्तेमाल किया जा सकता है. - नतीजों को क्रम से लगाना:
ORDER BYक्लॉज़ का इस्तेमाल करके, नतीजों को क्रम से लगाने का तरीका तय करें. - सीमाएं तय करना: नतीजों की संख्या को कंट्रोल करने के लिए,
LIMITक्लॉज़ जोड़ें. - पुष्टि करना: यह टूल, आपको मान्य फ़ील्ड कॉम्बिनेशन के बारे में बताता है. साथ ही, यह API Explorer से भी लिंक होता है, ताकि आप अपने खाते में मौजूद डेटा के हिसाब से अपनी क्वेरी की जांच कर सकें. इसके अलावा, एक अलग क्वेरी की पुष्टि करने वाला टूल भी है. इसमें, GAQL क्वेरी को चिपकाकर उनकी जांच की जा सकती है.
- एक्सपोर्ट करें: क्वेरी से संतुष्ट होने के बाद, सिंटैक्टिक रूप से सही GAQL स्ट्रिंग को कॉपी करें और उसे अपने
GoogleAdsService.SearchयाSearchStreamक्लाइंट अनुरोधों में चिपकाएं.
बिल्डर यह पक्का करता है कि चुने गए फ़ील्ड, सेगमेंट, और मेट्रिक एक-दूसरे के साथ काम करते हों. साथ ही, उन्हें एक ही क्वेरी में इस्तेमाल किया जा सकता हो. इसके लिए, Google Ads API के मेटाडेटा का इस्तेमाल किया जाता है.
अपनी प्रोफ़ाइल बनाना शुरू करें
क्वेरी बिल्डर पर जाने के दो तरीके हैं. इसके लिए, रिपोर्टिंग के रेफ़रंस दस्तावेज़ में मौजूद किसी पेज पर जाएं. इसके अलावा, क्वेरी बिल्डर की खास जानकारी वाले पेज पर जाकर भी यह काम किया जा सकता है.
रिपोर्टिंग के रेफ़रंस दस्तावेज़ों से
- रिपोर्टिंग के रेफ़रंस दस्तावेज़ से शुरुआत करें. इसके बाद, सभी संसाधनों की सूची में जाकर, कोई संसाधन चुनें. इसके अलावा, बाईं ओर मौजूद नेविगेशन पैनल से सीधे संसाधन पर जाएं.
- क्वेरी बनाने में मेरी मदद करो पर क्लिक करें. इससे आपको उस संसाधन के लिए क्वेरी बिल्डर पर ले जाया जाएगा.
क्वेरी बिल्डर की खास जानकारी देने वाले पेज से
रिपोर्टिंग के रेफ़रंस दस्तावेज़ों के क्वेरी बिल्डर सेक्शन पर जाएं. इसके बाद, वह संसाधन चुनें जिसके बारे में आपको जानकारी चाहिए.
अन्य टूल के साथ इंटिग्रेशन
क्वेरी बिल्डर को Google Ads API डेवलपर टूलकिट के अन्य टूल के साथ इंटिग्रेट किया गया है. क्वेरी बिल्डर में बनाई गई क्वेरी को एपीआई एक्सप्लोरर में टेस्ट किया जा सकता है. इसके अलावा, क्वेरी की पुष्टि करने वाले टूल की मदद से इसकी पुष्टि की जा सकती है.
API एक्सप्लोरर
क्वेरी बनाने के बाद, API Explorer में आज़माएं पर क्लिक करके, API Explorer में अपनी क्वेरी खोलें. आपकी क्वेरी, अनुरोध के मुख्य हिस्से में अपने-आप भर जाएगी. इसके बाद, अपने खाते में मौजूद डेटा के हिसाब से क्वेरी चलाकर, उसे टेस्ट किया जा सकता है. उस टूल के बारे में ज़्यादा जानने के लिए, एपीआई एक्सप्लोरर देखें.
क्वेरी की पुष्टि करने वाला प्रोग्राम
क्वेरी डालें या उसमें बदलाव करें पर क्लिक करने पर, क्वेरी की पुष्टि करने वाला टूल खुलता है. अपनी क्वेरी के सिंटैक्स की पुष्टि करने के लिए, क्वेरी वैलिडेटर का इस्तेमाल करें. क्वेरी बिल्डर की मदद से बनाई गई किसी भी क्वेरी में पहले से ही सही सिंटैक्स होता है. हालांकि, अगर आपको उस संसाधन के बारे में पता है जिसके लिए क्वेरी की जा रही है, तो क्वेरी की पुष्टि करने वाला टूल, क्वेरी डालने और उसकी वैधता की जांच करने का तेज़ तरीका उपलब्ध कराएगा. उस टूल के बारे में ज़्यादा जानने के लिए, क्वेरी वैलिडेटर देखें.