इस दस्तावेज़ में, आपको इनके साथ नीलामी करने के बारे में ज़्यादा जानकारी मिलेगी किसी एक सेलर के लिए सुरक्षित ऑडियंस डेटा, जैसा कि मौजूदा वर्शन में इस्तेमाल किया जाता है Protected Audience API. सिर्फ़ एक सेलर वाली नीलामी कई सेलर को शामिल करके ज़्यादा जटिल नीलामी की मदद से किया जाता है. इसमें के मामले में, एकल विक्रेता नीलामी को "घटक नीलामी" कहा जाता है, जो "टॉप लेवल की नीलामी" के लिए विज्ञापन के उम्मीदवारों को जिसमें एक से ज़्यादा सेलर हैं शामिल हैं.
Protected Audience API की लाइफ़साइकल के बारे में जानने के लिए, डेवलपर गाइड पढ़ें. साथ ही, ज़्यादा जानकारी के लिए Protected Audience API के बारे में जानकारी देने वाला टूल देखें सेलर, डिवाइस पर नीलामी कैसे करते हैं, इस बारे में चर्चा.
Protected Audience API से जुड़ी विज्ञापन नीलामी के छह चरण
![Protected Audience API की विज्ञापन नीलामी के छह चरण](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/six-stages-a-protected-a-3e1dd6fdeddbe.png?authuser=8&hl=hi)
- उपयोगकर्ता किसी ऐसी साइट पर जाता है जो विज्ञापन दिखाती है.
- सेलर का कोड,
navigator.runAdAuction()
को एक्ज़ीक्यूट करता है. इससे पता चलता है कि विज्ञापन स्पेस बिक्री के लिए है और इसके लिए कौन बोली लगा सकता है. विक्रेताओं को एक स्क्रिप्ट भी शामिल करनी होगी जोscoreAd()
, प्रत्येक बोली का स्कोर देती है. - आमंत्रित खरीदार का कोड किसी प्रासंगिक विज्ञापन के लिए बोली, URL जनरेट करने का काम शुरू करता है और अन्य डेटा. बिडिंग स्क्रिप्ट, रीयल-टाइम डेटा, जैसे, खरीदार के विज्ञापन कैंपेन का बचा हुआ बजट कुंजी/वैल्यू से जुड़ी सेवा.
- विक्रेता का कोड प्रत्येक बोली को स्कोर देता है और एक विजेता का चयन करता है. यह लॉजिक, बिड की वैल्यू और अन्य डेटा से, बिड को बेहतर बनाने में मदद मिलती है. वे विज्ञापन जिन्हें हराया नहीं जा सकता संदर्भ के हिसाब से विजेता को अस्वीकार कर दिया जाता है. सेलर अपनी ऐसेट का इस्तेमाल कर सकते हैं रीयल-टाइम डेटा के लिए कुंजी/वैल्यू सेवा.
- विजेता विज्ञापन को एक ओपेक मान के रूप में लौटाया जाता है, जो फ़ेंस किया गया फ़्रेम होना चाहिए. विक्रेता और पब्लिशर यह वैल्यू नहीं देख पाएगा.
- नीलामी की रिपोर्ट, सेलर और जीतने वाले खरीदारों को दी जाती है.
नीलामी तब हो सकती है, जब उपयोगकर्ता विज्ञापन दिखाने वाले किसी पेज पर जाता है. नीलामियां समय से पहले की जा सकती हैं, ताकि विज्ञापन के समय विज्ञापन क्रिएटिव तैयार हो स्लॉट देखने को मिलते हैं.
विक्रेता विज्ञापन नीलामी शुरू करते हैं, दिए गए कस्टम तर्क का उपयोग करके उम्मीदवार के विज्ञापनों के लिए स्कोर देते हैं
scoreAd()
फ़ंक्शन का इस्तेमाल कर सकती हैं और इसके नतीजे की रिपोर्ट करने के लिए ज़िम्मेदार हैं
नीलामी की प्रोसेस को पूरा करता है. विक्रेता ये काम भी कर सकते हैं
प्रकाशक के नियमों को लागू करें और उनके scoreAd()
का इस्तेमाल करके विज्ञापन की क्वालिटी फ़िल्टर करें
फ़ंक्शन का इस्तेमाल करना होगा.
सेलर इनके बारे में बता सकता है:
- अपनी वेबसाइट पर विज्ञापन का कॉन्टेंट होस्ट करने के लिए काम करने वाले कॉन्टेंट पब्लिशर
- सप्लाई-साइड प्लैटफ़ॉर्म (एसएसपी), विज्ञापन पब्लिशर के साथ काम करते हुए, और अन्य सेवाएं देते हैं
- तीसरे पक्ष की स्क्रिप्ट, जो पब्लिशर के लिए काम करती हैं, ताकि वे विज्ञापन नीलामियों में हिस्सा ले सकें.
नीलामी चलाने की ज़रूरी शर्तें
नीलामी चलाने के लिए, विक्रेता को दो JavaScript फ़ंक्शन की ज़रूरत होती है:
scoreAd()
, जो विज्ञापन के किसी उम्मीदवार को स्कोर देता हैreportResult()
, जो नीलामी के नतीजे की रिपोर्ट सेलर को खुद मैनेज करता है
इन स्क्रिप्ट को विक्रेता के मालिकाना हक वाले एक एंडपॉइंट से दिखाना होगा.
scoreAd()
सेलर को scoreAd()
फ़ंक्शन तय करना होगा, जो एंडपॉइंट से दिखाया जाता है
मालिकाना हक है. एंडपॉइंट को नीलामी कॉन्फ़िगरेशन में,
decisionLogicUrl
. scoreAd()
फ़ंक्शन में यह हस्ताक्षर है:
scoreAd(
adMetadata,
bid,
auctionConfig,
trustedScoringSignals,
browserSignals,
directFromSellerSignals)
scoreAd()
पैरामीटर ये हैं:
adMetaData
, जो कि विज्ञापन क्रिएटिव के बारे में आर्बिट्रेरी मेटाडेटा होता है खरीदार की ओर से उपलब्ध कराया गया. यह JSON में इस्तेमाल किया जा सकने वाला ऐसा ऑब्जेक्ट है जिसे क्रम में लगाया जा सकता है. इस ऑब्जेक्ट को सेलर और खरीदारों को स्ट्रक्चर तय करना और उससे सहमत होना होगा.bid
, जो बोली को दर्शाने वाली संख्या है.auctionConfig
, नीलामी करने के लिए इस्तेमाल किया जाने वाला नीलामी कॉन्फ़िगरेशन है.trustedScoringSignals
, जो नीलामी के समय पढ़े जाने वाले सिग्नल होते हैं. विक्रेता का कुंजी/वैल्यू सर्वर. प्लैटफ़ॉर्म, कन्वर्ज़न ट्रैकिंग केrenderUrl
का इस्तेमाल करेगा इस लुकअप के लिए मुख्य रूप से उम्मीदवार का विज्ञापन है.browserSignals
एक ऐसा ऑब्जेक्ट है जिसे ब्राउज़र ने बनाया है. इसमें ये शामिल हैं वह जानकारी जो ब्राउज़र को पता है और विक्रेता की नीलामी स्क्रिप्ट पुष्टि करना चाहते हैं.directFromSellerSignals
एक ऑब्जेक्ट है, जिसमें ये फ़ील्ड हो सकते हैं: **sellerSignals
:auctionConfig.sellerSignals
की तरह, लेकिनdirectFromSellerSignals
मैकेनिज़्म. **auctionSignals
:auctionConfig.auctionSignals
की तरह, लेकिनdirectFromSellerSignals
मैकेनिज़्म.
यहां browserSignals
का उदाहरण दिया गया है. ध्यान दें कि renderUrl
उम्मीदवार का विज्ञापन इन सिग्नल के ज़रिए उपलब्ध होता है:
{ 'topWindowHostname': 'www.example-publisher.com',
'interestGroupOwner': 'https://www.example-buyer.com',
'renderURL': 'https://cdn.com/render_url_of_bid',
'renderSize': {width: 100, height: 200}, /* if specified in the bid */
'adComponents': ['https://cdn.com/ad_component_of_bid',
'https://cdn.com/next_ad_component_of_bid',
...],
'biddingDurationMsec': 12,
'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}
reportResult()
विक्रेता को एक ऐसा reportResult()
फ़ंक्शन तय करना होगा जो
जिनके मालिकाना हक वाले एंडपॉइंट का मालिकाना हक उनके पास है. एंडपॉइंट की जानकारी, नीलामी कॉन्फ़िगरेशन में दी गई है
decisionLogicUrl
के तौर पर. reportResult()
फ़ंक्शन में ये शामिल हैं
हस्ताक्षर:
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
reportResult()
पैरामीटर ये हैं:
auctionConfig
, नीलामी करने के लिए इस्तेमाल किया जाने वाला नीलामी कॉन्फ़िगरेशन है.browserSignals
एक ऐसा ऑब्जेक्ट है जिसे ब्राउज़र ने बनाया है. इसमें ये शामिल हैं वह जानकारी जो ब्राउज़र को पता है और विक्रेता की नीलामी स्क्रिप्ट पुष्टि करना चाहते हैं. यह वही ऑब्जेक्ट है जिसेscoreAds()
फ़ंक्शन को पास किया गया है.
reportResult()
नतीजे के तौर पर signalsForWinner
दिखाता है, जो कि एक आर्बिट्रेरी JSON ऑब्जेक्ट है
जिसे जीतने वाले खरीदार के रिपोर्टिंग फ़ंक्शन को पास किया जाता है. इसमें यह जानकारी होनी चाहिए
नीलामी के बारे में विक्रेता द्वारा प्रदान की जा सकने वाली कोई भी प्रासंगिक जानकारी जो खरीदार
उनकी रिपोर्टिंग के लिए ज़रूरी है.
Protected Audience API से जुड़ी नीलामी चलाना
नीलामी करने के लिए, सेलर को चार मुख्य कदम उठाने होंगे. ध्यान दें कि इन इन चरणों में यह माना जाता है कि ज़रूरी JavaScript को लौटाने के लिए, विक्रेता के पास एंडपॉइंट सेट अप है के बारे में ज़्यादा जानकारी मिल सकती है.
- नीलामी कॉन्फ़िगर करें. इस चरण में
auctionConfig
ऑब्जेक्ट बनाना शामिल है. इससे विक्रेता यह तय कर पाता है कि किस खरीदार को इसमें भाग लेना चाहिए इसके अलावा, वे सुझाव भी देंगे जो बिड के दौरान काम के हो सकते हैं जेनरेशन या विज्ञापन स्कोरिंग. navigator.runAdAuction()
को कॉल करके नीलामी शुरू करें. पिछले चरण में बनाया गया कॉन्फ़िगरेशन. इससे खरीदारों की चेन शुरू हो जाती है बिड जनरेट करने के बाद, स्कोर तय करने में मदद मिलती है. इस चरण को पूरा करने के बाद आपको सीधे तौर पर विज्ञापन मिलता है जिसे किसी विज्ञापन को दिखाने के लिए रेंडर किया जा सकता है.- फ़ेंस किए गए फ़्रेम या iframe में जीतने वाले विज्ञापन को रेंडर करें.
- नीलामी के नतीजे की रिपोर्ट दें. यहां एक फ़ंक्शन है,
navigator.sendReportTo()
, इससे रिपोर्टिंग शुरू हो जाएगी. विक्रेता हमेशा नीलामी के परिणामों की रिपोर्ट पाने के लिए. सिर्फ़ वह खरीदार जिसने नीलामी जीती है को एक रिपोर्ट मिलेगी. यह विक्रेता के, ऊपर बताए गएreportResult()
का इस्तेमाल करता है इस गाइड को पढ़ें.