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