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