यूज़र इंटरफ़ेस (यूआई) में रिपोर्ट

इस गाइड में, Google Ads यूज़र इंटरफ़ेस (यूआई) में मौजूद रिपोर्ट के कॉन्सेप्ट और उनके नाम रखने के तौर-तरीकों की जानकारी दी गई है. इन्हें रिपोर्ट में Google Ads क्वेरी लैंग्वेज (GAQL) और Google Ads API का इस्तेमाल करके जनरेट किया जा सकता है.

यूज़र इंटरफ़ेस (यूआई) की सामान्य शर्तें

नीचे दी गई टेबल में, यूज़र इंटरफ़ेस (यूआई) में इस्तेमाल किए जाने वाले कुछ सामान्य शब्दों और Google Ads Query लैंग्वेज (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 क्लॉज़ में सेगमेंट फ़ील्ड शामिल करने के तरीके के बारे में जानने के लिए, सेगमेंट करना सेक्शन देखें.

खोज नतीजों को पेजों में बांटना

यूज़र इंटरफ़ेस (यूआई) में अपनी रिपोर्ट देखने के लिए डेटा की हर टेबल के नीचे मौजूद कंट्रोल का इस्तेमाल करें. इन कंट्रोल की मदद से पेज स्विच किए जा सकते हैं और साइज़ के तय सेट से दिखाने के लिए नतीजों की संख्या चुनी जा सकती है.

GoogleAdsService.Search से next_page_token तक की रिपोर्ट फ़ेच करने के दौरान, नतीजों को पेज पर आगे बढ़ाने की सुविधा उपलब्ध होती है. किसी पेज पर नंबर डाले बिना, पूरे नतीजे के सेट को फ़ेच करने के लिए, GoogleAdsService.SearchStream का इस्तेमाल करें.

आदेश परिणाम

यूज़र इंटरफ़ेस (यूआई) में, किसी कॉलम को चुनकर नतीजों को क्रम में लगाया जा सकता है.

GAQL में, अपनी क्वेरी का नतीजा दिखाने के लिए, क्लॉज़ के हिसाब से ऑर्डर करें और LIMIT क्लॉज़ का इस्तेमाल किया जा सकता है.

फ़ॉर्मैट डाउनलोड करें

यूज़र इंटरफ़ेस (यूआई) में, रिपोर्ट अलग-अलग फ़ॉर्मैट में डाउनलोड की जा सकती हैं, जैसे कि CSV, TSV या एक्सएमएल.

एपीआई अलग-अलग फ़ॉर्मैट के साथ सीधे तौर पर, अपने आउटपुट में काम नहीं करता. इसलिए, आपको कुछ पोस्ट-प्रोसेसिंग करनी होगी. कोड का उदाहरण देखें जिसमें क्लाइंट में 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"