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

स्ट्रक्चर्ड डेटा फ़ाइलें (एसडीएफ़) और 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 इंटिग्रेशन के साथ काम करने के लिए, SDF का इस्तेमाल करें. इसके लिए, एक साथ कई फ़ाइलें बनाकर और YouTube और Partners के संसाधनों को अपडेट करके, इनका इस्तेमाल करें.

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

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

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

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