बाज़ारस्थल API

खास जानकारी

Authorized Buyers मार्केटप्लेस एपीआई, संसाधनों का एक कलेक्शन है. इसका इस्तेमाल करके, खरीदार इन संसाधनों को प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए मैनेज कर सकते हैं:

  • पब्लिशर के साथ बातचीत करना
  • नीलामी पैकेज
  • Authorized Buyers मार्केटप्लेस के यूज़र इंटरफ़ेस (यूआई) को क्लाइंट के लिए ऐक्सेस करना

इस गाइड में Marketplace API के बारे में जानकारी दी गई है. साथ ही, यह भी बताया गया है कि किस तरह से Marketplace API के संसाधन, Authorized Buyers के यूज़र इंटरफ़ेस (यूआई) में Marketplace की सुविधाओं के साथ मैप किए जाते हैं.

बिड करने वाले और खरीदार

Marketplace API, रीयल-टाइम बिडिंग एपीआई के स्ट्रक्चर से मेल खाता है. दोनों एपीआई, बिड करने और खरीदार से जुड़ी कार्रवाइयों के लिए, रूट-लेवल के संसाधनों के तौर पर bidders और buyers का इस्तेमाल करते हैं. रीयल-टाइम बिडिंग और मार्केटप्लेस एपीआई के लिए, रिसॉर्स पाथ में बिड करने वाले और खरीदार के एक ही नाम का इस्तेमाल किया जा सकता है.

से ऐक्सेस करने के लिए, रीयल-टाइम बिडिंग एपीआई का इस्तेमाल करें.

क्लाइंट और क्लाइंट उपयोगकर्ता

क्लाइंट और क्लाइंट उपयोगकर्ता बनाने और मैनेज करने के लिए Marketplace API का इस्तेमाल किया जा सकता है. साथ ही, इसका इस्तेमाल Authorized Buyers यूज़र इंटरफ़ेस (यूआई) में, प्रोग्राम के हिसाब से एजेंसियों या विज्ञापन देने वालों को आपके मार्केटप्लेस टैब का ऐक्सेस देने के लिए भी किया जा सकता है.

Client का मतलब है, आपके Authorized Buyers खाते से जुड़े क्लाइंट, एजेंसी या विज्ञापन देने वाले व्यक्ति या कंपनी के बारे में जानकारी.

ClientUser किसी ऐसे व्यक्ति को दिखाता है जिसके पास Client के तहत, यूज़र इंटरफ़ेस (यूआई) का ऐक्सेस होता है. क्लाइंट के उपयोगकर्ता, Marketplace API को ऐक्सेस नहीं कर सकते. क्लाइंट के उपयोगकर्ताओं के पास आपके खाते के मार्केटप्लेस टैब का सीमित ऐक्सेस होता है. क्लाइंट के उपयोगकर्ता की अनुमतियां, उनके पैरंट Client में बताए गए role से तय होती हैं.

Marketplace API के अन्य संसाधन, क्लाइंट को Clients संसाधन में दिए गए नाम से रेफ़र करते हैं.

Authorized Buyers मार्केटप्लेस यूज़र इंटरफ़ेस (यूआई) में क्लाइंट और उपयोगकर्ताओं के बारे में ज़्यादा जानने के लिए, ये सहायता केंद्र लेख देखें:

मीडिया प्लानर

मीडिया प्लानर ऐसी एजेंसी या दूसरी इकाई है जो पब्लिशर के साथ डील की ये ऑफ़र या तो निजी नीलामी या पसंदीदा ऑफ़र होते हैं. इन्हें देखने या इंटरैक्ट करने के बाद ही इन्हें तय किया जा सकता है. इसके बाद, ये bidders.finalizedDeals.list रिस्पॉन्स में दिखेंगी.

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

  • OpenRTB प्रोटोकॉल
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Google आरटीबी प्रोटोकॉल
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

नीलामी पैकेज

नीलामी पैकेज से खरीदारों और क्लाइंट की सदस्यता लेने और उनकी सदस्यता छोड़ने के लिए, Marketplace API का इस्तेमाल किया जा सकता है. साथ ही, इसका इस्तेमाल, नीलामी के वे पैकेज देखने के लिए भी किया जा सकता है जिनकी आपने सदस्यता ली है.

AuctionPackage, Marketplace इन्वेंट्री के लिए टारगेटिंग के बंडल से मिलता-जुलता है. उदाहरण के लिए, नीलामी पैकेज ऐसे यूआरएल और मोबाइल ऐप्लिकेशन आईडी के कलेक्शन को टारगेट कर सकता है जो खरीदार के कारोबारी हितों के हिसाब से काम के हों.

Marketplace API का इस्तेमाल करके, नए नीलामी पैकेज नहीं बनाए जा सकते. नीलामी के पैकेज बनाने के लिए, Authorized Buyers Marketplace के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा सकता है. Marketplace API में, नीलामी के पैकेज से जुड़ी टारगेटिंग की खास जानकारी शामिल नहीं होती है.

दूसरे खरीदारों और क्लाइंट के साथ नीलामी के पैकेज शेयर किए जा सकते हैं. साथ ही, Google या अन्य खरीदारों के बनाए गए, नीलामी के पैकेज बनाए जा सकते हैं.

ज़्यादा जानकारी के लिए, नीलामी पैकेज देखें.

पब्लिशर की प्रोफ़ाइल

Marketplace API का इस्तेमाल करके, उन पब्लिशर की प्रोफ़ाइल देखी जा सकती हैं जिनके साथ बातचीत की जा सकती है.

PublisherProfile, Marketplace API में किसी पब्लिशर को दिखाता है. Marketplace API के अन्य संसाधन, उन पब्लिशर के बारे में बताते हैं जिनका नाम उनके PublisherProfile में बताया गया है.

पब्लिशर की प्रोफ़ाइल में, Authorized Buyers मार्केटप्लेस के यूज़र इंटरफ़ेस (यूआई) के डिस्कवरी टैब में मौजूद पब्लिशर की जानकारी जैसी ही होती है.

ज़्यादा जानकारी के लिए, पब्लिशर खोजने का तरीका देखें.

प्रस्ताव और डील

पब्लिशर के साथ डील करने के लिए, Marketplace API का इस्तेमाल किया जा सकता है. डील मैनेज करने के लिए, Marketplace API का इस्तेमाल इन तरीकों से किया जा सकता है:

प्रपोज़ल, खरीदार या क्लाइंट और पब्लिशर के बीच एक या एक से ज़्यादा डील की सबसे नई मोल-भाव की स्थिति दिखाते हैं. ये Authorized Buyers मार्केटप्लेस यूज़र इंटरफ़ेस (यूआई) के मोल-भाव टैब की तरह होते हैं.

डील, किसी प्रस्ताव के तहत तय की जा रही डील की नई शर्तों को दिखाती हैं. इनकी तुलना, दिए गए प्रस्ताव के लिए Authorized Buyers Marketplace के यूज़र इंटरफ़ेस (यूआई) की डील की सूची से की जाती है, जिसे मौजूदा समझौते के तौर पर लेबल किया गया होता है.

फ़ाइनल डील उन डील को दिखाती हैं जिन्होंने मोल-भाव कर लिया है और सेवा के लिए तैयार हैं. इसमें पहले से दिखाई जा रही डील भी शामिल हैं. पूरी तरह तैयार की गई डील, Authorized Buyers Marketplace के यूज़र इंटरफ़ेस (यूआई) के ऑफ़र टैब से मिलती-जुलती हैं.

जिस डील पर मोल-भाव किया जा रहा है उसके आधार पर, Marketplace API के संसाधनों के हिसाब से व्यवहार अलग-अलग हो सकता है. उदाहरण के लिए, खरीदार सभी तरह की डील के लिए मोल-भाव नहीं कर सकते. बातचीत के लिए, Marketplace API को लागू करने के बारे में ज़्यादा जानने के लिए, ये संसाधन देखें:

Authorized Buyers मार्केटप्लेस के यूज़र इंटरफ़ेस (यूआई) में मोल-भाव के बारे में ज़्यादा जानने के लिए, यह देखें: