स्ट्रक्चर्ड डेटा फ़ाइल v7 पर माइग्रेट करना

पिछली बार अपडेट करने की तारीख: 18-10-2023

इस गाइड में, किसी पिछले वर्शन से स्ट्रक्चर्ड डेटा फ़ाइलों (एसडीएफ़) के वर्शन 7 पर माइग्रेट करने की प्रोसेस के बारे में बताया गया है. साथ ही, इसमें उन बदलावों के बारे में भी बताया गया है जिन्हें इंटिग्रेशन को बेहतर तरीके से ऑप्टिमाइज़ करने के लिए किया जा सकता है. इनमें ज़रूरी और सुझाए गए बदलाव, दोनों शामिल हैं.

वर्शन 6 और वर्शन 7 के बीच के अंतर की पूरी सूची के लिए, रिलीज़ नोट देखें.

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

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

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

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

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

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

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

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

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

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

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

एपीआई में सेट करें

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

dataAccessConfig.sdfConfig.sdfConfig.version को SDF_VERSION_7 पर और ज़रूरत पड़ने पर, dataAccessConfig.sdfConfig.overridePartnerSdfConfig को True पर अपडेट करने के लिए, advertisers.patch अनुरोध करें.

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

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

ज़रूरी कॉलम में आईडी अपडेट करना

वर्शन 7 में, कॉलम के सबसेट का इस्तेमाल करने वाले आईडी स्पेस को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि स्ट्रक्चर्ड डेटा फ़ाइलों को, अब काम न करने वाली इकाई रीड फ़ाइल्स प्रॉडक्ट से अलग किया जा सके. साथ ही, Display & Video 360 API जैसे काम करने वाले टूल के साथ अलाइन किया जा सके.

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

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

इंसर्शन ऑर्डर

कॉलम के लिए, वर्शन 7 पर माइग्रेट करने के निर्देश
ऐप्लिकेशन टारगेटिंग - बाहर रखना ऐप्लिकेशन टारगेटिंग - शामिल करें	इन कॉलम को अपडेट किया गया है, ताकि "App Platform:App ID" फ़ॉर्मैट के हिसाब से ऐप्लिकेशन आइडेंटिफ़ायर का इस्तेमाल किया जा सके. उदाहरण के लिए: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" ऐप्लिकेशन प्लैटफ़ॉर्म की पहचान स्ट्रिंग वैल्यू से की जाती है. ऐप्लिकेशन आईडी, ऐसे आईडी होते हैं जो संबंधित प्लैटफ़ॉर्म से मिलते हैं. जैसे, Android के Play Store से मिला बंडल आईडी या Apple के App Store से मिला ऐप्लिकेशन आईडी.
ब्राउज़र टारगेटिंग - बाहर रखना ब्राउज़र टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि टारगेटिंग टाइप TARGETING_TYPE_BROWSER में, targetingOptionId Display & Video 360 API के TargetingOption संसाधनों की वैल्यू का इस्तेमाल किया जा सके. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
टेलीकॉम कंपनी के आधार पर टारगेटिंग - बाहर रखना टेलीकॉम कंपनी के आधार पर टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि टारगेटिंग टाइप TARGETING_TYPE_CARRIER_AND_ISP में, targetingOptionId Display & Video 360 API के TargetingOption संसाधनों की वैल्यू का इस्तेमाल किया जा सके. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
चैनल टारगेटिंग - बाहर रखना चैनल टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि Display & Video 360 API के Channel संसाधन की channelId वैल्यू का इस्तेमाल किया जा सके. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel संसाधनों को अलग-अलग या पेज वाली सूचियों में पाएं.
डिवाइस टारगेटिंग - बाहर रखें डिवाइस टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि इन टारगेटिंग टाइप के तहत, Display & Video 360 API के TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सके: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
डीएआर चैनल को मेज़र करना	इस कॉलम को अपडेट किया गया है, ताकि Display & Video 360 API के Channel संसाधन की channelId वैल्यू का इस्तेमाल किया जा सके. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel संसाधनों को अलग-अलग या पेज वाली सूचियों में पाएं.
साइट टारगेटिंग - बाहर रखें साइट टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि यूआरएल स्ट्रिंग की मदद से साइटों की पहचान की जा सके.

लाइन आइटम

कॉलम के लिए, वर्शन 7 पर माइग्रेट करने के निर्देश
ऐप्लिकेशन टारगेटिंग - बाहर रखना ऐप्लिकेशन टारगेटिंग - शामिल करें	इन कॉलम को अपडेट किया गया है, ताकि "App Platform:App ID" फ़ॉर्मैट के हिसाब से ऐप्लिकेशन आइडेंटिफ़ायर का इस्तेमाल किया जा सके. उदाहरण के लिए: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" ऐप्लिकेशन प्लैटफ़ॉर्म की पहचान स्ट्रिंग वैल्यू से की जाती है. ऐप्लिकेशन आईडी, ऐसे आईडी होते हैं जो संबंधित प्लैटफ़ॉर्म से मिलते हैं. जैसे, Android के Play Store से मिला बंडल आईडी या Apple के App Store से मिला ऐप्लिकेशन आईडी.
बिड मल्टीप्लायर	इस कॉलम को अपडेट किया गया है, ताकि ऐप्लिकेशन और साइट लाइन टाइप के लिए, नई शर्तों के आईडी का इस्तेमाल किया जा सके. ऐप्लिकेशन लाइन टाइप को अपडेट किया गया है, ताकि शर्तों के आईडी के लिए, ऐप्लिकेशन प्लैटफ़ॉर्म और ऐप्लिकेशन प्लैटफ़ॉर्म आईडी की कनेक्टेड स्ट्रिंग वैल्यू का इस्तेमाल किया जा सके. इन वैल्यू को कोलन से अलग किया जाता है. ऐप्लिकेशन प्लैटफ़ॉर्म की पहचान स्ट्रिंग वैल्यू से की जाती है. ऐप्लिकेशन आईडी, ऐसे आईडी होते हैं जिन्हें संबंधित प्लैटफ़ॉर्म उपलब्ध कराता है. जैसे, Android के Play Store से मिला बंडल आईडी या Apple के App Store से मिला ऐप्लिकेशन आईडी. साइट लाइन टाइप को अपडेट किया गया है, ताकि यूआरएल स्ट्रिंग का इस्तेमाल शर्तों के आईडी के तौर पर किया जा सके.
ब्राउज़र टारगेटिंग - बाहर रखना ब्राउज़र टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि टारगेटिंग टाइप TARGETING_TYPE_BROWSER में, targetingOptionId Display & Video 360 API के TargetingOption संसाधनों की वैल्यू का इस्तेमाल किया जा सके. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
टेलीकॉम कंपनी के आधार पर टारगेटिंग - बाहर रखना टेलीकॉम कंपनी के आधार पर टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि टारगेटिंग टाइप TARGETING_TYPE_CARRIER_AND_ISP में, targetingOptionId Display & Video 360 API के TargetingOption संसाधनों की वैल्यू का इस्तेमाल किया जा सके. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
चैनल टारगेटिंग - बाहर रखना चैनल टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि Display & Video 360 API के Channel संसाधन की channelId वैल्यू का इस्तेमाल किया जा सके. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel संसाधनों को अलग-अलग या पेज वाली सूचियों में पाएं.
डिवाइस टारगेटिंग - बाहर रखें डिवाइस टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि इन टारगेटिंग टाइप के तहत, Display & Video 360 API के TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सके: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.
साइट टारगेटिंग - बाहर रखें साइट टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि यूआरएल स्ट्रिंग की मदद से साइटों की पहचान की जा सके.

मीडिया प्रॉडक्ट

कॉलम के लिए, वर्शन 7 पर माइग्रेट करने के निर्देश
चैनल टारगेटिंग - बाहर रखना चैनल टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि Display & Video 360 API के Channel संसाधन की channelId वैल्यू का इस्तेमाल किया जा सके. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel संसाधनों को अलग-अलग या पेज वाली सूचियों में पाएं.
डिवाइस टारगेटिंग - शामिल करें	इस कॉलम को अपडेट किया गया है, ताकि इन टारगेटिंग टाइप के तहत, Display & Video 360 API के TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सके: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption संसाधनों को अलग-अलग या पेज की गई सूचियों में पाएं.

वर्शन 6 के बाद जोड़े गए कॉलम के साथ इंटिग्रेशन जोड़ना

अगर आपको v6 से v7 पर माइग्रेट करना है, तो आपको काम की फ़ाइलों में ये कॉलम जोड़ने होंगे:

फ़ाइल टाइप	कॉलम
लाइन आइटम	TrueView टारगेट फ़्रीक्वेंसी की गिनती
लाइन आइटम	TrueView टारगेट फ़्रीक्वेंसी टाइम विंडो
YouTube विज्ञापन समूह	ऑप्टिमाइज़ की गई टारगेटिंग

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

दूसरे बदलाव

हमने वर्शन 7 में कुछ छोटे बदलाव भी किए हैं. इनसे आपको इंटिग्रेशन को आसान बनाने में मदद मिलेगी. साथ ही, रेफ़रंस के लिए, अब काम न करने वाली इकाई की रीड फ़ाइलों का इस्तेमाल नहीं करना पड़ेगा.

कॉलम के सबसेट के लिए, सूची का नया क्रम

SDF v7, फ़ाइल जनरेट होने पर सूची के कुछ कॉलम के क्रम को स्थिर रखने की गारंटी देता है. इससे, मशीन लर्निंग मॉडल के काम करने का तरीका एक जैसा रहता है और उसे आसानी से समीक्षा किया जा सकता है. फ़ाइल अपलोड करने पर, यह क्रम लागू नहीं होता. हालांकि, अपडेट की गई फ़ाइल जनरेट करने के बाद, यह क्रम लागू हो जाता है.

v7 के रिलीज़ नोट में, उन कॉलम की पूरी सूची देखें जो अब बढ़ते क्रम में या वर्णमाला के क्रम में जनरेट किए जाते हैं.

आईडी के रेफ़रंस के नए सुझाव

हमने कई कॉलम की परिभाषाओं को अपडेट किया है, ताकि इस्तेमाल में न होने वाली इकाई की रीड फ़ाइलों का रेफ़रंस हटाया जा सके. इसके बजाय, हम आईडी लुकअप के अन्य तरीकों का सुझाव देते हैं.

यहां दिए गए कॉलम से मिली वैल्यू, SDF के वर्शन 6 से अलग नहीं हैं. हालांकि, हमारा सुझाव है कि सुझाए गए नए तरीके का इस्तेमाल करके आईडी वापस पाने के लिए, अपने इंटिग्रेशन को अपडेट करें. यह तरीका, वर्शन 7 के कॉलम के ब्यौरे में देखा जा सकता है.

फ़ाइल टाइप और उनके कॉलम
कैंपेन	इलाके के हिसाब से टारगेटिंग - बाहर रखें इलाके के हिसाब से टारगेटिंग - शामिल करें इन्वेंट्री सोर्स टारगेटिंग - बाहर रखना इन्वेंट्री सोर्स टारगेटिंग - शामिल करें भाषा के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - शामिल करें
इंसर्शन ऑर्डर	अफ़िनिटी और इन-मार्केट टारगेटिंग - बाहर रखना अफ़िनिटी और इन-मार्केट टारगेटिंग - शामिल करें ऐप्लिकेशन कलेक्शन टारगेटिंग - बाहर रखना ऐप्लिकेशन कलेक्शन टारगेटिंग - शामिल करें ऑडियंस टारगेटिंग - बाहर रखें ऑडियंस टारगेटिंग - शामिल करें कैटगरी टारगेटिंग - बाहर रखना कैटगरी टारगेटिंग - शामिल करें कॉन्टेंट की शैली के हिसाब से टारगेटिंग - बाहर रखें कॉन्टेंट की शैली के हिसाब से टारगेटिंग - शामिल करें कस्टम सूची के हिसाब से टारगेटिंग इलाके के हिसाब से टारगेटिंग - बाहर रखें इलाके के हिसाब से टारगेटिंग - शामिल करें इन्वेंट्री सोर्स टारगेटिंग - बाहर रखना इन्वेंट्री सोर्स टारगेटिंग - शामिल करें कीवर्ड की सूची के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - शामिल करें
लाइन आइटम	अफ़िनिटी और इन-मार्केट टारगेटिंग - बाहर रखना अफ़िनिटी और इन-मार्केट टारगेटिंग - शामिल करें ऐप्लिकेशन कलेक्शन टारगेटिंग - बाहर रखना ऐप्लिकेशन कलेक्शन टारगेटिंग - शामिल करें ऑडियंस टारगेटिंग - बाहर रखें ऑडियंस टारगेटिंग - शामिल करें कैटगरी टारगेटिंग - बाहर रखना कैटगरी टारगेटिंग - शामिल करें अलग-अलग सूचियों से मिलाकर ऑडियंस टारगेटिंग कॉन्टेंट की शैली के हिसाब से टारगेटिंग - बाहर रखें कॉन्टेंट की शैली के हिसाब से टारगेटिंग - शामिल करें कन्वर्ज़न Floodlight गतिविधि आईडी क्रिएटिव असाइनमेंट कस्टम सूची के हिसाब से टारगेटिंग इलाके के हिसाब से टारगेटिंग - बाहर रखें इलाके के हिसाब से टारगेटिंग - शामिल करें इन्वेंट्री सोर्स टारगेटिंग - बाहर रखना इन्वेंट्री सोर्स टारगेटिंग - शामिल करें कीवर्ड की सूची के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - शामिल करें
मीडिया प्रॉडक्ट	ऑडियंस टारगेटिंग - बाहर रखें ऑडियंस टारगेटिंग - शामिल करें कैटगरी टारगेटिंग - बाहर रखना कैटगरी टारगेटिंग - शामिल करें इलाके के हिसाब से टारगेटिंग - शामिल करें भाषा के हिसाब से टारगेटिंग - बाहर रखना भाषा के हिसाब से टारगेटिंग - शामिल करें
YouTube विज्ञापन ग्रुप	अफ़िनिटी और इन-मार्केट टारगेटिंग - बाहर रखना अफ़िनिटी और इन-मार्केट टारगेटिंग - शामिल करें ऑडियंस टारगेटिंग - बाहर रखें ऑडियंस टारगेटिंग - शामिल करें कैटगरी टारगेटिंग - बाहर रखना कैटगरी टारगेटिंग - शामिल करें कस्टम सूची के हिसाब से टारगेटिंग