इस पेज का अनुवाद Cloud Translation API से किया गया है.

स्ट्रक्चर्ड डेटा फ़ाइलों के वर्शन 8 पर माइग्रेट करना

पिछली बार अपडेट करने की तारीख: 12-11-2024

इस गाइड में, स्ट्रक्चर्ड डेटा फ़ाइलों के वर्शन 7.1 से 8 पर माइग्रेट करने की प्रोसेस के बारे में बताया गया है. साथ ही, इन दोनों वर्शन के बीच हुए उन बदलावों के बारे में भी बताया गया है जिनका आपके इंटिग्रेशन पर असर पड़ सकता है.

v7.1 और v8 के बीच के अंतर की पूरी सूची के लिए, रिलीज़ नोट देखें.

स्ट्रक्चर्ड डेटा फ़ाइलों के वर्शन को माइग्रेट करना

किसी पुराने वर्शन से स्ट्रक्चर्ड डेटा फ़ाइलों (एसडीएफ़) के वर्शन 8 पर माइग्रेट करने के लिए:

v8 का इस्तेमाल करने के लिए, अपने संसाधनों और एसडीएफ़ जनरेशन ऐक्शन को अपडेट करें.
विज्ञापन संसाधन लॉजिक को अपडेट करें, ताकि बनाने के बाद किसी टाइप की पहचान की जा सके.
मांग बढ़ाने में मदद करने वाले संसाधनों को पढ़ने, बनाने, और अपडेट करने के लिए नया लॉजिक जोड़ें.

स्ट्रक्चर्ड डेटा फ़ाइलों का वर्शन अपडेट करना

स्ट्रक्चर्ड डेटा फ़ाइलों के नए वर्शन का इस्तेमाल करने के लिए, अपने पैरंट पार्टनर और विज्ञापन देने वाले के संसाधनों में असाइन किया गया वर्शन अपडेट करें. साथ ही, Display & Video 360 API में अलग-अलग डाउनलोड टास्क बनाते समय, नए वर्शन का इस्तेमाल करें.

पैरंट रिसॉर्स की सेटिंग अपडेट करना

स्ट्रक्चर्ड डेटा फ़ाइलों का डिफ़ॉल्ट वर्शन, पार्टनर और विज्ञापन देने वाले के संसाधन के लेवल पर सेट होता है. इंटरफ़ेस या एपीआई के ज़रिए स्ट्रक्चर्ड डेटा फ़ाइलें डाउनलोड करते समय, इस वर्शन का इस्तेमाल डिफ़ॉल्ट तौर पर किया जाता है.

इंटरफ़ेस में सेट करना

पार्टनर लेवल पर

अपने पसंदीदा पार्टनर पर जाएं.
बाईं ओर मौजूद नेविगेशन में, पार्टनर सेटिंग मेन्यू को बड़ा करें और सामान्य जानकारी पेज पर जाएं.
स्ट्रक्चर्ड डेटा फ़ाइलें सेक्शन में, SDF वर्शन कॉन्फ़िगरेशन को v8 पर अपडेट करें.

विज्ञापन देने वाले के लेवल पर

विज्ञापन देने वाले के खाते पर जाएं.
बाईं ओर मौजूद नेविगेशन में, विज्ञापन देने वाले की सेटिंग मेन्यू को बड़ा करें और सामान्य जानकारी पेज पर जाएं.
स्ट्रक्चर्ड डेटा फ़ाइलें सेक्शन में, SDF वर्शन कॉन्फ़िगरेशन को v8 पर अपडेट करें. अगर डिफ़ॉल्ट वर्शन को पार्टनर लेवल पर सेट किया गया है, तो हो सकता है कि इस सेटिंग में बदलाव न किया जा सके.

एपीआई में सेट किया गया

पार्टनर के लेवल पर: एपीआई में पार्टनर लेवल पर, SDF का डिफ़ॉल्ट वर्शन सेट नहीं किया जा सकता.
विज्ञापन देने वाले के लेवल पर: dataAccessConfig.sdfConfig.sdfConfig.version को SDF_VERSION_8 पर और ज़रूरत पड़ने पर, dataAccessConfig.sdfConfig.overridePartnerSdfConfig को True पर अपडेट करने के लिए, advertisers.patch अनुरोध करें.

एपीआई में `sdfdownloadtasks.create` अनुरोध अपडेट करना

Display & Video 360 API का इस्तेमाल करके sdfdownloadtasks.create अनुरोध करते समय, अनुरोध के मुख्य हिस्से के version फ़ील्ड को SDF_VERSION_8 पर सेट करें.

विज्ञापन संसाधनों में टाइप की जानकारी देना

v8, विज्ञापन फ़ाइलों में Ad Type कॉलम जोड़ता है. इससे हर पंक्ति में दिखाए गए विज्ञापन का टाइप पता चलता है. यह नया कॉलम ज़रूरी है. साथ ही, विज्ञापन की v8 फ़ाइलें डाउनलोड करते समय, मौजूदा संसाधनों के लिए इसे अपने-आप जानकारी भर जाएगी.

मौजूदा विज्ञापनों को अपडेट करते समय, इस कॉलम की वैल्यू में बदलाव नहीं किया जाना चाहिए.

नए विज्ञापन बनाते समय, आपको इस कॉलम में कॉलम के ब्यौरे में दी गई किसी एक वैल्यू को डालना होगा.

मांग बढ़ाने में मदद करने वाले संसाधनों के लिए लॉजिक अपडेट करना

v8 वर्शन, लाइन आइटम, विज्ञापन ग्रुप, और विज्ञापन फ़ाइलों का इस्तेमाल करके, मांग बढ़ाने में मदद करने वाले कैंपेन बनाने, उन्हें वापस पाने, और अपडेट करने की सुविधा देता है. मांग जनरेट करने वाले संसाधन, टाइमस्टैंप की पुष्टि के लिए अलग लॉजिक का इस्तेमाल करते हैं. साथ ही, इनमें अतिरिक्त कॉलम की जानकारी भरने की ज़रूरत होती है. साथ ही, ये तीनों तरह की फ़ाइलों पर लागू होने वाली नई पाबंदियों से सीमित होते हैं.

टाइमस्टैंप की पुष्टि करना

मांग बढ़ाने में मदद नहीं करने वाले सभी लाइन आइटम के लिए, लाइन आइटम फ़ाइल के Timestamp कॉलम में, डाउनलोड करने के दौरान वह तारीख अपने-आप भर जाती है जब आखिरी बार लाइन आइटम में बदलाव किया गया था. इस वैल्यू का इस्तेमाल, SDF का इस्तेमाल करके लाइन आइटम को अपडेट करते समय किया जाता है. इससे यह पुष्टि की जाती है कि ओरिजनल फ़ाइल डाउनलोड होने के बाद, लाइन आइटम को अपडेट नहीं किया गया है. ऐसा होने पर, अपडेट नहीं हो पाता.

मांग बढ़ाने में मदद करने वाले लाइन आइटम के लिए, Timestamp कॉलम और उससे जुड़ी पुष्टि अलग तरीके से काम करती है. मांग बढ़ाने में मदद करने वाले कैंपेन के लाइन आइटम की एंट्री के लिए, कॉलम में डाउनलोड के समय का मौजूदा समय दिखता है. अपलोड करने पर, Display & Video 360 यह जांच करता है कि दिए गए टाइमस्टैंप के बाद 24 घंटे से ज़्यादा हो गए हैं या नहीं. अगर 24 घंटे से ज़्यादा हो चुके हैं, तो मूल फ़ाइल की एंट्री को पुराना माना जाता है और अपडेट नहीं हो पाता. अगर ऐसा होता है, तो फ़ाइल को फिर से डाउनलोड करें और नए वर्शन के आधार पर अपडेट करें. पुष्टि करने का यह नया तरीका, पिछले 24 घंटों में किए गए बदलावों को बदलने से नहीं रोकता. गलती से किसी मौजूदा लाइन आइटम को बदलने से बचने के लिए, अपलोड की जाने वाली फ़ाइलों में सिर्फ़ वे मांग बढ़ाने में मदद करने वाले लाइन आइटम शामिल करें जिन्हें आपको अपडेट करना है.

ज़रूरी कॉलम

यहां दिए गए फ़ाइल टाइप में ऐसे कॉलम होते हैं जो अब कुछ मांग जनरेट करने वाले संसाधनों के लिए ज़रूरी हैं. साथ ही, इनमें ऐसे कॉलम भी होते हैं जो उस फ़ाइल टाइप की सभी इकाइयों के लिए ज़रूरी होते हैं.

लाइन आइटम

यहां दी गई लाइन आइटम Type कॉलम वैल्यू के लिए ज़रूरी कॉलम

विज्ञापन की मांग बढ़ाने में मदद करने वाला विज्ञापन चैनल

Pacing Amount

TrueView Bid Strategy Type

TrueView Bid Strategy Value

अपडेट की गई पाबंदियां

मांग बढ़ाने में मदद करने वाले कुछ लाइन आइटम और विज्ञापनों के लिए ज़रूरी नए कॉलम के अलावा, लाइन आइटम, विज्ञापन ग्रुप, और विज्ञापन फ़ाइल टाइप के कई कॉलम में, मांग बढ़ाने में मदद करने वाले संसाधनों पर लागू होने वाली, इस्तेमाल से जुड़ी नई पाबंदियां हैं.

ये पाबंदियां कई हैं और इनमें से हर पाबंदी किसी कॉलम पर लागू होती है. इसलिए, इस गाइड में पाबंदियों की पूरी सूची नहीं दी गई है. हमारा सुझाव है कि आप SDF अपलोड का इस्तेमाल करके, मांग बढ़ाने वाले संसाधन बनाने या अपडेट करने से पहले, लाइन आइटम, विज्ञापन ग्रुप, और विज्ञापन फ़ाइल टाइप के लिए, v8 रेफ़रंस दस्तावेज़ को ध्यान से पढ़ें.