इस गाइड में, 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 डिसप्ले नेटवर्क से अलग, Google Search Network के लिए इंप्रेशन की संख्या देखनी है. ऐसे में, अपनी रिपोर्ट को नेटवर्क के हिसाब से सेगमेंट करें. SELECT क्लॉज़ में सेगमेंट फ़ील्ड शामिल करने का तरीका जानने के लिए, सेगमेंटेशन देखें.
पेज पर नंबर डालना
यूज़र इंटरफ़ेस (यूआई) में अपनी रिपोर्ट पर जाएं. इसके लिए, डेटा की हर टेबल के सबसे नीचे मौजूद कंट्रोल का इस्तेमाल करें. इनकी मदद से, पेजों के बीच स्विच किया जा सकता है. साथ ही, तय किए गए साइज़ के सेट से, दिखाए जाने वाले नतीजों की संख्या चुनी जा सकती है.
GoogleAdsService.Search
से लेकर next_page_token
तक की रिपोर्ट वापस पाने पर, नतीजों को पेज के हिसाब से देखा जा सकता है. बिना पेज नंबर के नतीजों का पूरा सेट फ़ेच करने के लिए, GoogleAdsService.SearchStream
का इस्तेमाल करें.
नतीजों को क्रम से लगाना
यूज़र इंटरफ़ेस (यूआई) में, किसी कॉलम को चुनकर नतीजों को क्रम से लगाया जा सकता है.
GAQL में, क्वेरी के नतीजे को क्रम से लगाने के लिए, ORDER BY क्लॉज़ और LIMIT क्लॉज़ का इस्तेमाल किया जा सकता है.
डाउनलोड करने के फ़ॉर्मैट
यूज़र इंटरफ़ेस (यूआई) में, रिपोर्ट को CSV, TSV या XML जैसे अलग-अलग फ़ॉर्मैट में डाउनलोड किया जा सकता है.
एपीआई, आउटपुट में अलग-अलग फ़ॉर्मैट को सीधे तौर पर सपोर्ट नहीं करता. इसलिए, आपको कुछ पोस्ट-प्रोसेसिंग करनी होगी. यहां कोड का उदाहरण दिया गया है. इसमें बताया गया है कि क्लाइंट में CSV फ़ॉर्मैटिंग कैसे लागू करें.
रिपोर्ट शेड्यूल करना और उन्हें ईमेल करना
यूज़र इंटरफ़ेस (यूआई) से रिपोर्ट को शेड्यूल किया जा सकता है और ईमेल किया जा सकता है. हालांकि, ये सुविधाएं एपीआई में काम नहीं करती हैं.
पहले से तय रिपोर्ट
Google Ads के यूज़र इंटरफ़ेस (यूआई) में, पहले से तय की गई रिपोर्ट की सूची बनाई जा सकती है.
यहां पहले से तय की गई बुनियादी रिपोर्ट और उनसे मेल खाने वाले GAQL रिसॉर्स के नाम की सूची दी गई है.
पहले से तय बुनियादी रिपोर्ट | GAQL संसाधन का नाम (इसे FROM क्लॉज़ में तय करें) |
---|---|
खाता | customer |
Campaign, Campaign details |
कैंपेन |
विज्ञापन ग्रुप, विज्ञापन ग्रुप की जानकारी |
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"