इस गाइड में, 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 क्लॉज़ में बताएं) |
---|---|
खाता | customer |
कैंपेन, कैंपेन की जानकारी |
कैंपेन |
विज्ञापन ग्रुप, विज्ञापन ग्रुप की जानकारी |
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"