सर्च टर्म वे शब्द हैं जो लोगों ने सचमुच टाइप किए, उन कीवर्ड के उलट जो आपने ख़रीदे थे। दोनों के बीच का फ़ासला ही वह जगह है जहाँ ज़्यादातर बर्बाद ख़र्च रहता है, और उसे पढ़ना एक ऐसी कॉल है जो कुछ बदल ही नहीं सकती।
कॉल
curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \ -H "X-API-KEY: $MAKEHYBRID_KEY" \ --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \ --data-urlencode 'max_rows=200'
क्वेरी Google Ads Query Language (GAQL) में है, और जो कुछ Google रिपोर्ट करेगा वह इसी तरह माँगा जा सकता है: कैंपेन, विज्ञापन समूह, कीवर्ड, विज्ञापन, एसेट, बजट, कन्वर्ज़न, ऑडियंस, बदलावों का इतिहास। हर जवाब में 200 पंक्तियों तक।
जवाब को कैसे पढ़ें
- लागत micros में है: 1,000,000 micros खाते की मुद्रा की एक इकाई है। जिस टर्म की लागत 4,310,000 थी, वह 4.31 का रहा।
- तीस दिनों में जिस टर्म पर ख़र्च है और कन्वर्ज़न नहीं, वह सबसे पहले देखने की चीज़ है, और आम जवाब बिड बदलना नहीं बल्कि नेगेटिव कीवर्ड है।
- GET क्वेरी को URL में लेता है; उसी पते पर POST उसे बॉडी में लेता है, उस क्वेरी के लिए जो इतनी लंबी हो कि URL में न समाए। दोनों सिर्फ़ पढ़ते हैं।
इस रेसिपी में कुछ भी खाते को बदल नहीं सकता। रिपोर्ट एक पढ़ना है, और जो कॉल कुछ बदलती है वह दूसरी है, जिसके सिरे पर कोई व्यक्ति बैठा है।
लोग क्या पूछते हैं
क्या मुझे GAQL आना ज़रूरी है?
हाथ से क्वेरी लिखने के लिए हाँ, और वह SQL से इतनी मिलती है कि बिना सीखे भी पढ़ी जा सकती है। व्यवहार में इस कुंजी वाला AI एजेंट आपके शब्दों में माँगी बात से क्वेरी लिखता है, उसे चलाता है, और पंक्तियाँ आपको पढ़कर सुना देता है।
micros क्यों?
Google पैसे इसी तरह रिपोर्ट करता है, इसलिए यहाँ जवाब भी इसी तरह आता है: दस लाखवें हिस्सों की पूर्ण संख्या, जिससे मुद्रा के अंश इधर-उधर करने पर होने वाली राउंडिंग से बचाव होता है। दस लाख से भाग दीजिए तो वह रक़म मिलती है जो कोई इंसान बोलता।
क्या रिपोर्ट खाते को छू सकती है?
नहीं। रिपोर्ट की कॉल SELECT के अलावा हर चीज़ ठुकरा देती है, इसलिए इसमें से ऐसी कोई क्वेरी गुज़र ही नहीं सकती जो खाते को बदले — यहाँ ग़लती की क़ीमत बस एक उलझा देने वाला जवाब है, और कुछ नहीं।