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