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

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

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

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

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

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

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

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

माता-पिता के संसाधन की सेटिंग अपडेट करें

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

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

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

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

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

उस विज्ञापन देने वाले पर जाएं जिस पर आप जाना चाहते हैं. बाईं ओर मौजूद नेविगेशन में विज्ञापन देने वाले की सेटिंग मेन्यू में, बुनियादी जानकारी वाले पेज पर जाएं. स्ट्रक्चर्ड डेटा की फ़ाइलें सेक्शन में, एसडीएफ़ वर्शन के कॉन्फ़िगरेशन को 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 पर सेट करें.

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

v7 में, कॉलम के सबसेट के लिए इस्तेमाल किए जाने वाले आईडी स्पेस को अपडेट किया गया है, ताकि स्ट्रक्चर्ड डेटा फ़ाइलों को उन इकाई रीड फ़ाइलें प्रॉडक्ट से अलग किया जा सके जो अब काम नहीं करते. साथ ही, इन्हें 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 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 संसाधनों को अलग-अलग या पेजों में बांटी गई सूचियों से वापस पाएं.
DAR चैनल को मापें	Display & Video 360 API 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 से मिला ऐप्लिकेशन आईडी. साइट की लाइन के टाइप को अपडेट किया गया है, ताकि मानदंड आईडी के तौर पर यूआरएल स्ट्रिंग का इस्तेमाल किया जा सके.
ब्राउज़र लक्ष्यीकरण - निकालें ब्राउज़र लक्ष्यीकरण - शामिल करें	टारगेटिंग टाइप 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 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 संसाधनों को अलग-अलग या पेजों में बांटी गई सूचियों से वापस पाएं.
साइट लक्ष्यीकरण - निकालें साइट लक्ष्यीकरण - शामिल करें	यूआरएल स्ट्रिंग के ज़रिए साइटों की पहचान करने के लिए, इस कॉलम को अपडेट किया गया है.

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

कॉलम के लिए v7 माइग्रेशन निर्देश
चैनल लक्ष्यीकरण - निकालें चैनल लक्ष्यीकरण - शामिल करें	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 संसाधनों को अलग-अलग या पेजों में बांटी गई सूचियों से वापस पाएं.

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

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

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

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

दूसरे बदलाव

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

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

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

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

आईडी के लिए नई पहचान फ़ाइल के सुझाव

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

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

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