Google Ads API में, हर क्राइटेरिया रिपोर्ट को एक अलग संसाधन से दिखाया जाता है.
जब तक ज़रूरी न हो, *_view संसाधनों में सिर्फ़ resource_name फ़ील्ड होता है.
अगर किसी शर्त के हिसाब से डेटा फ़ेच करना है, तो Google Ads API क्लाइंट को उससे जुड़े ad_group_criterion या campaign_criterion फ़ील्ड की जानकारी देनी होगी.
हर व्यू, अपने टारगेटिंग लेवल से मैच करने वाले क्राइटेरिया रिसॉर्स से जुड़ता है. उदाहरण के लिए, keyword_view, ad_group_criterion से जुड़ता है, जबकि location_view, campaign_criterion से जुड़ता है. इससे Google Ads API क्लाइंट, GoogleAdsService.SearchStream तरीके के लिए एक ही अनुरोध में ad_group_criterion या campaign_criterion फ़ील्ड और *_view रिसॉर्स का अनुरोध कर सकते हैं.
क्वेरी के अनुरोध का सैंपल
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
किसी खास तरह की शर्त के लिए परफ़ॉर्मेंस डेटा (मेट्रिक) पाने के लिए, FROM क्लॉज़ में उससे जुड़े व्यू रिसॉर्स की जानकारी दें. उदाहरण के लिए, कीवर्ड मेट्रिक पाने के लिए, FROM क्लॉज़ में keyword_view और SELECT क्लॉज़ में metrics फ़ील्ड का इस्तेमाल करें.
शर्तों के व्यू से, पैरंट रिसॉर्स से लेकर customer तक के फ़ील्ड चुने जा सकते हैं. उदाहरण के लिए, FROM keyword_view को चुनते समय, इन सभी संसाधनों से फ़ील्ड का अनुरोध किया जा सकता है:
ad_group_criterionad_groupcampaigncustomer
किसी संसाधन के लिए इस तरह से अनुरोध किए जा सकने वाले संसाधनों के बारे में जानने के लिए, उसके रेफ़रंस पेज की एट्रिब्यूट किए गए संसाधन लाइन देखें. उदाहरण के लिए, keyword_view के लिए, इसके संसाधनों को इसके रेफ़रंस पेज पर देखा जा सकता है.
यूज़र इंटरफ़ेस (यूआई) पर मैप करना
हर क्राइटेरिया रिपोर्ट, Google Ads के यूज़र इंटरफ़ेस (यूआई) में मौजूद किसी खास व्यू से जुड़ी होती है. इन्हें मैप करने से, एपीआई डेटा को इंटरफ़ेस में दिखने वाले डेटा के साथ मैच करने में मदद मिल सकती है. मैपिंग की बड़ी सूची देखने के लिए, यूज़र इंटरफ़ेस (यूआई) में रिपोर्ट देखें.
यहां कुछ सामान्य क्राइटेरिया-आधारित रिपोर्ट और उनके सामान्य यूज़र इंटरफ़ेस (यूआई) की जगहें दी गई हैं:
- कैंपेन > ऑडियंस, कीवर्ड, और कॉन्टेंट > Search Network वाले विज्ञापनों के कीवर्ड: यह
keyword_viewके बराबर डेटा दिखाता है. - कैंपेन > ऑडियंस, कीवर्ड, और कॉन्टेंट > ऑडियंस > डेमोग्राफ़िक्स:
यह
age_range_viewऔरgender_viewके बराबर डेटा दिखाता है. - कैंपेन > जगहें: इससे
location_viewके बराबर डेटा मिलता है.