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 के यूज़र इंटरफ़ेस (यूआई) में मौजूद किसी खास व्यू से जुड़ी होती है. इनकी मैपिंग करने से, आपको एपीआई डेटा को इंटरफ़ेस में दिखने वाले डेटा से मेल कराने में मदद मिल सकती है. मैपिंग की बड़ी सूची देखने के लिए, यूज़र इंटरफ़ेस (यूआई) में रिपोर्ट देखें.
यहां कुछ सामान्य मानदंड-आधारित रिपोर्ट और उनके यूज़र इंटरफ़ेस (यूआई) की सामान्य जगहें दी गई हैं:
- कैंपेन > ऑडियंस, कीवर्ड, और कॉन्टेंट > सर्च कीवर्ड: यह
keyword_viewके बराबर डेटा दिखाता है. - कैंपेन > ऑडियंस, कीवर्ड, और कॉन्टेंट > ऑडियंस > डेमोग्राफ़िक्स:
age_range_viewऔरgender_viewके बराबर डेटा दिखाता है. - कैंपेन > लोकेशन: इससे
location_viewके बराबर डेटा मिलता है.