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

पिछला अपडेट: 18-10-2023

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

v6 और v7 के बीच अंतर की पूरी जानकारी पाने के लिए प्रॉडक्ट की जानकारी देखें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

प्रविष्टि आदेश

v7 कॉलम के लिए माइग्रेशन निर्देश
ऐप्लिकेशन टारगेटिंग - बाहर रखें ऐप्लिकेशन टारगेटिंग - शामिल करें	ऐप्लिकेशन आइडेंटिफ़ायर का इस्तेमाल करने के लिए, "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 में Display & Video 360 API TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सकता है. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
टेलीकॉम कंपनी के आधार पर टारगेट करना - बाहर रखें कैरियर लक्ष्यीकरण - शामिल करें	इस कॉलम को अपडेट करके, टारगेटिंग टाइप TARGETING_TYPE_CARRIER_AND_ISP में Display & Video 360 API TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सकता है. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
चैनल टारगेटिंग - बाहर रखें चैनल टारगेटिंग - शामिल करें	Display & Video 360 एपीआई Channel संसाधन की वैल्यू का इस्तेमाल channelId करने के लिए, इस कॉलम को अपडेट किया गया है. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel रिसॉर्स को अलग-अलग या पेज पर नंबर वाली सूचियों में डालें.
डिवाइस टारगेटिंग - बाहर रखें डिवाइस टारगेटिंग - शामिल करें	इस कॉलम को अपडेट कर दिया गया है, ताकि इसका इस्तेमाल Display & Video 360 एपीआई TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल करने के लिए किया जा सके. ये वैल्यू, यहां टारगेटिंग के टाइप में दी गई हैं: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
DAR चैनल को मापें	Display & Video 360 एपीआई Channel संसाधन की वैल्यू का इस्तेमाल channelId करने के लिए, इस कॉलम को अपडेट किया गया है. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel रिसॉर्स को अलग-अलग या पेज पर नंबर वाली सूचियों में डालें.
साइट लक्ष्यीकरण - बहिष्कृत करें साइट लक्ष्यीकरण - शामिल करें	यूआरएल स्ट्रिंग के ज़रिए साइटों की पहचान करने के लिए, इस कॉलम को अपडेट किया गया है.

लाइन आइटम

v7 कॉलम के लिए माइग्रेशन निर्देश
ऐप्लिकेशन टारगेटिंग - बाहर रखें ऐप्लिकेशन टारगेटिंग - शामिल करें	ऐप्लिकेशन आइडेंटिफ़ायर का इस्तेमाल करने के लिए, "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 से मिला ऐप्लिकेशन आईडी. यूआरएल स्ट्रिंग को मानदंड आईडी के तौर पर इस्तेमाल करने के लिए, site लाइन टाइप को अपडेट किया गया है.
ब्राउज़र टारगेटिंग - बाहर रखें ब्राउज़र टारगेटिंग - शामिल करें	इस कॉलम को अपडेट करके, टारगेटिंग टाइप TARGETING_TYPE_BROWSER में Display & Video 360 API TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सकता है. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
टेलीकॉम कंपनी के आधार पर टारगेट करना - बाहर रखें कैरियर लक्ष्यीकरण - शामिल करें	इस कॉलम को अपडेट करके, टारगेटिंग टाइप TARGETING_TYPE_CARRIER_AND_ISP में Display & Video 360 API TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल किया जा सकता है. targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
चैनल टारगेटिंग - बाहर रखें चैनल टारगेटिंग - शामिल करें	Display & Video 360 एपीआई Channel संसाधन की वैल्यू का इस्तेमाल channelId करने के लिए, इस कॉलम को अपडेट किया गया है. advertisers.channels और partners.channels सेवाओं का इस्तेमाल करके, Channel रिसॉर्स को अलग-अलग या पेज पर नंबर वाली सूचियों में डालें.
डिवाइस टारगेटिंग - बाहर रखें डिवाइस टारगेटिंग - शामिल करें	इस कॉलम को अपडेट कर दिया गया है, ताकि इसका इस्तेमाल Display & Video 360 एपीआई TargetingOption संसाधनों की targetingOptionId वैल्यू का इस्तेमाल करने के लिए किया जा सके. ये वैल्यू, यहां टारगेटिंग के टाइप में दी गई हैं: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM targetingTypes.targetingOptions सेवा का इस्तेमाल करके, TargetingOption रिसॉर्स को अलग-अलग या पेज पर बांटी गई सूचियों में फिर से पाएं.
साइट लक्ष्यीकरण - बहिष्कृत करें साइट लक्ष्यीकरण - शामिल करें	यूआरएल स्ट्रिंग के ज़रिए साइटों की पहचान करने के लिए, इस कॉलम को अपडेट किया गया है.

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

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

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

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

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

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

दूसरे बदलाव

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

कुछ कॉलम के लिए नई सूची का क्रम

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

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

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

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

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

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