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

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