स्ट्रक्चर्ड डेटा फ़ाइलों और एपीआई, दोनों के साथ इंटिग्रेट करना

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

अगर पहले से स्ट्रक्चर्ड डेटा फ़ाइलों का इस्तेमाल किया जा रहा है

Display & Video 360 API का इस्तेमाल करके, एसडीएफ़ इंटिग्रेशन को बेहतर बनाएं. इसके लिए, प्रोग्राम के हिसाब से फ़ाइलें और काम का मेटाडेटा अपने-आप पाने की सुविधा का इस्तेमाल करें.

एपीआई का इस्तेमाल करके फ़ाइलें जनरेट करना और डाउनलोड करना

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

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

एपीआई का इस्तेमाल करके रेफ़रंस आईडी ढूंढना

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

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

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

एपीआई की उपलब्ध सेवाओं और तरीकों की पूरी सूची के लिए, एपीआई के रेफ़रंस से जुड़ा दस्तावेज़ पढ़ें.

मौजूदा छूट

स्ट्रक्चर्ड डेटा फ़ाइलों में इस्तेमाल किए गए कुछ रेफ़रंस आईडी, Display & Video 360 API का इस्तेमाल करके वापस नहीं पाए जा सकते:

• अफ़िनिटी और इन-मार्केट टारगेटिंग: Display & Video 360 इंटरफ़ेस से, इन कॉलम में इस्तेमाल किए गए ऑडियंस आईडी पाएं.
• कन्वर्ज़न Floodlight गतिविधि आईडी: Display & Video 360 इंटरफ़ेस से, इन कॉलम में इस्तेमाल किए गए Floodlight गतिविधि आईडी पाएं.
• इन्वेंट्री सोर्स टारगेटिंग: पब्लिश किए गए एसडीएफ़ एक्सचेंज रेफ़रंस से, इन कॉलम में इस्तेमाल किए गए एक्सचेंज आईडी पाएं. Display & Video 360 API का इस्तेमाल करके, इन कॉलम में इस्तेमाल किए गए इन्वेंट्री सोर्स आईडी और सब-एक्सचेंज आईडी पाएं.
• ऐप्लिकेशन टारगेटिंग: इन कॉलम में इस्तेमाल किए गए ऐप्लिकेशन आईडी को, ऐप्लिकेशन के प्लैटफ़ॉर्म से वापस पाएं.

अगर पहले से ही Display & Video 360 API का इस्तेमाल किया जा रहा है

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

चेतावनी: 8 सितंबर, 2025 से, आपको स्ट्रक्चर्ड डेटा फ़ाइलें अपलोड करने के लिए v9 का इस्तेमाल करना होगा. अगर विज्ञापन देने वाले व्यक्ति या कंपनी ने यह एलान किया है कि वह यूरोपियन यूनियन (ईयू) में राजनैतिक विज्ञापन नहीं दिखाएगी, तो एसडीएफ़ अपलोड करने के लिए, पिछले वर्शन का इस्तेमाल जारी रखा जा सकता है.

एसडीएफ़ अपलोड करके, YouTube और पार्टनर के संसाधनों को अपडेट करना

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

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

ज़्यादा जानकारी के लिए, एसडीएफ़ डाउनलोड करने से जुड़ी एपीआई गाइड और एसडीएफ़ अपलोड करने से जुड़ा दस्तावेज़ पढ़ें.