Search Ads Reporting API के नए वर्शन में नए कॉन्सेप्ट

Search Ads 360 Reporting API, मॉडर्न प्लैटफ़ॉर्म पर आधारित है और इसमें कई नए कॉन्सेप्ट शामिल किए गए हैं. इनके बारे में, नीचे दिए गए सेक्शन में बताया गया है.

संसाधन

रिसॉर्स ऑब्जेक्ट, रिपोर्ट टाइप की जगह लेते हैं. पहले से तय रिपोर्ट टाइप का अनुरोध करने के बजाय, अब SQL जैसी नई क्वेरी भाषा का इस्तेमाल करके सभी संसाधनों के लिए क्वेरी की जा सकती है. ज़्यादा जानने के लिए, Search Ads 360 Reporting API का स्ट्रक्चर देखें.

सर्च रिपोर्टिंग

एपीआई के नए वर्शन में, Search की अपनी सेवा मौजूद है. Search की सेवा, रिपोर्ट की लेगसी सेवा की जगह लेगी. सभी क्वेरी, SearchAds360Service से गुज़रती हैं. इसमें रिपोर्टिंग डेटा और मेट्रिक को खोजने और वापस पाने के लिए, SearchStream और Search दो तरीके उपलब्ध होते हैं. खोज के दोनों तरीके, आपकी खोज क्वेरी से मैच करने वाले सभी SearchAds360Row ऑब्जेक्ट दिखाते हैं. ज़्यादा जानकारी के लिए, सर्च रिपोर्ट बनाना लेख देखें.

संसाधन का मेटाडेटा

SearchAds360FieldService की मदद से, SearchAds360Service खोज के तरीकों में उपलब्ध संसाधनों, संसाधन फ़ील्ड, सेगमेंटेशन कुंजियों, और मेट्रिक के लिए, कैटलॉग का डाइनैमिक तौर पर अनुरोध किया जा सकता है. ज़्यादा जानने के लिए, संसाधन का मेटाडेटा पाना लेख पढ़ें.

फ़ील्ड के नाम

एपीआई में नेस्ट किए गए फ़ील्ड के नामों को शामिल किया गया है. इन्हें बिंदु के निशान से अलग किया गया है. उदाहरण के लिए, campaign.id और ad_group.id. आप और भी नेस्ट कर सकते हैं, उदाहरण के लिए,ad_group.campaign.id. ज़्यादा जानने के लिए, Search Ads 360 Reporting API का स्ट्रक्चर देखें.

Search Ads 360 के पिछले वर्शन के Reporting API में, मिलते-जुलते कॉन्सेप्ट के लिए अलग-अलग इकाइयों के अलग-अलग फ़ील्ड पर आधारित रिपोर्टिंग होती है. उदाहरण के लिए, campaign और adgroup, दोनों रिपोर्ट में एक अलग campaignId फ़ील्ड शामिल होता है.

क्वेरी लैंग्वेज

इस एपीआई में, Search Ads 360 क्वेरी लैंग्वेज का इस्तेमाल किया गया है. यह SQL जैसी एक आसान भाषा है. इसकी मदद से, अपने कारोबार के हिसाब से रिपोर्टिंग डेटा पाने के लिए क्वेरी तय की जा सकती हैं. ज़्यादा जानने के लिए, Search Ads 360 क्वेरी लैंग्वेज देखें.

अनुरोध पाना

नए एपीआई में, खोजने की अपनी सेवा (SearchAds360Service) है, लेकिन GET अनुरोध अब भी हर इकाई की खास सेवा पर मौजूद हैं. उदाहरण के लिए, CustomColumnService से कस्टम कॉलम की जानकारी मिल सकती है. ज़्यादा जानने के लिए, Search Ads 360 Reporting API में हुए बदलाव लेख पढ़ें.

कस्टम कॉलम

Search Ads 360 के नए वर्शन में, फ़ॉर्मूला कॉलम और कस्टम कन्वर्ज़न को कस्टम कॉलम कहा जाता है. कस्टम कॉलम के बारे में ज़्यादा जानें. नए CustomColumnService में कस्टम कॉलम चालू किए गए हैं. अगर आपके पास ज़रूरी अनुमतियां हैं, तो खाता ट्री में मौजूद किसी भी खाते के मालिकाना हक वाले CustomColumn संसाधनों का अनुरोध किया जा सकता है.

खाते का मैनेजमेंट

Search Ads 360 का नया वर्शन, खातों को मैनेजर खातों, सब-मैनेजर खातों, और क्लाइंट खातों के क्रम में व्यवस्थित करता है. मैनेजर खाते से एजेंसी खाते की जानकारी मिलती है. सब-मैनेजर खातों से, Search Ads 360 के पुराने वर्शन में, विज्ञापन देने वाले के खातों की जानकारी मिलती है. ज़्यादा जानने के लिए, Search Ads 360 के मैनेजर खातों के बारे में जानकारी देखें.

खाता ट्री से क्वेरी की जा सकती है. इसके बाद, हर उस खाते के लिए अनुरोध सबमिट किए जा सकते हैं जिसका डेटा आपको रिपोर्ट करना है.

खाते की हैरारकी में हुए बदलाव की वजह से, विज्ञापन देने वाले/एजेंसी के सिद्धांत से जुड़े फ़ील्ड को, सबसे सही विकल्पों से बदल दिया गया है. ऐसा इसलिए किया गया है, ताकि जहां भी मुमकिन हो, सुविधाओं के काम करने के तरीके एक जैसे हों. जिन फ़ील्ड पर असर पड़ा है और उनके विकल्पों की सूची देखने के लिए, फ़ील्ड मैपिंग देखें.

लॉगिन ग्राहक आईडी हेडर

login-customer-id एक नया हेडर है. किसी सब-मैनेजर या क्लाइंट खाते को ऐक्सेस करने के लिए, मैनेजर खाते का इस्तेमाल करते समय इस हेडर की ज़रूरत होती है. ज़्यादा जानकारी के लिए, लॉगिन ग्राहक आईडी हेडर देखें.

वर्शन

Search Ads 360 Reporting API, सेमांटिक वर्शनिंग का इस्तेमाल करता है. इसमें मुख्य और मामूली वर्शन होते हैं, जिन्हें vMAJOR_MINOR के तौर पर फ़ॉर्मैट किया जाता है. ज़्यादा जानने के लिए वर्शन देखें.