Search Ads 360 Reporting API एक मॉडर्न प्लैटफ़ॉर्म पर आधारित है और इसमें कई नए कॉन्सेप्ट उपलब्ध हैं. नीचे दिए गए सेक्शन में इनके बारे में बताया गया है.
रिसॉर्स
रिसॉर्स ऑब्जेक्ट, रिपोर्ट टाइप की जगह ले लेते हैं. पहले से तैयार रिपोर्ट टाइप का अनुरोध करने के बजाय, अब एसक्यूएल जैसी नई क्वेरी लैंग्वेज का इस्तेमाल करके, सभी संसाधनों के लिए क्वेरी की जा सकती है. ज़्यादा जानने के लिए, 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 API के पुराने वर्शन में, एक जैसे कॉन्सेप्ट के लिए अलग-अलग इकाइयों के आधार पर अलग-अलग फ़ील्ड पर आधारित रिपोर्टिंग होती है. उदाहरण के लिए, campaign
और adgroup
दोनों रिपोर्ट में एक अलग campaignId
फ़ील्ड शामिल होता है.
क्वेरी लैंग्वेज
यह एपीआई, Search Ads 360 की क्वेरी लैंग्वेज की सुविधा देता है. यह सुविधाजनक, SQL जैसी भाषा है. इसकी मदद से, आपके कारोबार के लिए सबसे सही रिपोर्टिंग डेटा वापस पाने के लिए, क्वेरी तय की जा सकती हैं. ज़्यादा जानने के लिए, Search Ads 360 Query Language देखें.
अनुरोध पाएं
एपीआई के नए वर्शन में, खोजने की सुविधा की अपनी सेवा (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
फ़ॉर्मैट में होते हैं. ज़्यादा जानने के लिए वर्शन देखें.