Search Ads 360 रिपोर्टिंग एपीआई स्ट्रक्चर

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 खातों में यूनीक होते हैं. वहीं, कुछ आईडी सिर्फ़ सीमित दायरे में यूनीक होते हैं.

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 जो अनुरोध किए गए कस्टम कॉलम की पूरी जानकारी देता है.