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