इस गाइड में, Google Ads यूज़र इंटरफ़ेस (यूआई) में मौजूद रिपोर्ट के कॉन्सेप्ट और नाम रखने के नियमों को उन रिपोर्ट से मैप किया गया है जिन्हें Google Ads क्वेरी लैंग्वेज (GAQL) और Google Ads API का इस्तेमाल करके जनरेट किया जा सकता है.
यूज़र इंटरफ़ेस (यूआई) से जुड़ी सामान्य शर्तें
नीचे दी गई टेबल में, यूज़र इंटरफ़ेस (यूआई) में इस्तेमाल होने वाले कुछ सामान्य शब्दों और Google Ads क्वेरी लैंग्वेज (GAQL) में उनकी मैपिंग के बारे में बताया गया है.
यूज़र इंटरफ़ेस (यूआई) | GAQL |
---|---|
कॉलम | GAQL क्वेरी के SELECT क्लॉज़ में मौजूद कोई भी संसाधन, सेगमेंट फ़ील्ड या मेट्रिक. |
तारीख की सीमा | तारीख की सीमाएं, segments.date पर फ़िल्टर करने वाले WHERE
क्लॉज़ से मैप होती हैं. |
फ़िल्टर | WHERE क्लॉज़ में एक या उससे ज़्यादा शर्तें. |
सेगमेंट फ़ील्ड | अपनी GAQL क्वेरी में सेगमेंट फ़ील्ड शामिल करके, सेगमेंटेशन लागू करें. |
पेजेशन | पेज, क्वेरी के नतीजे के सेट को कई पेजों में बांट देता है. |
कॉलम
यूज़र इंटरफ़ेस (यूआई) में मौजूद कॉलम, GAQL में रिसॉर्स फ़ील्ड, सेगमेंट फ़ील्ड, और मेट्रिक के बराबर होते हैं.
फ़िल्टर करना
समय अवधियां
Google Ads के यूज़र इंटरफ़ेस (यूआई) में, खाते के आंकड़े दिखाने वाली टेबल होती है. साथ ही, इन आंकड़ों की तारीख की सीमा को कंट्रोल करने के लिए एक ड्रॉप-डाउन मेन्यू होता है.
GAQL क्वेरी के WHERE क्लॉज़ में segments.date
पर फ़िल्टर करके, GAQL में भी यही कंट्रोल किया जा सकता है.
फ़िल्टर
यूज़र इंटरफ़ेस (यूआई) में मौजूद फ़िल्टर, GAQL के WHERE क्लॉज़ में मौजूद एक या उससे ज़्यादा शर्तों के बराबर होते हैं.
सेगमेंट करने की सुविधा
ज़्यादा जानकारी वाले आंकड़ों के लिए, डेटा को सेगमेंट के हिसाब से बांटा जा सकता है. उदाहरण के लिए, हो सकता है कि आपको Google Display Network के मुकाबले, Google Search Network से मिले इंप्रेशन की संख्या अलग से देखनी हो. इस मामले में, आपको अपनी रिपोर्ट को नेटवर्क के हिसाब से सेगमेंट में बांटना होगा. SELECT क्लॉज़ में सेगमेंट फ़ील्ड शामिल करने का तरीका जानने के लिए, सेगमेंटेशन देखें.
पेज पर नंबर डालना
डेटा की हर टेबल के सबसे नीचे मौजूद कंट्रोल का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) में अपनी रिपोर्ट में नेविगेट किया जा सकता है. इन कंट्रोल की मदद से, पेजों को स्विच किया जा सकता है और तय किए गए साइज़ के सेट में से, दिखाए जाने वाले नतीजों की संख्या चुनी जा सकती है.
next_page_token
की मदद से, GoogleAdsService.Search
वाली रिपोर्ट को खोजते समय, नतीजों को पेज करके देखा जा सकता है. पेजेशन के बिना पूरा नतीजा सेट फ़ेच करने के लिए, GoogleAdsService.SearchStream
का इस्तेमाल करें.
नतीजों का क्रम
यूज़र इंटरफ़ेस (यूआई) में, किसी कॉलम को चुनकर नतीजों का क्रम तय किया जा सकता है.
GAQL में, क्वेरी के नतीजे को क्रम से लगाने के लिए, ORDER BY क्लॉज़ और LIMIT क्लॉज़ का इस्तेमाल किया जा सकता है.
डाउनलोड करने के फ़ॉर्मैट
यूज़र इंटरफ़ेस (यूआई) में, रिपोर्ट को कई फ़ॉर्मैट में डाउनलोड किया जा सकता है. जैसे, CSV, TSV या XML.
एपीआई अपने आउटपुट में अलग-अलग फ़ॉर्मैट के साथ सीधे तौर पर काम नहीं करता. इसलिए, आपको आउटपुट को प्रोसेस करना होगा. क्लाइंट में CSV फ़ॉर्मैटिंग लागू करने का तरीका दिखाने वाला कोड उदाहरण देखें.
रिपोर्ट शेड्यूल करना और उन्हें ईमेल करना
रिपोर्ट को शेड्यूल करने और ईमेल करने की सुविधा, यूज़र इंटरफ़ेस (यूआई) में उपलब्ध है. हालांकि, यह सुविधा एपीआई में काम नहीं करती.
पहले से तय रिपोर्टें
Google Ads के यूज़र इंटरफ़ेस (यूआई) में, पहले से तैयार की गई रिपोर्ट की सूची बनाई जा सकती है.
यहां पहले से तय की गई बुनियादी रिपोर्ट और उनसे मैच होने वाले GAQL रिसॉर्स के नाम की सूची दी गई है.
पहले से तय बुनियादी रिपोर्ट | GAQL रिसॉर्स का नाम (FROM क्लॉज़ में बताएं) |
---|---|
खाता | ग्राहक |
कैंपेन, कैंपेन की जानकारी |
कैंपेन |
विज्ञापन ग्रुप, विज्ञापन ग्रुप की जानकारी |
ad_group |
विज्ञापन, फ़ाइनल यूआरएल |
ad_group_ad |
सर्च कीवर्ड | keyword_view |
खोज के लिए शब्द | search_term_view |
पेड और ऑर्गैनिक | paid_organic_search_term_view |
लैंडिंग पेज | landing_page_view |
बड़ा किया गया लैंडिंग पेज | expanded_landing_page_view |
ऊपर दी गई टेबल के उदाहरण के तौर पर, खाता रिपोर्ट जनरेट करने के लिए, यहां दिए गए GAQL का इस्तेमाल किया जा सकता है:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
आम अंतर
यूज़र इंटरफ़ेस (यूआई) की रिपोर्ट और एपीआई की रिपोर्ट की तुलना करने पर, सबसे आम अंतर यह है कि यूआई, हटाई गई इकाइयों को अपने-आप फ़िल्टर कर देता है, जबकि एपीआई ऐसा नहीं करता.
डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) व्यू को दोहराने के लिए, आपको एक फ़िल्टर जोड़ना होगा. आम तौर पर, हटाई गई पंक्तियों को बाहर रखने के लिए, status
फ़ील्ड का इस्तेमाल किया जाता है. उदाहरण के लिए:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"