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क्लॉज़ जोड़कर, नतीजों की संख्या को कंट्रोल करें. - पुष्टि करना: यह टूल, आपको मान्य फ़ील्ड कॉम्बिनेशन के बारे में बताता है. साथ ही, यह एपीआई एक्सप्लोरर से भी लिंक होता है, ताकि आप अपने खाते में मौजूद डेटा के हिसाब से अपनी क्वेरी की जांच कर सकें. इसके अलावा, एक अलग क्वेरी वैलिडेटर भी है. इसमें, मैन्युअल तरीके से लिखी गई GAQL क्वेरी चिपकाकर उनकी जांच की जा सकती है.
- एक्सपोर्ट करें: क्वेरी से संतुष्ट होने के बाद, जांच की गई और सिंटैक्टिक तौर पर सही GAQL स्ट्रिंग को कॉपी करें और उसे अपने
GoogleAdsService.SearchयाSearchStreamक्लाइंट अनुरोधों में चिपकाएं.
बिल्डर यह पक्का करता है कि चुने गए फ़ील्ड, सेगमेंट, और मेट्रिक एक-दूसरे के साथ काम करते हों. साथ ही, उन्हें एक ही क्वेरी में इस्तेमाल किया जा सकता हो. इसके लिए, Google Ads API के बुनियादी मेटाडेटा का रेफ़रंस दिया जाता है.
अपनी प्रोफ़ाइल बनाना शुरू करें
क्वेरी बिल्डर पर जाने के दो तरीके हैं: रिपोर्टिंग के रेफ़रंस दस्तावेज़ में किसी पेज पर जाएं या क्वेरी बिल्डर की खास जानकारी देने वाले पेज से एक्सप्लोर करें.
रिपोर्टिंग के रेफ़रंस दस्तावेज़ों से
- रिपोर्टिंग के रेफ़रंस दस्तावेज़ से शुरुआत करें. इसके बाद, सभी संसाधनों की सूची में जाकर, कोई संसाधन चुनें. इसके अलावा, बाईं ओर मौजूद नेविगेशन पैनल से सीधे संसाधन पर जाएं.
- क्वेरी बनाने में मेरी मदद करो पर क्लिक करें. इससे आपको उस संसाधन के लिए क्वेरी बिल्डर पर ले जाया जाएगा.
क्वेरी बिल्डर की खास जानकारी देने वाले पेज से
रिपोर्टिंग के रेफ़रंस दस्तावेज़ों के क्वेरी बिल्डर सेक्शन पर जाएं. इसके बाद, वह संसाधन चुनें जिसके बारे में आपको जानना है.
अन्य टूल के साथ इंटिग्रेशन
क्वेरी बिल्डर को Google Ads API डेवलपर टूलकिट के अन्य टूल के साथ इंटिग्रेट किया गया है. क्वेरी बिल्डर में बनाई गई क्वेरी को एपीआई एक्सप्लोरर में टेस्ट किया जा सकता है. इसके अलावा, क्वेरी की पुष्टि करने वाले टूल की मदद से इसकी पुष्टि की जा सकती है.
API एक्सप्लोरर
क्वेरी बनाने के बाद, API Explorer में आज़माएं पर क्लिक करें. इससे आपकी क्वेरी, API Explorer में खुल जाएगी. आपकी क्वेरी, अनुरोध के मुख्य हिस्से में अपने-आप भर जाती है. इसके बाद, अपने खाते में मौजूद डेटा के हिसाब से क्वेरी चलाकर, उसकी जांच की जा सकती है. उस टूल के बारे में ज़्यादा जानने के लिए, एपीआई एक्सप्लोरर देखें.
क्वेरी वैलिडेटर
क्वेरी डालें या उसमें बदलाव करें पर क्लिक करने पर, क्वेरी की पुष्टि करने वाला टूल खुलता है. अपनी क्वेरी के सिंटैक्स की पुष्टि करने के लिए, क्वेरी वैलिडेटर का इस्तेमाल करें. क्वेरी बिल्डर का इस्तेमाल करके बनाई गई किसी भी क्वेरी में पहले से ही सही सिंटैक्स होता है. हालांकि, अगर आपको उस संसाधन के बारे में पता है जिसके लिए क्वेरी की जा रही है, तो क्वेरी की पुष्टि करने वाला टूल, क्वेरी डालने और उसकी वैधता की जांच करने का तेज़ तरीका उपलब्ध कराता है. उस टूल के बारे में ज़्यादा जानने के लिए, क्वेरी वैलिडेटर देखें.