स्ट्रक्चर्ड डेटा फ़ाइलें (एसडीएफ़), खास तौर पर फ़ॉर्मैट की गई CSV फ़ाइलें होती हैं. इनकी मदद से, Display & Video 360 में एक साथ कई संसाधनों को वापस पाया जा सकता है, बनाया जा सकता है, और उनमें बदलाव किया जा सकता है. एसडीएफ़ डाउनलोड करके, उनमें बदलाव करके, और फिर से अपलोड करके, एक साथ कई संसाधनों को अपडेट करें.
Display & Video 360 का यूज़र इंटरफ़ेस (यूआई), एसडीएफ़ डाउनलोड और अपलोड करने की सुविधा देता है. Display & Video 360 API, एसडीएफ़ डाउनलोड करने की सुविधा देता है.
फ़ॉर्मैट
एसडीएफ़, दो में से किसी एक फ़ॉर्मैट का इस्तेमाल करता है: स्टैंडर्ड और QA:
- स्टैंडर्ड फ़ॉर्मैट की फ़ाइलें डाउनलोड और अपलोड की जा सकती हैं. इन फ़ाइलों में मौजूद डेटा में, संख्या वाले आईडी का इस्तेमाल किया जा सकता है. इससे अपलोड करने के बाद डेटा सटीक बना रहता है. डेटा को समझने के लिए, रेफ़रंस जानकारी की ज़रूरत पड़ सकती है.
- QA फ़ॉर्मैट वाली फ़ाइलें डाउनलोड की जा सकती हैं. इन फ़ाइलों में स्टैंडर्ड फ़ॉर्मैट वाली फ़ाइलों जैसा ही डेटा होता है. हालांकि, इनमें ऐसी वैल्यू का इस्तेमाल किया जाता है जिन्हें कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए, कुछ कॉलम में आईडी की जगह डिसप्ले नेम का इस्तेमाल किया जा सकता है. इस फ़ॉर्मैट के लिए खास तौर पर बनाए गए कॉलम में, "Qa" सफ़िक्स का इस्तेमाल किया जाता है.
फ़ाइल टाइप
एसडीएफ़ में सात तरह के संसाधन इस्तेमाल किए जा सकते हैं. हर संसाधन टाइप का अपना फ़ाइल टाइप होता है. साथ ही, उसका अपना कॉलम स्ट्रक्चर होता है. इन रिसॉर्स टाइप का इस्तेमाल किया जा सकता है:
- कैंपेन
- इंसर्शन ऑर्डर
- लाइन आइटम
- विज्ञापन ग्रुप
- विज्ञापन
- इन्वेंट्री स्रोत
- मीडिया प्रॉडक्ट
सिर्फ़ लाइन आइटम और विज्ञापन ग्रुप फ़ाइल टाइप, QA फ़ॉर्मैट के साथ काम करते हैं.
एसडीएफ़ के नए वर्शन नियमित तौर पर रिलीज़ किए जाते हैं और पुराने वर्शन का इस्तेमाल बंद कर दिया जाता है. नए वर्शन में, फ़ाइल टाइप कॉलम के स्ट्रक्चर को अपडेट किया गया है. ज़रूरत पड़ने पर, एसडीएफ़ के नए वर्शन में लॉन्च के समय माइग्रेशन गाइड शामिल होगी.
डाउनलोड त्रुटियां
एसडीएफ़ डाउनलोड करने पर, दो तरह की गड़बड़ियां हो सकती हैं: फ़ाइल जनरेट करने से जुड़ी गड़बड़ियां और छोड़े गए संसाधन.
फ़ाइल जनरेट करने से जुड़ी गड़बड़ियां
एसडीएफ़ जनरेट करने की प्रोसेस में गड़बड़ी हो सकती है. अगर Display & Video 360 API का इस्तेमाल करते समय जनरेट करने में समस्या आती है, तो पूरा हो चुका टास्क, Status ऑब्जेक्ट के साथ error फ़ील्ड सेट करेगा. Status ऑब्जेक्ट में, गड़बड़ी की वजह के बारे में जानकारी देने वाला मैसेज शामिल होगा.
इन गड़बड़ियों के बारे में ज़्यादा जानने के लिए, हमारे गड़बड़ियों और चेतावनियों से जुड़ी गाइड वाले पेज पर जाएं.
छोड़ी गई गड़बड़ियां
एसडीएफ़, सभी संसाधन सबटाइप के साथ काम नहीं करते. अगर किसी संसाधन को एसडीएफ़ में शामिल नहीं किया जा सकता, तो डाउनलोड में "छोड़ी गई" फ़ाइल (उदाहरण: SDF-LineItems-Skipped.csv) शामिल की जाएगी. इस फ़ाइल में दो कॉलम होते हैं. पहले कॉलम में, छोड़े गए संसाधन की पहचान की जाती है. दूसरे कॉलम में, उन्हें शामिल न करने की वजह बताई गई है.
फ़ाइल अपलोड करें
नए संसाधन बनाने या मौजूदा संसाधनों को अपडेट करने के लिए, Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एसडीएफ़ अपलोड करें.
एसडीएफ़ की मदद से संसाधनों को अपडेट करते समय या उन्हें बनाते समय गड़बड़ियों को कम करने के लिए, यह तरीका अपनाएं:
- Display & Video 360 API या यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एसडीएफ़ डाउनलोड करें.
- मौजूदा रिसॉर्स में बदलाव करने के लिए, मौजूदा फ़ाइल एंट्री में बदलाव करें.
- नए संसाधन बनाने के लिए, फ़ाइल की एंट्री जोड़ें.
- ऐसी सभी एंट्री हटाएं जो नई या अपडेट नहीं की गई हैं. इससे फ़ाइल का साइज़ कम हो जाता है और अनचाहे अपडेट होने की संभावना खत्म हो जाती है.
- Display & Video 360 के यूज़र इंटरफ़ेस (यूआई) में फ़ाइल अपलोड करें.
एसडीएफ़ अपलोड और प्रोसेस होने के बाद, डाउनलोड करने के लिए SDF-ResultFile.zip फ़ाइल उपलब्ध होती है. इस ZIP फ़ाइल में दो तरह की फ़ाइलें हो सकती हैं:
SDF-{ResourceType}-Updated-ResultFile.csvपर क्लिक करें. इसमें, अपडेट किए गए या बनाए गए संसाधनों की सूची होती है.SDF-{ResourceType}-Failed-ResultFile.csvमें, उन कार्रवाइयों की सूची होती है जो पूरी नहीं हो सकीं. साथ ही, इसमें गड़बड़ी के मैसेज भी होते हैं.
ZIP फ़ाइल में एक या दोनों फ़ाइलें हो सकती हैं.