हेडर बिडिंग और एक से ज़्यादा सेलर वाली सुरक्षित ऑडियंस नीलामी की क्रम के मुताबिक सेटअप करना

पब्लिशर आम तौर पर, रेवेन्यू बढ़ाने के लिए विज्ञापन के डिमांड सोर्स में अलग-अलग तरह के विज्ञापन दिखाते हैं. साथ ही, पेज पर दिए गए विज्ञापन स्लॉट के लिए सबसे अच्छा विज्ञापन तय करने के लिए कई कंपनियों (उदाहरण के लिए, पब्लिशर के विज्ञापन सर्वर, सप्लाई-साइड प्लैटफ़ॉर्म, और डिमांड-साइड प्लैटफ़ॉर्म) का इस्तेमाल करते हैं. हेडर बिडिंग की मदद से पब्लिशर, किसी विज्ञापन स्लॉट के लिए अलग-अलग डिमांड सोर्स से बिड कैप्चर कर सकते हैं. क्रम के मुताबिक नीलामी के सेटअप में, हेडर बिडिंग लाइब्रेरी का इस्तेमाल, काम के डेटा वाली नीलामी के लिए किया जा सकता है. साथ ही, Protected Audience का इस्तेमाल, क्रॉस-साइट डेटा वाली नीलामी के लिए किया जाता है.

शुरू करने से पहले, Prebid.js दस्तावेज़ में Protected Audience पेज और हेडर बिडिंग की मदद से एपीआई की बुनियादी बातों के बारे में जानें.

परिभाषाएं

नीलामी

नीलामी	परिभाषा
कीवर्ड के हिसाब से नीलामी	ऐसी विज्ञापन नीलामी जिसमें नीलामी होने की जगह से जुड़े डेटा का इस्तेमाल किया जाता है. किसी खास नीलामी में, हेडर बिडिंग और सर्वर साइड नीलामी जैसी कई नीलामियां हो सकती हैं.
सुरक्षित ऑडियंस नीलामी	यह एक विज्ञापन नीलामी होती है, जिसमें किसी दूसरी साइट पर बनाए गए किसी इंटरेस्ट ग्रुप पर बिडिंग करना शामिल होता है.
एक से ज़्यादा सेलर वाली सुरक्षित ऑडियंस की नीलामी	दो-टीयर वाली Protected Audience ऑक्शन में, सबसे पहले पैरलल कॉम्पोनेंट की कई नीलामियों शामिल होती हैं. इसके बाद, ये सबसे ज़्यादा स्कोर वाले विज्ञापन को फ़ाइनल टॉप लेवल की नीलामी में सबमिट करती हैं.
टॉप-लेवल की नीलामी	Protected Audience की एक से ज़्यादा सेलर वाली नीलामी में होने वाली आखिरी विज्ञापन नीलामी. इससे, कॉम्पोनेंट नीलामी के विजेताओं के लिए स्कोर तय किया जाता है.
घटक नीलामी	एक से ज़्यादा सेलर वाली Protected Audience नीलामी में, नेस्ट की गई नीलामी होती है जिसमें हर कॉम्पोनेंट सेलर, अलग-अलग कॉम्पोनेंट की नीलामी साथ-साथ करता है. हर कॉम्पोनेंट नीलामी के सबसे ज़्यादा स्कोर वाले विज्ञापन, टॉप-लेवल की नीलामी में पास किए जाते हैं.
क्रम के मुताबिक होने वाली नीलामी का सेटअप	विज्ञापन नीलामी का ऐसा सेटअप जो काम की नीलामियों को, Protected Audience की नीलामी के साथ इंटिग्रेट करता है और दो नीलामियों में से किसी एक के विजेता का पता लगाता है.

लोग जो इवेंट में हिस्सा लेंगे

मीटिंग में हिस्सा लेने वाला व्यक्ति	परिभाषा
विज्ञापन देने वाला	विज्ञापन प्लेसमेंट की इच्छा रखने वाला पक्ष और विज्ञापन क्रिएटिव बनाता है.
पब्लिशर	नीलामी के लिए विज्ञापन इन्वेंट्री देने वाला पक्ष.
खरीदार	वह पक्ष जो किसी सेलर से विज्ञापन स्पेस खरीदने के लिए, नीलामी में बिड करता है. आम तौर पर, एक डिमांड-साइड प्लैटफ़ॉर्म (डीएसपी).
पब्लिशर का विज्ञापन सर्वर	इस सेवा का इस्तेमाल पब्लिशर, साइट पर रेंडर किए जाने वाले विज्ञापनों को मैनेज करने और चुनने के लिए करते हैं. पब्लिशर विज्ञापन सर्वर, किसी पब्लिशर को सबसे ज़्यादा आय देने वाले विज्ञापन का पता लगाने के लिए, अपने नीलामी के नतीजे, हेडर बिडर के जवाब, सीधे तौर पर बेची जाने वाली इन्वेंट्री वगैरह को एक साथ जोड़ सकता है. पब्लिशर विज्ञापन सर्वर, सर्वर के साथ इंटरैक्ट करने के लिए क्लाइंट-साइड लाइब्रेरी उपलब्ध करा सकता है.
टॉप-लेवल सेलर	वह पक्ष जो सुरक्षित ऑडियंस की एक से ज़्यादा सेलर वाली नीलामी को शुरू करता है और टॉप-लेवल की नीलामी में हिस्सा लेता है.
कॉम्पोनेंट सेलर	वह पक्ष जो पब्लिशर के विज्ञापन स्पेस को खरीदारों को बेचने के लिए, Protected Audience की एक से ज़्यादा सेलर वाली नीलामी में कॉम्पोनेंट की नीलामी करता है. आम तौर पर, एक सप्लाई-साइड प्लैटफ़ॉर्म (SSP).

क्रम के मुताबिक होने वाली नीलामी का सेटअप

क्रम से लगाई जाने वाली नीलामी के सेटअप में, पहले काम की नीलामियां की जाती हैं. इसके बाद, सुरक्षित ऑडियंस की नीलामी होती है. इस सेटअप की मदद से, पब्लिशर अपनी आय को ज़्यादा से ज़्यादा बढ़ा सकते हैं. इसके लिए, वे पेज पर मौजूद काम के डेटा का इस्तेमाल करके नीलामी शुरू कर सकते हैं. साथ ही, उपयोगकर्ताओं की निजता को सुरक्षित रखने के लिए, अलग-अलग साइटों के डेटा का इस्तेमाल करके नीलामी भी चला सकते हैं.

पब्लिशर के विज्ञापन सर्वर की नीलामी के लिए बिड इकट्ठा करने के लिए, हेडर बिडिंग लाइब्रेरी को पेज पर सबसे पहले चलाया जा सकता है. इसके बाद, कॉन्टेक्स्ट के हिसाब से की गई नीलामी की बोली लगाने की बदली हुई कीमत को, बिड के लिए तय की गई कम से कम रकम के तौर पर, सुरक्षित ऑडियंस की नीलामी में डाला जा सकता है. स्कोरिंग चरण के दौरान, कंपोज़िशन नीलामी बिड की कीमतों को बिड के कम से कम लेवल पर सेट करने के लिए, टॉप लेवल सेलर को ज़ीरो स्कोर असाइन किया जा सकता है. ऐसा तब किया जाता है, जब कारोबार की मांग के हिसाब से स्कोर का हिसाब लगाया जाता है. अगर कोई भी Protected Audience कॉम्पोनेंट, नीलामी की बिड बिड की निचली सीमा से ज़्यादा नहीं होती, तो उपयोगकर्ता को कॉन्टेक्स्ट के हिसाब से नीलामी में जीतने वाले विज्ञापन को दिखाया जाता है. अगर Protected Audience की नीलामी से कोई विजेता दिखता है, तो इसका मतलब है कि वह बिड के लिए तय की गई कम से कम सीमा से ज़्यादा है. साथ ही, Protected Audience की नीलामी में जीतने वाले विज्ञापन को उपयोगकर्ता को दिखाया जाता है.

ध्यान दें: इस दस्तावेज़ में दिए गए सेटअप में, Protected Audience को विज्ञापन दिखाने के मौजूदा तरीकों के साथ इंटिग्रेट करने का एक संभावित तरीका बताया गया है. हालांकि, यह एक और तरीका नहीं है. इस दस्तावेज़ में बताया गया है कि हेडर बिडिंग लाइब्रेरी में से एक, Prebid.js को Protected Audience के साथ कैसे इंटिग्रेट किया गया है.

क्रम के मुताबिक नीलामी सेटअप करने के इस उदाहरण में, पेज पर तीन बड़ी नीलामियां इस क्रम में की जा सकती हैं: 1) हेडर बिडिंग लाइब्रेरी के हिसाब से कीवर्ड के हिसाब से नीलामी, 2) पब्लिशर के विज्ञापन सर्वर के हिसाब से नीलामी, और 3) सुरक्षित ऑडियंस की नीलामी.

हेडर बिडिंग के कॉन्टेक्स्ट में नीलामी के साथ सुरक्षित ऑडियंस की एक से ज़्यादा सेलर वाली नीलामी के बारे में खास जानकारी.

खास जानकारी वाले डायग्राम की पूरी जानकारी:

1. नीलामी से पहले, उपयोगकर्ता को विज्ञापन देने वाली कंपनी की साइट पर इंटरेस्ट ग्रुप में जोड़ दिया जाता है.
2. जब उपयोगकर्ता बाद में किसी पब्लिशर पेज पर जाता है, तो Prebid.js हेडर पर बोली लगाने वालों से बोली के जवाब इकट्ठा करने के लिए, काम की नीलामी करता है. इस चरण के दौरान, खरीदार ये सिग्नल दे सकते हैं और सेलर, नीलामी से जुड़े कॉम्पोनेंट के कॉन्फ़िगरेशन दे सकते हैं, ताकि उनका इस्तेमाल सुरक्षित ऑडियंस की बाद की नीलामी में किया जा सके. Prebid.js इन सिग्नल और कॉन्फ़िगरेशन को सुरक्षित ऑडियंस नीलामी में लागू करने के लिए, एक मॉड्यूल उपलब्ध कराता है.
3. Prebid.js से इकट्ठा किए गए बिड रिस्पॉन्स, पब्लिशर विज्ञापन सर्वर को सर्वर-साइड के हिसाब से नीलामी के लिए भेजे जाते हैं.
4. पब्लिशर विज्ञापन सर्वर, किसी पब्लिशर को सबसे ज़्यादा आय देने वाले विज्ञापन का पता लगाने के लिए, अपने नीलामी के नतीजे, हेडर बिडिंग के नतीजे, सीधे तौर पर बेची जाने वाली इन्वेंट्री वगैरह को एक साथ जोड़ सकता है. जीतने वाले विज्ञापन को पब्लिशर विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी में वापस भेज दिया जाता है.
5. कॉन्टेक्स्ट के हिसाब से नीलामी के विजेता की बिड की बदली गई कीमत के साथ-साथ, Prebid.js से इकट्ठा किए गए खरीदार के सिग्नल (perBuyerSignals) और विक्रेता के कॉम्पोनेंट नीलामी के कॉन्फ़िगरेशन को, Publisher Ad Server की क्लाइंट-साइड लाइब्रेरी की मदद से सुरक्षित ऑडियंस की नीलामी में पास किया जा सकता है.
6. सुरक्षित ऑडियंस की एक से ज़्यादा सेलर वाली नीलामी, टॉप लेवल सेलर करता है. टॉप लेवल सेलर के स्कोरिंग चरण के दौरान, टॉप लेवल का सेलर, नीलामी में हिस्सा लेने वाली हर बिड की कीमत की तुलना, नीलामी में बिड घटाने या बढ़ाने की स्थिति के हिसाब से तय की गई कीमत से कर सकता है. अगर कॉम्पोनेंट बिड की कीमत, कॉन्टेक्स्ट के हिसाब से नीलामी के लिए बिड की कीमत से कम है, तो टॉप-लेवल वाला सेलर, कारोबार के हिसाब से बिड की कीमत 0 दिखाता है. अगर सभी बिड का स्कोर 0 है, तो runAdAuction() कॉल null दिखाता है. इसका मतलब है कि कॉन्टेक्स्ट के हिसाब से नीलामी में जीतने वाले विज्ञापन को रेंडर किया जाना चाहिए.
7. Publisher Ad Server की क्लाइंट-साइड लाइब्रेरी, runAdAuction() कॉल से मिले कॉन्टेंट के आधार पर, जीतने वाले Protected Audience विज्ञापन या कॉन्टेक्स्ट के हिसाब से विज्ञापन को रेंडर करती है.
8. सबसे अच्छा परफ़ॉर्म करने वाला विज्ञापन, उपयोगकर्ता को दिखाया जाता है.

नीलामी से पहले

विज्ञापन देने वाले के पेज पर इंटरेस्ट ग्रुप का समय का क्रम.

नीलामी से पहले, जब उपयोगकर्ता विज्ञापन देने वाले के किसी पेज पर जाता है, तो खरीदार और विज्ञापन देने वाला, साइट के इंटरेस्ट ग्रुप तय कर सकते हैं. साथ ही, विज्ञापन देने वाले व्यक्ति या कंपनी की साइट और पहले पक्ष के डेटा से जुड़ा काम का डेटा जोड़ सकते हैं, ताकि बाद में उस डेटा को नीलामी के लिए सिग्नल के तौर पर इस्तेमाल किया जा सके.

1. उपयोगकर्ता विज्ञापन देने वाले की साइट पर जाता है.
2. विज्ञापन देने वाली साइट पर, नीलामी में हिस्सा लेने वाले हर खरीदार के लिए यह स्क्रिप्ट लोड की जाती है. हालांकि, इसमें बाद में कभी भी, यह स्क्रिप्ट लोड होती है.
3. खरीदार की स्क्रिप्ट में, उपयोगकर्ता को खरीदार के इंटरेस्ट ग्रुप में जोड़ने के लिए joinAdInterestGroup() कॉल शामिल होता है.

Prebid.js और Publisher Ad Server के साथ काम की नीलामियां

पब्लिशर पेज पर, नीलामी के समय का क्रम.

क्रम के मुताबिक होने वाली नीलामी के सेटअप में, सुरक्षित ऑडियंस की नीलामी शुरू होने से पहले, कॉन्टेक्स्ट के हिसाब से सभी नीलामियां की जाती हैं. इस दस्तावेज़ में बताए गए सेटअप में, हम Prebid.js की मदद से हेडर बिडिंग के कॉन्टेक्स्ट के हिसाब से नीलामी करते हैं. इस नीलामी को पब्लिशर विज्ञापन सर्वर, सर्वर साइड नीलामी में फ़ीड करता है.

पब्लिशर, सबसे पहले फ़्लैग के साथ Prebid.js को कॉल करके, हेडर बिडिंग के हिसाब से नीलामी शुरू करता है. ऐसा इसलिए किया जाता है, ताकि यह जानकारी दी जा सके कि सुरक्षित ऑडियंस से जुड़ी नीलामी इसके बाद की जाएगी. इसके बाद, Prebid.js, बिड के जवाबों को इकट्ठा करता है और उन्हें सर्वर-साइड के हिसाब से नीलामी के लिए, Publisher Ad Server को भेजता है. बिड रिस्पॉन्स इकट्ठा करने के चरण के दौरान, अगर खरीदार और सेलर इस नीलामी में हिस्सा लेना चाहते हैं, तो उनके पास कॉम्पोनेंट नीलामी के कॉन्फ़िगरेशन और खरीदारों के सिग्नल (perBuyerSignals) देने का मौका होता है. इसका इस्तेमाल, बाद में होने वाली प्रोटेक्टेड ऑडियंस नीलामी में किया जा सकता है. कॉम्पोनेंट नीलामी का वह कॉन्फ़िगरेशन बाद में, सुरक्षित ऑडियंस की नीलामी में पास हो जाएगा.

1. संदर्भ के हिसाब से नीलामी शुरू करना
   उपयोगकर्ता, पब्लिशर पेज पर जाता है.
2. पब्लिशर पेज, Publisher Ad Server की क्लाइंट-साइड लाइब्रेरी लोड करता है और विज्ञापन स्लॉट के बारे में जानकारी देता है.
3. पब्लिशर पेज, Prebid को लोड करता है और हेडर बिडिंग के हिसाब से नीलामी शुरू करता है.
4. विक्रेता A की नीलामी
   (विक्रेता B की प्रासंगिक नीलामी के साथ चल रही है)
   Prebid.js विक्रेता A को बोली अनुरोध भेजते हैं.
5. विक्रेता A, खरीदारों से बिड रिस्पॉन्स और perBuyerSignals वापस लाता है.
6. सेलर A, कीवर्ड के हिसाब से नीलामी करता है.
7. सेलर A, कॉम्पोनेंट की नीलामी का कॉन्फ़िगरेशन बनाता है, जिसमें perBuyerSignals शामिल होता है.
8. विक्रेता A, जीतने वाली बोली और उसके कॉम्पोनेंट की नीलामी के कॉन्फ़िगरेशन के साथ, Prebid.js का जवाब देता है.
9. विक्रेता B की प्रासंगिक नीलामी
   (विक्रेता A की प्रासंगिक नीलामी के साथ चलती है)
   Prebid.js विक्रेता B को एक बोली अनुरोध भेजता है.
10. विक्रेता B, खरीदारों से बिड के जवाब और perBuyerSignals वापस लाता है.
11. विक्रेता B, संदर्भ के हिसाब से नीलामी करता है.
12. विक्रेता B, perBuyerSignals के साथ कॉम्पोनेंट नीलामी का कॉन्फ़िगरेशन बनाता है.
13. विक्रेता B, जीतने वाली बोली और उसके कॉम्पोनेंट की नीलामी के कॉन्फ़िगरेशन के साथ, Prebid.js का जवाब देता है.
14. पब्लिशर विज्ञापन सर्वर की कॉन्टेक्स्ट के हिसाब से नीलामी
    Prebid.js से इकट्ठा किए गए बिड के जवाब, पब्लिशर के विज्ञापन सर्वर को भेजे जाते हैं, ताकि नीलामी के हिसाब से ये नतीजे मिल सकें.
15. खरीदारों के सिग्नल के साथ कॉम्पोनेंट नीलामी का कॉन्फ़िगरेशन, पब्लिशर विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी के साथ शेयर किया जाता है
16. पब्लिशर विज्ञापन सर्वर, सीधे तौर पर बेचे जाने वाले कैंपेन, प्रोग्रामैटिक बिड, और Prebid के काम के हिसाब से लगाई गई बिड, और अन्य इन्वेंट्री के बीच सबसे अच्छे विज्ञापन को तय करने के लिए, कॉन्टेक्स्ट के हिसाब से नीलामी करता है.
17. पब्लिशर का विज्ञापन सर्वर, अडजस्ट की गई बिड दिखाता है.

एक से ज़्यादा सेलर वाली सुरक्षित ऑडियंस की नीलामी

पब्लिशर पेज पर, Protected Audience की ऑक्शन टाइम सीरीज़

इस चरण में, कॉन्टेक्स्ट के हिसाब से की गई नीलामियां पूरी हो गई हैं. इसके बाद, Publisher Ad Server की क्लाइंट-साइड लाइब्रेरी, कॉन्टेक्स्ट के हिसाब से नीलामी में जीतने वाली बिड की कीमत, कॉम्पोनेंट की नीलामी के कॉन्फ़िगरेशन, और Protected Audience की नीलामी में हिस्सा लेने वाले खरीदारों के सिग्नल, टॉप लेवल के सेलर को पास कर सकती है. कीवर्ड के हिसाब से बिड की वह कीमत जिसे फ़्लोर के तौर पर सेट किया जाता है, उसे नीलामी कॉन्फ़िगरेशन में पास किया जा सकता है. यह कीमत, टॉप लेवल की नीलामी में शामिल होने के सिग्नल के तौर पर होती है.

कॉम्पोनेंट की नीलामियां साथ-साथ ही की जाती हैं. साथ ही, हर कॉम्पोनेंट की नीलामी में ब्राउज़र, उस कॉम्पोनेंट की नीलामी में हिस्सा लेने वाले हर खरीदार के बिडिंग लॉजिक के आधार पर बिड जनरेट करता है. इसके बाद, कॉम्पोनेंट सेलर के स्कोरिंग लॉजिक का इस्तेमाल करके हर बिड को स्कोर करता है, और फिर सबसे ज़्यादा स्कोर वाले विज्ञापन को टॉप लेवल की नीलामी में दिखाता है.

1. पब्लिशर साइट, टॉप लेवल के सेलर की स्क्रिप्ट लोड करती है.
2. पब्लिशर के विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी, कॉन्टेक्स्ट के हिसाब से नीलामी के लिए बिड की कीमत और कॉम्पोनेंट की नीलामी के कॉन्फ़िगरेशन की जानकारी देती है. इसमें खरीदारों से टॉप लेवल सेलर तक के सिग्नल शामिल होते हैं. संदर्भ के हिसाब से नीलामी में जीतने वाली विज्ञापन बिड की कीमत को, सेलर सिग्नल के तौर पर नीलामी कॉन्फ़िगरेशन में पास किया जा सकता है. बिड की यह कीमत, टॉप लेवल सेलर के scoreAd() फ़ंक्शन में उपलब्ध होती है.
3. टॉप-लेवल विक्रेता, runAdAuction() को कॉल करके सुरक्षित ऑडियंस की नीलामी शुरू करता है.
4. सेलर A कॉम्पोनेंट की नीलामी
   (सेलर B की कॉम्पोनेंट नीलामी के साथ चलने पर)
   ब्राउज़र, सेलर A की कॉम्पोनेंट नीलामी में हिस्सा लेने वाले सभी खरीदारों के लिए, उपयोगकर्ता की दिलचस्पी के ग्रुप को पढ़ता है.
5. ब्राउज़र, कॉम्पोनेंट नीलामी में हिस्सा लेने वाले खरीदारों के इंटरेस्ट ग्रुप में बताई गई जगहों से, बिडिंग स्क्रिप्ट और भरोसेमंद बिडिंग सिग्नल फ़ेच करता है.
6. ब्राउज़र, हर खरीदार के बिड जनरेट करने के लॉजिक को लागू करके बिड जनरेट करता है.
7. ब्राउज़र, विक्रेता A से हर विज्ञापन की स्कोरिंग स्क्रिप्ट और भरोसेमंद स्कोर सिग्नल फ़ेच करता है.
8. ब्राउज़र हर बिड के लिए, सेलर A के स्कोरिंग लॉजिक को लागू करता है.
9. ब्राउज़र, उस विज्ञापन को चुनता है जिसके स्कोर को सेलर A के स्कोरिंग लॉजिक से सबसे ज़्यादा स्कोर किया जाता है.
10. सेलर B के कॉम्पोनेंट की नीलामी
    (सेलर A की कॉम्पोनेंट की नीलामी के साथ चलने वाली)
    ब्राउज़र, सेलर B की कॉम्पोनेंट नीलामी में हिस्सा लेने वाले सभी खरीदारों के लिए, उपयोगकर्ता की दिलचस्पी के ग्रुप को पढ़ता है.
11. ब्राउज़र, कॉम्पोनेंट नीलामी में हिस्सा लेने वाले खरीदारों के इंटरेस्ट ग्रुप में बताई गई जगहों से, बिडिंग स्क्रिप्ट और भरोसेमंद बिडिंग सिग्नल फ़ेच करता है.
12. ब्राउज़र, हर खरीदार के बिड जनरेट करने के लॉजिक को लागू करके बिड जनरेट करता है.
13. ब्राउज़र, विक्रेता B से हर विज्ञापन की स्कोरिंग स्क्रिप्ट और भरोसेमंद स्कोर सिग्नल फ़ेच करता है.
14. ब्राउज़र हर बिड के लिए, सेलर B का स्कोरिंग लॉजिक लागू करता है.
15. ब्राउज़र उस विज्ञापन को चुनता है जिसके स्कोर को, सेलर B के स्कोरिंग लॉजिक के हिसाब से सबमिट किया जाता है.

नीलामी की टॉप-लेवल की स्कोरिंग और विज्ञापन रेंडरिंग

पब्लिशर पेज पर विज्ञापन रेंडरिंग का क्रम.

पिछले सेक्शन की कॉम्पोनेंट की नीलामियां होने के बाद, ब्राउज़र हर कॉम्पोनेंट नीलामी के जीतने वाले विज्ञापन पर, टॉप लेवल के सेलर का स्कोरिंग लॉजिक लागू करता है. टॉप लेवल सेलर के scoreAd() फ़ंक्शन में, कॉन्टेक्स्ट के हिसाब से नीलामी में बदलाव की गई बिड की कीमत sellerSignals के तौर पर उपलब्ध हो सकती है. साथ ही, स्कोरिंग लॉजिक, कॉन्टेक्स्ट के हिसाब से नीलामी की बिड की कीमत की तुलना, Protected Audience कॉम्पोनेंट की नीलामी में जीतने वाली बिड की कीमत से कर सकता है.

अगर कॉन्टेक्स्ट के हिसाब से नीलामी में जीतने वाली बिड की कीमत, कॉम्पोनेंट नीलामी की जीतने वाली बिड की कीमत से ज़्यादा है, तो scoreAd() फ़ंक्शन, पसंद के हिसाब से 0 का स्कोर दिखा सकता है. अगर ज़रूरी स्कोर 0 से ज़्यादा नहीं है, तो इसका मतलब है कि कॉन्टेक्स्ट के हिसाब से नीलामी में जीतने वाला विज्ञापन, किसी भी नीलामी जीतने वाले विज्ञापन की तुलना में ज़्यादा अहम है और runAdAuction() फ़ंक्शन, null दिखाता है.

अगर Protected Audience की नीलामी का कोई विजेता नहीं होता और null दिखाता है, तो पब्लिशर की विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी, कॉन्टेक्स्ट के हिसाब से नीलामी के विजेता को iframe में रेंडर कर सकती है. अगर Protected Audience की नीलामी, कॉन्टेक्स्ट के हिसाब से होने वाली नीलामी में विजेता होती है और FencedFrameConfig ऑब्जेक्ट या ओपेक यूआरएन दिखाती है, तो Protected Audience में दिखने वाले नीलामी के जीतने वाले विज्ञापन को फ़्रेम में रखे गए फ़्रेम या iframe में दिखाया जा सकता है.

1. नीलामी में विज्ञापन की टॉप-लेवल की रेटिंग
   ब्राउज़र, हर विज्ञापन के लिए भरोसेमंद स्कोर के सिग्नल के साथ, टॉप लेवल सेलर से स्कोरिंग स्क्रिप्ट फ़ेच करता है.
2. ब्राउज़र, सभी कॉम्पोनेंट नीलामियों में जीतने वाली हर बिड के लिए, टॉप लेवल के सेलर के स्कोरिंग लॉजिक को लागू करता है. टॉप लेवल के सेलर की scoreAd() स्क्रिप्ट में, लॉजिक के पास कॉन्टेक्स्ट के हिसाब से नीलामी में हिस्सा लेने वाली बिड की उस कीमत का ऐक्सेस होता है जिसे नीलामी के कॉन्फ़िगरेशन में sellerSignals के तौर पर पास किया गया हो. स्क्रिप्ट जीतने वाली कॉन्टेक्स्ट के हिसाब से बिड की कीमत की तुलना, कॉम्पोनेंट की प्रोटेक्टेड ऑडियंस की बिड की कीमत से कर सकती है. साथ ही, अगर कॉन्टेक्स्ट के हिसाब से कीमत ज़्यादा है, तो वह 0 का स्कोर दिखा सकती है. ऐसा नहीं होने पर स्क्रिप्ट, प्रोटेक्टेड ऑडियंस की बोली की कीमत के आधार पर ज़रूरी स्कोर का हिसाब लगाती है.
3. ब्राउज़र उस विज्ञापन को चुनता है जिसकी पसंद के हिसाब से सबसे ज़्यादा स्कोर मिलता है. यह स्कोर, टॉप लेवल के सेलर के स्कोरिंग लॉजिक के आधार पर सबमिट किया जाता है.
4. अगर Protected Audience की नीलामी जीत जाती है
   Protected Audience की नीलामी में, पब्लिशर के विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी में FencedFrameConfig ऑब्जेक्ट या ओपेक यूआरएन दिखता है.
5. क्लाइंट-साइड लाइब्रेरी, फ़ेंस किए गए फ़्रेम के config एट्रिब्यूट को FencedFrameConfig ऑब्जेक्ट पर सेट करती है या iframe के src एट्रिब्यूट को, जीतने वाले Protected Audience विज्ञापन के ओपेक URN पर सेट करती है.
6. ब्राउज़र, सुरक्षित ऑडियंस की मदद से नीलामी जीतने वाले विज्ञापन को, खरीदार से फ़ेच करता है.
7. ब्राउज़र, उपयोगकर्ता को विज्ञापन दिखाता है.
8. अगर कॉन्टेक्स्ट के हिसाब से की जाने वाली नीलामी में जीत होती है
   , Protected Audience की नीलामी में null नतीजे दिखते हैं.
9. ब्राउज़र, iframe की src एट्रिब्यूट को, काम के हिसाब से नतीजे दिखाने वाले विज्ञापन पर सेट करता है.
10. ब्राउज़र, खरीदार से संदर्भ के हिसाब से नीलामी जीतने वाला विज्ञापन फ़ेच करता है.
11. ब्राउज़र, उपयोगकर्ता को विज्ञापन दिखाता है.

दिलचस्पी दिखाएं और सुझाव/राय दें या शिकायत करें

आगे क्या करना है?

हम आपके साथ मिलकर ऐसा एपीआई बनाना चाहते हैं जो सभी के काम आ सके.

एपीआई पर चर्चा करें

दूसरे प्राइवसी सैंडबॉक्स एपीआई की तरह, इस एपीआई को भी दस्तावेज़ के तौर पर दिखाया जाता है और सार्वजनिक तौर पर इस पर चर्चा की जाती है.

एपीआई के साथ प्रयोग करें

Protected Audience API के बारे में बातचीत में, एक्सपेरिमेंट किया जा सकता है और इसमें हिस्सा लिया जा सकता है.