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

कोई डील बनाना

1. देखें कि क्या बाहरी डील का आईडी [external_deal_id] फ़िल्टर का इस्तेमाल करके, LIST प्रॉडक्ट से कोई प्रॉडक्ट पहले ही बनाया जा चुका है. External_deal_id की वैल्यू, सभी प्रॉडक्ट के लिए यूनीक होनी चाहिए.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. इन्वेंट्री सोर्स पाएं. नाम ‘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 को ऐसा बिड अनुरोध मिलता है जो डील की शर्तों से मेल खाता हो, इस डील को टारगेट करने वाला कोई लाइन आइटम चालू हो, और बिड अनुरोध, लाइन आइटम को टारगेट करने की शर्तों से मेल खाता हो, तब डील को इस स्थिति में माना जाता है. ज़्यादा जानकारी के लिए, लाइन आइटम देखें.** यह क्वेरी करने के लिए कोई सेलर एपीआई नहीं है कि क्या किसी डील को लाइन आइटम से टारगेट किया गया है. **
      2. BUYER_STATUS_PENDINGलागू नहीं है.
      3. BUYER_STATUS_PAUSEDका मतलब है कि विज्ञापन देने वाले लोगों या कंपनियों ने डील को साफ़ तौर पर रोक दिया है. इस स्थिति में कोई खर्च नहीं होगा.

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

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

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

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

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

अलग-अलग डील फ़ेज़ में, अनुमति वाले और अनुमति न होने वाले बदलावों के बारे में जानने के लिए, यहां जाएं.