Search Ads 360 Reporting API के मुख्य कॉम्पोनेंट संसाधन और सेवाएं हैं. कोई संसाधन, Search Ads 360 इकाई को दिखाता है. साथ ही, Search Ads 360 इकाइयों को वापस पाने के लिए, किसी सेवा का इस्तेमाल किया जाता है.
ऑब्जेक्ट की हैरारकी
Search Ads 360 खाता, ऑब्जेक्ट की हैरारकी होती है.
किसी खाते का टॉप-लेवल रिसॉर्स, ग्राहक होता है.
हर खाते में एक या उससे ज़्यादा चालू कैंपेन होते हैं.
हर
Campaignमें एक या एक से ज़्यादा विज्ञापन ग्रुप होते हैं. ये आपके विज्ञापनों को लॉजिकल कलेक्शन में ग्रुप करते हैं.हर
AdGroupमें एक या उससे ज़्यादा विज्ञापन ग्रुप विज्ञापन होते हैं.किसी विज्ञापन ग्रुप या कैंपेन में एक या उससे ज़्यादा
AdGroupCriterionयाCampaignCriterionअटैच किए जा सकते हैं. शर्तों से यह तय होता है कि विज्ञापन कैसे ट्रिगर किए जाते हैं.- शर्त के कई टाइप होते हैं. जैसे, कीवर्ड, उम्र की सीमा, और जगहें. कैंपेन लेवल पर तय की गई शर्तों का असर, कैंपेन के सभी अन्य संसाधनों पर पड़ता है. आपके पास कैंपेन के लिए बजट और तारीखें तय करने का भी विकल्प होता है.
संसाधन
संसाधन, आपके Search Ads 360 खाते में मौजूद इकाइयों को दिखाते हैं. उदाहरण के लिए, Customer, Campaign, और AdGroup जैसे संसाधन.
ऑब्जेक्ट आईडी
Search Ads 360 में हर ऑब्जेक्ट की पहचान उसके आईडी से की जाती है. कुछ आईडी, दुनिया भर में यूनीक होते हैं. इसका मतलब है कि ये Search Ads 360 के सभी खातों में यूनीक होते हैं. वहीं, कुछ आईडी सिर्फ़ सीमित दायरे में यूनीक होते हैं.
| ऑब्जेक्ट आईडी के यूनीक होने का स्कोप | |
|---|---|
| बजट ID | ग्लोबल |
| कैंपेन आईडी | ग्लोबल |
| विज्ञापन समूह आईडी | ग्लोबल |
| विज्ञापन का आईडी | विज्ञापन ग्रुपहर AdGroupId / AdId पेयर दुनिया भर में यूनीक होता है. |
| AdGroupCriterion आईडी | विज्ञापन ग्रुपहर AdGroupId / CriterionId पेयर दुनिया भर में यूनीक होता है. |
| CampaignCriterion आईडी | कैंपेनहर CampaignId / CriterionId पेयर दुनिया भर में यूनीक होता है. |
| विज्ञापन एक्सटेंशन | कैंपेनहर CampaignId / AdExtensionId पेयर दुनिया भर में यूनीक होता है. |
| फ़ीड ID | ग्लोबल |
| फ़ीड आइटम का आईडी | ग्लोबल |
| फ़ीड एट्रिब्यूट आईडी | फ़ीड |
| फ़ीड मैपिंग आईडी | ग्लोबल |
| लेबल ID | ग्लोबल |
| UserList आईडी | ग्लोबल |
Search Ads 360 ऑब्जेक्ट के लिए लोकल स्टोरेज डिज़ाइन करते समय, ये आईडी नियम काम के हो सकते हैं.
ऑब्जेक्ट टाइप
कुछ ऑब्जेक्ट का इस्तेमाल, कई तरह की इकाइयों के लिए किया जा सकता है. अगर ऐसा है, तो ऑब्जेक्ट में type फ़ील्ड होता है, जिसमें उसके कॉन्टेंट के बारे में जानकारी होती है. उदाहरण के लिए,
AdGroupAd से टेक्स्ट विज्ञापन, होटल विज्ञापन या स्थानीय विज्ञापन का पता चल सकता है.
टाइप की वैल्यू को AdGroupAd.ad.type फ़ील्ड से ऐक्सेस किया जा सकता है. इसकी वैल्यू, AdType एनम में दिखती है.
संसाधन के नाम
हर रिसॉर्स की पहचान, resource_name स्ट्रिंग से की जाती है. यह स्ट्रिंग, रिसॉर्स और उसके पैरंट को एक पाथ में जोड़ती है.
उदाहरण के लिए, कैंपेन के संसाधनों के नाम इस फ़ॉर्मैट में होते हैं:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
ग्राहक आईडी 1234567 वाले Search Ads 360 खाते में, आईडी 987654 वाले कैंपेन में resource_name है:
customers/1234567/campaigns/987654
सेवाएं
सेवाओं की मदद से, Search Ads 360 की इकाइयों और मेटाडेटा को वापस लाया जा सकता है. सेवा के तीन टाइप होते हैं:
- Search की सेवा
SearchAds360Service, सभी संसाधन ऑब्जेक्ट और परफ़ॉर्मेंस के आंकड़े पाने के लिए एक ही सेवा है. इसमें दो तरीके दिए गए हैं:SearchऔरSearchStream. दोनों तरीकों के लिए, एक ऐसी क्वेरी की ज़रूरत होती है जिसमें क्वेरी करने के लिए संसाधन, फिर से पाने के लिए संसाधन के एट्रिब्यूट और परफ़ॉर्मेंस मेट्रिक, अनुरोध को फ़िल्टर करने के लिए इस्तेमाल किए जाने वाले प्रीडिकेट, और परफ़ॉर्मेंस के आंकड़ों को और बेहतर तरीके से समझने के लिए इस्तेमाल किए जाने वाले सेगमेंट की जानकारी हो. ज़्यादा जानकारी के लिए, सर्च रिपोर्ट बनाना और Search Ads 360 की क्वेरी भाषा देखें.- फ़ील्ड सेवा
SearchAds360FieldService, संसाधनों के बारे में मेटाडेटा को फिर से पाता है. जैसे, किसी संसाधन के लिए उपलब्ध एट्रिब्यूट और उसका डेटा टाइप.SearchAds360Serviceखोज के तरीकों में उपलब्ध संसाधनों, संसाधन फ़ील्ड, सेगमेंटेशन की कुंजियों, और मेट्रिक के लिए कैटलॉग का अनुरोध किया जा सकता है. ज़्यादा जानने के लिए, संसाधन का मेटाडेटा पाना देखें.- इकाई के हिसाब से सेवाएं
ये सेवाएं,
GETअनुरोध का एक ऐसा तरीका उपलब्ध कराती हैं जिससे किसी एक संसाधन का उदाहरण वापस मिलता है. यह किसी रिसॉर्स के स्ट्रक्चर की जांच करने में मददगार होता है.इकाई के हिसाब से मिलने वाली सेवाओं के उदाहरणों में ये शामिल हैं:
- CustomColumnService, अनुरोध किए गए कस्टम कॉलम की पूरी जानकारी दिखाता है.