एपीआई वर्कफ़्लो

इस गाइड में, Deal Sync API का इस्तेमाल करके डील बनाने, रद्द करने, वापस पाने, अपडेट करने, और बातचीत करने के लिए, एपीआई के सामान्य वर्कफ़्लो के बारे में बताया गया है.

कोई डील बनाना

1. externalDealId फ़िल्टर का इस्तेमाल करके, LIST प्रॉडक्ट को कॉल करके देखें कि कोई प्रॉडक्ट पहले से तो नहीं बनाया गया है. ध्यान दें कि फ़िल्टर स्ट्रिंग में, camelCase externalDealId और snake_case external_deal_id, दोनों का इस्तेमाल किया जा सकता है. external_deal_id की वैल्यू, सभी प्रॉडक्ट के लिए यूनीक होनी चाहिए.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. Create Order. ऑर्डर का नाम DV360 जनरेट करता है. हमारा सुझाव है कि इस आईडी को अपने सिस्टम में सेव करें, ताकि इसे बाद में वापस पाया जा सके.

3. ऑर्डर के तहत प्रॉडक्ट बनाएं. प्रॉडक्ट का नाम DV360 जनरेट करता है. हमारा सुझाव है कि इस आईडी को अपने सिस्टम में सेव करें, ताकि इसे बाद में वापस पाया जा सके.

इसके अलावा, external_deal_id पर कॉल करके भी LIST से संपर्क किया जा सकता है. संसाधन के नाम में ऑर्डर आईडी और प्रॉडक्ट आईडी, दोनों शामिल होते हैं. इसलिए, पैरंट ऑर्डर की पहचान की जा सकती है.

कोई डील रद्द करना

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

किसी डील की जानकारी पाना

1. किसी ऑर्डर की जानकारी पाएं. उपयोगकर्ता के ऑर्डर को स्वीकार करने, संग्रहित करने या रद्द करने के बाद, स्थिति अपडेट हो जाती है.
2. किसी प्रॉडक्ट की जानकारी पाएं.

ऑफ़र की सूची पाना

1. LIST ऑर्डर के लिए स्टेटस फ़िल्टर का इस्तेमाल करके, स्वीकार किए गए या स्वीकार किए जाने बाकी ऑर्डर की सूची पाएं.
2. LIST external_deal_id फ़िल्टर वाले प्रॉडक्ट.
3. LIST किसी ऑर्डर में मौजूद सभी प्रॉडक्ट.

किसी डील को अपडेट करना

1. अपडेट करें पब्लिशर की संपर्क जानकारी के लिए अनुरोध.
   1. name को अपडेट नहीं किया जा सकता (इसे updateMask में सेट नहीं किया जा सकता). एपीआई का इस्तेमाल करके, स्टेटस को सिर्फ़ CANCELED पर सेट किया जा सकता है.
   2. partner_id को अपडेट नहीं किया जा सकता.
2. अपडेट करें किसी खास डील की अवधि के लिए प्रॉडक्ट अपडेट करें.
   1. name, externalDealId, transactionType, pricingType, और updateTime को अपडेट नहीं किया जा सकता.
   2. displayName को अपडेट करने के लिए, उपयोगकर्ता को फिर से सहमति देने की ज़रूरत नहीं होती.
   3. rateDetails या creativeConfig को अपडेट करने पर, पैरंट ऑर्डर का स्टेटस बदलकर PENDING_ACCEPTANCE हो जाता है. विज्ञापन देने वाले DV360 उपयोगकर्ताओं या कंपनियों को, बातचीत वाले पेज पर नई शर्तें स्वीकार करने के लिए कहा जाएगा. भले ही, पिछले ऑर्डर को पहले ही स्वीकार कर लिया गया हो.

देखें कि उपयोगकर्ता ने डील स्वीकार की है या नहीं

1. अगर आपको ऑर्डर का नाम पता है, तो Get Order का इस्तेमाल करें. status फ़ील्ड देखें.
2. अगर ऑर्डर के नाम को ट्रैक नहीं किया गया है, तो: external_deal_id फ़िल्टर का इस्तेमाल करके प्रॉडक्ट की सूची बनाएं, प्रॉडक्ट के नाम से ऑर्डर का नाम पहचानें, और फिर Get Order को कॉल करें. status फ़ील्ड देखें.

देखें कि उपयोगकर्ता ने डील को कॉन्फ़िगर किया है या नहीं (सिर्फ़ प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस की गारंटी के लिए)

1. Get Inventory Source. संसाधन का नाम exchanges/{exchangeId}/inventorysources/{external_deal_id} है. खरीदार की स्थिति देखें.
   1. रिज़र्वेशन वाले ऑफ़र:
      1. BUYER_STATUS_ACTIVE: डील स्वीकार कर ली गई है और इसे कॉन्फ़िगर कर दिया गया है. DV360 को डील की शर्तों से मेल खाने वाली बिड रिक्वेस्ट मिलने पर, डील के लिए खर्च करना शुरू कर दिया जाएगा. डील कॉन्फ़िगरेशन के दौरान, लाइन आइटम अपने-आप जनरेट होता है. ज़्यादा जानकारी के लिए, डील कॉन्फ़िगरेशन देखें.
      2. BUYER_STATUS_PENDING: ऑर्डर स्वीकार कर लिया गया है, लेकिन डील को अब तक कॉन्फ़िगर नहीं किया गया है. इस राज्य में कोई खर्च नहीं हुआ.
      3. BUYER_STATUS_PAUSED: विज्ञापन देने वाले व्यक्ति या कंपनी ने डील को कुछ समय के लिए रोक दिया है. इस राज्य में कोई खर्च नहीं हुआ.
   2. बिना रिज़र्वेशन वाले ऑफ़र:
      1. BUYER_STATUS_ACTIVE: डील स्वीकार कर ली गई है. डील पर खर्च तब शुरू होगा, जब DV360 को मैच करने वाली बिड रिक्वेस्ट मिलेंगी, कोई चालू लाइन आइटम डील को टारगेट करेगा, और बिड रिक्वेस्ट, लाइन आइटम की टारगेटिंग की शर्तों से मेल खाएंगी. ज़्यादा जानकारी के लिए, लाइन आइटम देखें. (ध्यान दें: कोई ऐसा Seller API नहीं है जिससे यह पता लगाया जा सके कि किसी डील को लाइन आइटम के हिसाब से टारगेट किया गया है या नहीं).
      2. BUYER_STATUS_PENDING: यह सुविधा, बिना रिज़र्वेशन वाले ऑफ़र पर लागू नहीं होती.
      3. BUYER_STATUS_PAUSED: विज्ञापन देने वाले व्यक्ति या कंपनी ने डील को साफ़ तौर पर रोक दिया है. इस राज्य में कोई खर्च नहीं हुआ.

ऑफ़र स्वीकार करने के बाद, किसी डील को रोकना और फिर से शुरू करना

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

फिर से बातचीत करना (डील स्वीकार होने के बाद उसे अपडेट करना)

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

अनुमति वाले और अनुमति नहीं वाले बदलाव

डील की बातचीत और फिर से बातचीत करने के नियमों के बारे में पूरी जानकारी पाने के लिए, Display & Video 360 के सहायता केंद्र के ये लेख पढ़ें:

• प्रोग्राम के हिसाब से गारंटीड डील पर फिर से बातचीत करना
• Display & Video 360 में डील पर बातचीत करना