अनुरोध प्रोसेस करें
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
रीयल-टाइम बिडिंग इंटरैक्शन तब शुरू होता है, जब Google आपके ऐप्लिकेशन को बिड रिक्वेस्ट भेजता है. इस गाइड में, बिड रिक्वेस्ट को प्रोसेस करने के लिए, ऐप्लिकेशन को कोड करने का तरीका बताया गया है.
पार्स करने का अनुरोध
Google, OpenRTB JSON या Protobuf फ़ॉर्मैट में क्रम से लगाई गई बिड रिक्वेस्ट भेजता है. इसे एचटीटीपी पोस्ट अनुरोध के पेलोड के तौर पर अटैच किया जाता है. आपको मिलने वाला फ़ॉर्मैट, आपके एंडपॉइंट के कॉन्फ़िगरेशन पर निर्भर करता है. उदाहरण के लिए, बिड रिक्वेस्ट का उदाहरण देखें.
सीरियलाइज़ किए गए BidRequest को पाने के लिए, आपको इस अनुरोध को पार्स करना होगा. अगर Protobuf फ़ॉर्मैट का इस्तेमाल किया जा रहा है, तो आपको रेफ़रंस डेटा पेज से openrtb.proto और openrtb-adx.proto डाउनलोड करना होगा. साथ ही, इनका इस्तेमाल करके एक ऐसी लाइब्रेरी जनरेट करनी होगी जिसका इस्तेमाल BidRequest मैसेज को पार्स करने के लिए किया जा सके. उदाहरण के लिए, यहां दिया गया C++ कोड, स्ट्रिंग में POST पेलोड के तौर पर दिए गए अनुरोध को पार्स करता है:
BidRequest मिलने के बाद, इसे ऑब्जेक्ट के तौर पर इस्तेमाल किया जा सकता है. साथ ही, अपनी ज़रूरत के हिसाब से फ़ील्ड को निकाला और समझा जा सकता है. उदाहरण के लिए, C++ में OpenRTB `BidRequest` में मौजूद डील को इस तरह से दोहराया जा सकता है:
जब आपके एक या उससे ज़्यादा प्री-टारगेटिंग कॉन्फ़िगरेशन, पब्लिशर की विज्ञापन इन्वेंट्री को टारगेट करते हैं, तब आपको बिड रिक्वेस्ट मिलती है. BidRequest.imp.ext.billing_id
को ज़रूरी शर्तें पूरी करने वाले खरीदारों के बिलिंग आईडी और काम के प्री-टारगेटिंग कॉन्फ़िगरेशन से भरा जाएगा. इसके अलावा, डील इन्वेंट्री के लिए, BidRequest.imp.pmp.deal.ext.billing_id का इस्तेमाल करके, काम के खरीदारों से जुड़े बिलिंग आईडी ढूंढे जा सकते हैं. बिड करते समय, सिर्फ़ बिड रिक्वेस्ट में शामिल खरीदारों के बिलिंग आईडी ही डाले जा सकते हैं.
अगर बिड रिक्वेस्ट में एक से ज़्यादा बिलिंग आईडी शामिल हैं, तो आपको उस खरीदार का बिलिंग आईडी बताना होगा जिसे आपको BidResponse.seatbid.bid.ext.billing_id फ़ील्ड के साथ अपनी बिड एट्रिब्यूट करनी है.
imp {
ext {
// The billing IDs of all of your matching pretargeting configs and eligible child seats are
// stored in a flat list here.
billing_id: 123
billing_id: 456
billing_id: 789
}
pmp {
// All eligible deals are stored in a single flat list.
deal {
id: 1000
ext {
// The specific billing IDs eligible to bid on this deal are indicated here.
billing_id: 789
}
...
}
deal {
id: 2000
ext {
billing_id: 123
billing_id: 456
}
...
}
}
...
}
...
ब्लॉक की गई कैटगरी तय करना
बिड लगाते समय, शामिल किए गए क्रिएटिव में ऐसी कैटगरी नहीं होनी चाहिए जिन्हें पब्लिशर ने ब्लॉक किया है. ऐसा न होने पर, बिड को नीलामी से फ़िल्टर कर दिया जाता है.
किसी इंप्रेशन के लिए ब्लॉक की गई कैटगरी देखने के लिए, BidRequest.bcat फ़ील्ड देखें. इसमें आपके खाते के लिए कॉन्फ़िगर की गई टैक्सोनॉमी की कैटगरी भरी होती हैं.
यहां दिए गए उदाहरण में, कॉन्फ़िगर की गई विज्ञापन कैटगरी की टैक्सोनॉमी के आधार पर ब्लॉक की गई कैटगरी दिखाई गई हैं:
IAB कॉन्टेंट टैक्सनॉमी 1.0
// Bid request{// Indicates the blocked categories using IAB Content 1.0 Taxonomy."bcat":["IAB9-9",// Cigars"IAB8-18"// Wine]"imp":{...}}
Google विज्ञापन कैटगरी टैक्सोनॉमी
// Bid request{// Indicates the blocked categories using Google Ad Category Taxonomy."bcat":["10138",// Cigar and tobacco collecting"10080",// Tobacco"11649",// Wine"10674",// Wine collecting"13008"// Wine clubs]"imp":{...}}
कॉन्टेक्स्ट के हिसाब से कैटगरी तय करना
बिड रिक्वेस्ट में, संदर्भ के हिसाब से कैटगरी के फ़ील्ड शामिल हो सकते हैं. इनसे उस वेबसाइट या ऐप्लिकेशन के बारे में जानकारी मिलती है जहां इंप्रेशन मिलता है. ये फ़ील्ड, विज्ञापन कैटगरी की टैक्सोनॉमी का भी इस्तेमाल करते हैं. हालांकि, ये क्रिएटिव पर लगी पाबंदियों के बजाय, इंप्रेशन के संदर्भ को दिखाते हैं. ऐसा हो सकता है कि ये फ़ील्ड, BidRequest.bcat फ़ील्ड की तरह ही टैक्सोनॉमी का इस्तेमाल न करें. Google या पब्लिशर, कॉन्टेंट के हिसाब से विज्ञापन दिखाने के लिए ये कैटगरी उपलब्ध करा सकते हैं. कॉन्टेक्स्ट के हिसाब से कैटगरी का इस्तेमाल करने से, इंप्रेशन का आकलन, संदर्भ के हिसाब से टारगेटिंग, और ब्रैंड की सुरक्षा को बेहतर बनाया जा सकता है.
Google की ओर से पहचानी गई कॉन्टेक्स्ट के हिसाब से कैटगरी
Google, साइट, ऐप्लिकेशन या पेज के लिए, IAB कॉन्टेंट की पहचानी गई कैटगरी के साथ इन फ़ील्ड को भरता है:
फ़ील्ड
ब्यौरा
BidRequest.site.cat
साइट के बारे में जानकारी देने वाले कॉन्टेंट की कैटगरी के आईडी का कलेक्शन.
BidRequest.site.pagecat
कॉन्टेंट कैटगरी के आईडी का कलेक्शन, जो साइट के मौजूदा पेज या व्यू के बारे में बताता है.
BidRequest.app.cat
कॉन्टेंट कैटगरी आईडी का कलेक्शन, जिसमें ऐप्लिकेशन के बारे में जानकारी दी गई हो.
BidRequest.app.pagecat
कॉन्टेंट कैटगरी आईडी का कलेक्शन, जो ऐप्लिकेशन के मौजूदा पेज या व्यू के बारे में बताता है.
किसी बिड रिक्वेस्ट के लिए, इन फ़ील्ड में इस्तेमाल की गई सटीक टैक्सोनॉमी को BidRequest.site.cattax या BidRequest.app.cattax फ़ील्ड में देखा जा सकता है. ऐसा हो सकता है कि पब्लिशर की प्राथमिकताओं या कानूनी समस्याओं की वजह से, कॉन्टेक्स्ट के हिसाब से कैटगरी के फ़ील्ड हमेशा न भरे जाएं.
ज़्यादा जानकारी के लिए, Google Ad Manager में OpenRTB स्पेसिफ़िकेशन के हिसाब से कॉन्टेक्स्ट से जुड़ी कैटगरी लेख पढ़ें.
पब्लिशर से मिले सिग्नल
Google की ओर से पहचानी गई कॉन्टेक्स्ट के हिसाब से बनाई गई कैटगरी के अलावा, बिड रिक्वेस्ट में पब्लिशर से मिले सिग्नल भी शामिल हो सकते हैं. इनसे इंप्रेशन के कॉन्टेक्स्ट के बारे में भी जानकारी मिलती है. Google की ओर से पहचानी गई कॉन्टेक्स्ट के हिसाब से बनाई गई कैटगरी के उलट, ये सिग्नल सिर्फ़ तब दिखते हैं, जब पब्लिशर इन्हें उपलब्ध कराता है. ये सिग्नल, BidRequest.site.content और BidRequest.app.content ऑब्जेक्ट में भेजे जाते हैं. जैसे, content.data.segment और content.genre. content.data.segment
एंट्री के लिए इस्तेमाल की जाने वाली टैक्सोनॉमी की जानकारी, content.data.ext.segtax में दी जाती है. ज़्यादा जानकारी के लिए, रीयल-टाइम बिडिंग (आरटीबी) के लिए, पब्लिशर से मिले सिग्नल (पीपीएस) लेख पढ़ें.
डिक्शनरी फ़ाइलें
बिड रिक्वेस्ट में, डिक्शनरी फ़ाइलों में तय किए गए आइडेंटिफ़ायर का इस्तेमाल किया जाता है. ये फ़ाइलें, रेफ़रंस डेटा पेज पर उपलब्ध हैं.
बिडर यूआरएल मैक्रो
इसके अलावा, मैक्रो का इस्तेमाल करके, BidRequest से कुछ जानकारी को बिडिंग एंडपॉइंट यूआरएल में डाला जा सकता है. अगर आपने एक या उससे ज़्यादा मैक्रो के साथ एंडपॉइंट यूआरएल को कॉन्फ़िगर किया है, तो बिड रिक्वेस्ट में वह जानकारी मौजूद होने पर, उन्हें बड़ा किया जाएगा. उदाहरण के लिए, अगर आपको BidRequest में मौजूद जानकारी के आधार पर लोड बैलेंसिंग करनी है, तो यह तरीका फ़ायदेमंद हो सकता है.
नए मैक्रो के लिए सहायता का अनुरोध करने के लिए, अपने खाता मैनेजर से संपर्क करें.
मैक्रो
ब्यौरा
%%GOOGLE_USER_ID%%
BidRequest.user.id में मिले Google यूज़र आईडी से बदल दिया गया. उदाहरण के लिए, अनुरोध के समय बिडिंग करने वाले के यूआरएल http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% को http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl जैसे किसी यूआरएल से बदल दिया जाएगा.
अगर Google यूज़र आईडी की जानकारी नहीं है, तो खाली स्ट्रिंग को बदल दिया जाता है. इसका नतीजा कुछ ऐसा होता है
http://google.bidder.com/path?gid=
%%HAS_MOBILE%%
इसे 1 से बदल दिया जाता है, ताकि यह पता चल सके कि बिड रिक्वेस्ट किसी फ़ोन या टैबलेट से की गई है. अगर ऐसा नहीं है, तो इसे 0 से बदल दिया जाता है. यह BidRequest.device.devicetype की वैल्यू पर आधारित होता है. इसमें फ़ोन या टैबलेट को HIGHEND_PHONE (4) या Tablet (5) से दिखाया जाता है.
%%HAS_VIDEO%%
इसे 1 से बदल दिया जाता है, ताकि यह पता चल सके कि बिड रिक्वेस्ट में वीडियो इन्वेंट्री शामिल है या नहीं. अगर शामिल नहीं है, तो इसे 0 से बदल दिया जाता है. यह इस बात पर निर्भर करता है कि बिड रिक्वेस्ट में BidRequest.imp.video की जानकारी भरी गई है या नहीं.
%%IS_CTV%%
इसे 1 से बदल दिया गया है, ताकि यह पता चल सके कि बिड रिक्वेस्ट किसी सीटीवी डिवाइस से है या 0 से. यह BidRequest.device.devicetype की वैल्यू पर आधारित है. Protobuf के लिए, सीटीवी डिवाइस
CONNECTED_TV, CONNECTED_DEVICE या
SET_TOP_BOX हैं. ये JSON के लिए, पूर्णांक वैल्यू 3,
6 या 7 से मेल खाते हैं.
%%HOSTED_MATCH_DATA%%
BidRequest.user.buyeruid के आधार पर वैल्यू से बदला गया.
%%MOBILE_IS_APP%%
इसे 1 से बदल दिया गया है, ताकि यह पता चल सके कि बिड रिक्वेस्ट, मोबाइल ऐप्लिकेशन इन्वेंट्री के लिए है या 0 के लिए. यह इस बात पर निर्भर करता है कि BidRequest.app में जानकारी भरी गई है या नहीं.
लेन-देन के यूआरएल से मोबाइल ऐप्लिकेशन आईडी ढूंढना
मोबाइल ऐप्लिकेशन के लेन-देन से जुड़े यूआरएल कुछ इस तरह दिखेंगे:
mbappgewtimrzgyytanjyg4888888.com
बोल्ड में मौजूद स्ट्रिंग के हिस्से (gewtimrzgyytanjyg4888888) को डिकोड करने के लिए, base-32 डिकोडर का इस्तेमाल करें.
ऑनलाइन डिकोडर का इस्तेमाल किया जा सकता है. हालांकि, आपको अक्षरों को कैपिटल लेटर में लिखना होगा और आखिर में मौजूद 8 को = वैल्यू से बदलना होगा.
इस वैल्यू को डिकोड करने पर:
GEWTIMRZGYYTANJYG4======
नतीजे:
1-429610587
स्ट्रिंग 429610587, iOS ऐप्लिकेशन iFunny का ऐप्लिकेशन आईडी है.
यहां एक और उदाहरण दिया गया है. शिकायत किया गया यूआरएल यह है:
mbappgewtgmjug4ytmmrtgm888888.com
इस वैल्यू को डिकोड करना:
GEWTGMJUG4YTMMRTGM======
नतीजे:
1-314716233
नतीजे में मिला 314716233, iOS ऐप्लिकेशन TextNow का ऐप्लिकेशन आईडी है.
लेन-देन के यूआरएल से मोबाइल ऐप्लिकेशन का नाम ढूंढना
यहां ऐप्लिकेशन का नाम पाने का एक उदाहरण दिया गया है. शिकायत किया गया यूआरएल यह है:
यह नतीजा, Android ऐप्लिकेशन
slither.io के बराबर है.
ओपन बिडिंग के फ़ील्ड
ओपन बिडिंग में हिस्सा लेने वाले एक्सचेंज और नेटवर्क बिडर को भेजी गई बिड रिक्वेस्ट, स्टैंडर्ड रीयल-टाइम बिडिंग में हिस्सा लेने वाले Authorized Buyers को भेजी गई बिड रिक्वेस्ट जैसी ही होती हैं. ओपन बिडिंग के ग्राहकों को कुछ अतिरिक्त फ़ील्ड मिलेंगे. साथ ही, कुछ मौजूदा फ़ील्ड के अन्य इस्तेमाल भी हो सकते हैं. इनमें ये शामिल हैं:
OpenRTB
विवरण
BidRequest.imp.ext.dfp_ad_unit_code
इसमें पब्लिशर का Ad Manager नेटवर्क कोड होता है. इसके बाद, विज्ञापन यूनिट की हैरारकी होती है. इसे फ़ॉरवर्ड स्लैश से अलग किया जाता है.
उदाहरण के लिए, यह कुछ इस तरह के फ़ॉर्मैट में दिखेगा:
/1234/cruises/mars.
BidRequest.user.data.segment
पब्लिशर की ओर से एक्सचेंज बिडर को भेजे गए, बार-बार इस्तेमाल होने वाले की-वैल्यू पेयर.
यह तय किया जा सकता है कि वैल्यू, पब्लिशर की ओर से भेजे गए की-वैल्यू पेयर हैं. ऐसा तब होता है, जब BidRequest.user.data.name को “Publisher Passed” पर सेट किया जाता है.
अनुमति वाले वेंडर की जानकारी देना
रिसर्च, रीमार्केटिंग, और विज्ञापन दिखाने जैसी सेवाएं देने वाले टेक्नोलॉजी वेंडर, खरीदारों और विक्रेताओं के बीच होने वाले इंटरैक्शन में अहम भूमिका निभा सकते हैं. सिर्फ़ उन वेंडर को अनुमति दी जाती है जिनकी Google ने Authorized Buyers इंटरैक्शन में हिस्सा लेने के लिए जांच की है.
BidRequest को समझने और अपना BidResponse बनाने के लिए, आपको टेक्नोलॉजी वेंडर का एलान करने की दो अलग-अलग संभावनाओं के बारे में पता होना चाहिए:
अन्य वेंडर सिर्फ़ तब हिस्सा ले सकते हैं, जब उनके बारे में BidRequest में बताया गया हो:
BidRequest में, BidRequest.imp.ext.allowed_vendor_type फ़ील्ड से पता चलता है कि सेलर ने किन वेंडर को अनुमति दी है. allowed_vendor_type में भेजे जाने वाले वेंडर, vendors.txt डिक्शनरी फ़ाइल में लिस्ट किए गए हैं.
बिड रिक्वेस्ट का उदाहरण
यहां दिए गए उदाहरणों में, Protobuf और JSON अनुरोधों के ऐसे सैंपल दिखाए गए हैं जिन्हें कोई भी व्यक्ति आसानी से पढ़ सकता है.
बिड रिक्वेस्ट को बाइनरी फ़ॉर्म में बदलने के लिए, जैसा कि आपको असल अनुरोध में POST पेलोड से मिलेगा, C++ में यह तरीका अपनाएं. हालांकि, ध्यान रखें कि यह OpenRTB JSON पर लागू नहीं होता.
रीयल-टाइम में सुझाव, राय या शिकायत पाने की सुविधा, Authorized Buyers के साथ-साथ ओपन बिडिंग का इस्तेमाल करने वाले एक्सचेंज और नेटवर्क के लिए भी उपलब्ध है.
रीयल-टाइम में मिलने वाले फ़ीडबैक से, आपकी एक या उससे ज़्यादा बिड के नतीजों के आधार पर BidRequest.ext.bid_feedback की जानकारी अपने-आप भर जाती है. इसका इस्तेमाल करके, यह पता लगाया जा सकता है कि बिड ने नीलामी जीती या नहीं. इसके अलावा, नीलामी जीतने के लिए ज़रूरी कम से कम बिड की जानकारी भी मिल सकती है. रीयल-टाइम में विश्लेषण और आकलन की सुविधा चालू करने के लिए, अपने खाता मैनेजर से संपर्क करें.
बिड रिस्पॉन्स के सुझाव में भेजे गए डिफ़ॉल्ट फ़ील्ड के अलावा, BidResponse.seatbid.bid.ext.event_notification_token फ़ील्ड का इस्तेमाल करके बिड रिस्पॉन्स में कस्टम डेटा भी भेजा जा सकता है. event_notification_token, आर्बिट्रेरी डेटा होता है. इसकी जानकारी सिर्फ़ बिडिंग करने वाले को होती है. इससे डीबग करने में मदद मिल सकती है. उदाहरण के लिए: नई रणनीति को दिखाने वाला नया टारगेटिंग आईडी या बिडिंग आईडी या क्रिएटिव से जुड़ा मेटाडेटा, जिसकी जानकारी सिर्फ़ बिडिंग करने वाले को होती है. ज़्यादा जानकारी के लिए, OpenRTB एक्सटेंशन प्रोटोकॉल बफ़र फ़ाइल देखें.
जब Authorized Buyers, बिड करने वाले को बिड रिक्वेस्ट भेजता है, तो बिड करने वाला BidResponse के साथ जवाब देता है. अगर बिडर ने रीयल-टाइम में सुझाव, राय या शिकायत पाने की सुविधा चालू की है, तो बाद के बिड अनुरोध में, Authorized Buyers BidFeedback मैसेज में जवाब पर सुझाव, राय या शिकायत भेजता है:
messageBidFeedback{//TheuniqueidfromBidRequest.id.optionalstringrequest_id=1;//Thestatuscodeforthead.Seecreative-status-codes.txtinthe//technicaldocumentationforalistofids.optionalint32creative_status_code=2;//Deprecated.ThisfieldisnotpopulatedandwillberemovedafterMarch,//2025.Ifthebidwontheauction,thisisthepricepaidinyouraccount//currency.Ifthebidparticipatedintheauctionbutwasout-bid,this//istheCPMthatshouldhavebeenexceededinordertowin.Thisisnot//setifthebidwasfilteredpriortotheauction,ifthepublisheror//winningbidderhasoptedoutofpricefeedbackorifyouraccounthas//optedoutofsharingwinningpriceswithotherbidders.Forfirst-price//auctions,minimum_bid_to_winispopulatedinsteadofthisfield.optionaldoubleprice=3[deprecated=true];//Theminimumbidvaluenecessarytohavewontheauction,inyouraccount//currency.Ifyourbidwontheauction,thisisthesecondhighestbid//thatwasnotfiltered(includingthefloorprice).Ifyourbiddidn't win//theauction,thisisthewinningcandidate's bid. This field will only be//populatedifyourbidparticipatedinafirst-priceauction,andwillnot//bepopulatedifyourbidwasfilteredpriortotheauction.optionaldoubleminimum_bid_to_win=6;//Billableeventratemultiplierthatwasappliedtothisbidduring//ranking.Theadjustmentreflectsthelikelihoodthatyourbidwould//generateabillableevent(namely,theadrenderssuccessfully)ifitwon//theauction,relativetotheprobabilitythatotherbidsgeneratea//billableeventiftheywontheauction.Thisadjustmentcanbelargeror//smallerthan1.Thisaffectsthefinalrankingintheauctiononly;in//particular,thismultiplierdoesnotaffectthepaymentorwhetherthe//bidclearsanyfloorprice.optionalfloatbillable_event_rate_bid_adjustment=13[default=1];//WhenapublisherusesanRTBauctionandwaterfall-basedSDKmediationon//thesamequery,thewinnerofthereal-timeauctionmustalsocompetein//amediationwaterfall(whichisorderedbyprice)towintheimpression.//Ifthebidparticipatedintheauctionandtherewasnowaterfall,the//valueofthisfieldis0.Ifthebidparticipatedintheauctionand//therewasawaterfall,thevalueofthisfieldisapricerepresentinga//samplebidfromtheeligiblemediationnetworksthatwerehigherthanthe//auctionwinner,weightedbyexpectedfillrate.Thisfieldcanbeused//inconjunctionwithminimum_bid_to_wintotrainbiddingmodels.TheCPM//isinyouraccountcurrency.optionaldoublesampled_mediation_cpm_ahead_of_auction_winner=8;messageEventNotificationToken{//Thecontentsofthetoken.optionalstringpayload=1;}//Thetokenincludedinthecorrespondingbid.optionalEventNotificationTokenevent_notification_token=4;//ThecreativeIDincludedinthecorrespondingbid.optionalstringbuyer_creative_id=5;}
इस मैसेज में, आपको सबसे पहले bid_feedback.creative_status_code फ़ील्ड की जांच करनी चाहिए. कोड का मतलब जानने के लिए, creative-status-codes.txt पर जाएं. ध्यान दें कि बिड जीतने पर, कीमत के सुझाव से ऑप्ट आउट किया जा सकता है. ज़्यादा जानकारी के लिए, ऑप्ट-आउट करने का तरीका लेख पढ़ें.
रीयल-टाइम में मिलने वाले सुझाव में, बिड रिक्वेस्ट आईडी और इनमें से कोई एक जानकारी शामिल होती है:
नीलामी का नतीजा
रीयल-टाइम में विश्लेषण और आकलन
खरीदार ने बिड सबमिट नहीं की.
कुछ नहीं.
खरीदार ने ऐसी बिड सबमिट की जिसे नीलामी में शामिल होने से पहले ही फ़िल्टर कर दिया गया.
फ़र्स्ट-प्राइस ऑक्शन में बिड लगाने के बाद, आपको रीयल-टाइम में सुझाव, राय या शिकायत मिलेगी. इसमें minimum_bid_to_win और sampled_mediation_cpm_ahead_of_auction_winner फ़ील्ड शामिल होंगे. ऐसा तब होगा, जब बिड को नीलामी से फ़िल्टर न किया गया हो. इन सिग्नल का इस्तेमाल, बिडिंग के लॉजिक को बेहतर बनाने के लिए किया जा सकता है. इससे यह पता चलता है कि इंप्रेशन पाने के लिए, आपकी बिड कितनी ज़्यादा या कम हो सकती थी.
minimum_bid_to_win: रीयल-टाइम बिडिंग की नीलामी जीतने के लिए, कम से कम बिड. अगर आपने नीलामी जीत ली है, तो यह सबसे कम बिड होगी जो आपने लगाई होगी. अगर आपने नीलामी नहीं जीती, तो यह जीतने वाली बिड होगी.
sampled_mediation_cpm_ahead_of_auction_winner: अगर मीडिएशन चेन में अन्य नेटवर्क हैं, तो इस फ़ील्ड की वैल्यू, मीडिएशन की ज़रूरी शर्तें पूरी करने वाले किसी एक नेटवर्क की सैंपल बिड की कीमत होती है. यह बिड, नीलामी जीतने वाले नेटवर्क की बिड से ज़्यादा होती है. साथ ही, इसे विज्ञापन दिखाए जाने की अनुमानित दर के हिसाब से तय किया जाता है. अगर मीडिएशन चेन में मौजूद किसी भी नेटवर्क से विज्ञापन नहीं दिखाया जाता है या पब्लिशर, एसडीके मीडिएशन का इस्तेमाल नहीं करता है, तो इसे 0 पर सेट किया जाएगा.
यह कैसे काम करता है
minimum_bid_to_win और sampled_mediation_cpm_ahead_of_auction_winner की संभावित वैल्यू तय करने के लिए, इस्तेमाल किए गए कैलकुलेशन के बारे में बताने के लिए, हमें सबसे पहले इनके बारे में बताना होगा:
यहां मीडिएशन चेन में सीपीएम को घटते क्रम में दिखाया गया है:
\[C_1, C_2, …, C_n\]
यहां मीडिएशन चेन में सीपीएम के लिए, फ़िल रेट की जानकारी दी गई है:
\[f_1, f_2, …, f_n\]
यहां दिए गए फ़ंक्शन का इस्तेमाल, मीडिएशन चेन एलिमेंट \(i\)से मिलने वाले संभावित सीपीएम और उसकी संभावना का पता लगाने के लिए किया जाता है. यह फ़ंक्शन, विज्ञापन दिखाए जाने की दर के आधार पर काम करता है:
\(X_i = \{C_i\) संभावना के साथ \(f_i\); \(0\) संभावना के साथ \(1 - f_i\}\)
जीतने वाली मीडिएशन चेन यह होगी:
\[\{C_1, C_2, …, C_K, W\}\]
जहां \(W\) सफल बिड है और \(C_K > W >= C_{K+1}\)
रिज़र्व प्राइस या फ़्लोर को \(F\)के तौर पर दिखाया जाता है.
दूसरे नंबर पर रहने वाली बिड को \(R\)के तौर पर दिखाया जाता है.
नीलामी जीतने वाले का हिसाब लगाना
फ़ील्ड
कैलकुलेशन
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_ of_auction_winner
\(\{C_i\) with probability \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
\(1 <= i <= K\)के लिए.
नीलामी में हारने वाले के लिए कैलकुलेशन
फ़ील्ड
कैलकुलेशन
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_ of_auction_winner
\(max\{X_1, …, X_K\}\)
एक सामान्य मीडिएशन चेन का उदाहरण
मान लें कि कोई पब्लिशर, रीयल-टाइम बिडिंग और एसडीके मीडिएशन चेन, दोनों का इस्तेमाल इस तरह करता है:
एसडीके मीडिएशन चेन
अनुमानित सीपीएम
फ़िल रेट
नेटवर्क 1
\(C_1 = $3.00\)
\(f_1 = 5\%\)
नेटवर्क 2
\(C_2 = $2.00\)
\(f_2 = 45\%\)
नेटवर्क 3
\(C_3 = $0.50\)
\(f_3 = 80\%\)
नेटवर्क 4
\(C_4 = $0.10\)
\(f_4 = 85\%\)
मान लें कि आरटीबी नीलामी का नतीजा यह है:
आरटीबी नीलामी
सीपीएम
नीलामी जीतने वाला (W)
1.00 डॉलर
नीलामी में दूसरे नंबर पर रहने वाला (R)
0.05 डॉलर
रिज़र्व प्राइस / कम से कम कीमत (F)
$0
नीलामी जीतने वाली बिड
यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि जीतने वाली बिड के लिए, minimum_bid_to_win और sampled_mediation_cpm_ahead_of_auction_winner की वैल्यू और संभावनाओं का हिसाब कैसे लगाया जाता है.
यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि हारने वाली बिड के लिए, minimum_bid_to_win और sampled_mediation_cpm_ahead_of_auction_winner की वैल्यू और संभावनाओं का हिसाब कैसे लगाया जाता है.
minimum_bid_to_win
प्रॉबेबिलिटी
\(max(F, W) = $1.00\)
\(100\%\)
sampled_mediation_cpm_ ahead_of_auction_winner
प्रॉबेबिलिटी
\(C_1 = $3.00\)
\(f_1 = 5\%\)
\(C_2 = $2.00\)
\((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\)
\((1-f_1) \cdot (1-f_2) =~ 52.2\%\)
बिड को फ़्लैट करना
बिड को फ़्लैट करने का मतलब है, एक जटिल BidRequest को कई बिड रिक्वेस्ट में प्रोसेस करना. ये बिड रिक्वेस्ट आपके ऐप्लिकेशन को भेजी जाती हैं. बिड रिक्वेस्ट को फ़्लैट करने पर, यह पता लगाया जा सकता है कि कौनसी बिड रिक्वेस्ट ओरिजनल रिक्वेस्ट का हिस्सा थीं. ऐसा इसलिए, क्योंकि BidRequest.ext.google_query_id फ़ील्ड में उनकी वैल्यू एक जैसी होगी.
बिड को फ़्लैट करने की सुविधा डिफ़ॉल्ट रूप से चालू होती है. हालांकि, अगर आपको इसे बंद करना है, तो अपने खाता मैनेजर से संपर्क करें.
विज्ञापन फ़ॉर्मैट
विज्ञापन दिखाने के कुछ अवसरों में, कई फ़ॉर्मैट इस्तेमाल किए जा सकते हैं. बिड को फ़्लैट करने की सुविधा की मदद से, हर फ़ॉर्मैट को अलग-अलग बिड रिक्वेस्ट में भेजा जाता है. इसमें, ज़रूरी शर्तें पूरी करने वाले बिलिंग आईडी जैसी एट्रिब्यूट, अनुरोध में बताए गए फ़ॉर्मैट के हिसाब से होते हैं.
इन फ़ॉर्मैट वाली बिड रिक्वेस्ट को अलग-अलग बिड रिक्वेस्ट में बांट दिया जाएगा:
बैनर
वीडियो
ऑडियो
मूल भाषा वाला
विज्ञापन फ़ॉर्मैट को फ़्लैट करने का उदाहरण
यहां एक आसान OpenRTB JSON बिड रिक्वेस्ट का उदाहरण दिया गया है. इसमें विज्ञापन फ़ॉर्मैट को फ़्लैट नहीं किया गया है. इसकी तुलना, फ़्लैट किए गए अनुरोधों के सेट से की गई है:
बिड लगाने वाले किसी व्यक्ति या कंपनी के लिए, विज्ञापन दिखाने का अवसर खुली नीलामी के अलावा, अलग-अलग तरह की डील पर भी लागू हो सकता है. डील के लिए बिड को फ़्लैट करने की सुविधा की मदद से, खुली नीलामी के लिए एक बिड रिक्वेस्ट भेजी जाएगी. साथ ही, तय कीमत वाली हर तरह की डील के लिए भी एक बिड रिक्वेस्ट भेजी जाएगी. असल में, नीलामी और तय कीमत वाली डील के बीच, विज्ञापन से जुड़ी पाबंदियां अलग-अलग हो सकती हैं. उदाहरण के लिए, वीडियो विज्ञापन दिखाने के किसी अवसर के लिए, जो खुली नीलामी और तय कीमत वाली डील, दोनों के लिए उपलब्ध है, बिड लगाने वाले को हर एक के लिए अलग-अलग बिड रिक्वेस्ट मिलेंगी. इनमें, विज्ञापन की ज़्यादा से ज़्यादा अवधि और स्किप किए जा सकने वाले विज्ञापनों को अनुमति देने जैसी पाबंदियां अलग-अलग हो सकती हैं. इस वजह से, विज्ञापन के अवसर पर लागू की गई फ़्लैटनिंग से, आपको खुली नीलामी और तय कीमत वाली डील के लिए, विज्ञापन की पाबंदियों को ज़्यादा आसानी से समझने में मदद मिलती है.
स्किप किए जा सकने वाले वीडियो और वीडियो की अवधि
OpenRTB स्पेसिफ़िकेशन में, स्किप किए जा सकने वाले और स्किप न किए जा सकने वाले विज्ञापनों की ज़्यादा से ज़्यादा अवधि तय करने के लिए अलग-अलग फ़ील्ड नहीं होते. Google, बिड को फ़्लैट करने की सुविधा का इस्तेमाल करता है, ताकि मौजूदा BidRequest.video.maxduration और BidRequest.video.skip फ़ील्ड का इस्तेमाल करके, इनके बीच अंतर किया जा सके.
यहां एक उदाहरण दिया गया है, जिससे पता चलता है कि वीडियो इन्वेंट्री को फ़्लैटन कैसे किया जाता है. इसमें, स्किप न किए जा सकने वाले विज्ञापन की ज़्यादा से ज़्यादा अवधि 15 और स्किप किए जा सकने वाले विज्ञापन की ज़्यादा से ज़्यादा अवधि 60 है.
उदाहरण
max_ad_duration
skip (सही या गलत)
फ़्लैट किए बिना ओरिजनल अनुरोध
15
true
फ़्लैटेंड रिक्वेस्ट #1: स्किप न किया जा सकने वाला विज्ञापन
15
false
फ़्लैटेंड रिक्वेस्ट #2: स्किप किया जा सकने वाला विज्ञापन
60
true
स्किप किए जा सकने वाले वीडियो की अवधि के लिए, बिड रिक्वेस्ट को फ़्लैट करने की सुविधा सिर्फ़ तब काम करेगी, जब ये शर्तें पूरी होंगी:
अनुरोध में वीडियो की अनुमति है.
स्किप किए जा सकने वाले और स्किप न किए जा सकने वाले, दोनों तरह के वीडियो दिखाए जा सकते हैं. हालांकि, दोनों तरह के वीडियो की ज़्यादा से ज़्यादा अवधि अलग-अलग होती है.
यह अनुरोध, निजी नीलामी या खुली नीलामी की ज़रूरी शर्तें पूरी करता है.
अपने तकनीकी खाता मैनेजर से संपर्क करके, इस तरह के फ़्लैटनिंग से ऑप्ट आउट किया जा सकता है. अगर यह सुविधा बंद है और पब्लिशर, स्किप किए जा सकने वाले और स्किप न किए जा सकने वाले, दोनों तरह के वीडियो विज्ञापनों को दिखाने की अनुमति देता है, तो स्किप किए जा सकने वाले विज्ञापनों के लिए, skip को true पर सेट किया जाएगा. साथ ही, maxduration को स्किप किए जा सकने वाले और स्किप न किए जा सकने वाले विज्ञापनों की पाबंदियों के बीच की कम अवधि पर सेट किया जाएगा.
वीडियो पॉड
विज्ञापन दिखाने के कई अवसरों वाले वीडियो पॉड के लिए बिड रिक्वेस्ट को फ़्लैट किया जाता है. इससे हर बिड रिक्वेस्ट, उस पॉड से विज्ञापन दिखाने के एक अवसर के लिए होती है.
इससे आपको किसी पॉड के लिए, विज्ञापन दिखाने के कई अवसरों पर बिड करने की सुविधा मिलती है.
Open Measurement
ओपन मेज़रमेंट की मदद से, तीसरे पक्ष के उन वेंडर की जानकारी दी जा सकती है जो मोबाइल ऐप्लिकेशन एनवायरमेंट में दिखाए जाने वाले विज्ञापनों के लिए, स्वतंत्र रूप से मेज़रमेंट और पुष्टि करने की सेवाएं देते हैं.
बिड रिक्वेस्ट में, यह पता लगाया जा सकता है कि कोई पब्लिशर, ओपन मेज़रमेंट के साथ काम करता है या नहीं. इसके लिए, यह देखें कि विज्ञापन दिखाने के अवसर में, पब्लिशर के लिए, क्रिएटिव के ऐसे एट्रिब्यूट जिन्हें शामिल नहीं किया जा सकता में मौजूद OmsdkType:
OMSDK 1.0 एट्रिब्यूट को शामिल नहीं किया गया है. यह फ़ॉर्मैट के आधार पर, बैनर या वीडियो के लिए, battr एट्रिब्यूट में मिलेगा.
ओपन मेज़रमेंट सिग्नल वाले बिड रिक्वेस्ट को समझने के तरीके के बारे में ज़्यादा जानने के लिए, ओपन मेज़रमेंट एसडीके के सहायता केंद्र में मौजूद लेख पढ़ें.
बिड रिक्वेस्ट के सैंपल
यहां दिए गए सेक्शन में, अलग-अलग विज्ञापन के टाइप के लिए बिड रिक्वेस्ट के सैंपल दिखाए गए हैं.
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2026-11-17 (UTC) को अपडेट किया गया."],[],["Bid requests are HTTP POSTs using OpenRTB Protobuf, replacing the deprecated Google RTB protocol. Parsing involves `ParseFromString()` to access fields in the `BidRequest` object. Billing IDs, found in `BidRequest.imp.ext.billing_id` and `BidRequest.imp.pmp.deal.ext.billing_id`, must be specified in `BidResponse.seatbid.bid.ext.billing_id`. Key information comes from dictionary files. Bid URL macros dynamically insert `BidRequest` data. Complex bid requests can be broken into simpler, flattened requests per format or deal, such as skippable/non-skippable video ads, or video pods. Bidders get real-time feedback. The provided sample requests are used to help the process.\n"]]