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

डील बनाना

1. देखें कि क्या external_deal_id फ़िल्टर के साथ LIST प्रॉडक्ट की मदद से, कोई प्रॉडक्ट पहले से ही बनाया गया है या नहीं. External_deal_id, सभी प्रॉडक्ट के लिए यूनीक होना चाहिए.

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

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

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

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

ऑफ़र रद्द करना

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

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

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

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

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

डील अपडेट करना

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

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

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

देखें कि उपयोगकर्ता ने डील को कॉन्फ़िगर किया है या नहीं(सिर्फ़ PG के लिए)

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

स्वीकार करने के बाद, डील को रोकना/रोक हटाना

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

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

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

किन बदलावों की अनुमति है और किनकी नहीं.

हम सभी फ़ील्ड में बदलाव करने की अनुमति देते हैं. हालांकि, startTime, endTime, rateDetails, creativeConfig वगैरह जैसे कुछ ज़रूरी फ़ील्ड में बदलाव करने की अनुमति नहीं है. हम इन ज़रूरी फ़ील्ड की पुष्टि करते हैं. आम तौर पर, creativeConfig को छोड़कर इन फ़ील्ड में अपडेट करने की अनुमति तब ही दी जाती है, जब डील शुरू होने का समय कम से कम एक दिन बाद का हो. फ़्लाइट के दौरान मिलने वाले ऑफ़र के लिए, सिर्फ़ इंक्रीमेंटल अपडेट की अनुमति है. इन ऑफ़र के लिए, शुरू होने का समय बीत चुका है, लेकिन खत्म होने का समय आने वाला है. जिन डील की समयसीमा खत्म हो चुकी है उनमें कोई बदलाव नहीं किया जा सकता. उदाहरण के लिए, एक साल पहले पूरे हो चुके किसी डील का rateDetails अपडेट करने की अनुमति नहीं है. इस तरह के मामलों में, DV3 अपडेट प्रॉडक्ट, पुष्टि करने से जुड़ी गड़बड़ी दिखाएगा.