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

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

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

परिभाषाएं

नीलामी

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

खेल में हिस्सा लेने वाले खिलाड़ी

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

क्रम में होने वाली नीलामी का सेटअप

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

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

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

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

हेडर बिडिंग के हिसाब से होने वाली नीलामी के साथ, Protected Audience से जुड़ी एक से ज़्यादा सेलर वाली नीलामी के बारे में खास जानकारी.

खास जानकारी के डायग्राम के बारे में ज़्यादा जानकारी:

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

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

विज्ञापन देने वाले के पेज पर, दिलचस्पी के हिसाब से बनाए गए ग्रुप के समय का क्रम.

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

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

Prebid.js और प्रकाशक के विज्ञापन सर्वर की, काम के हिसाब से की जाने वाली नीलामियां

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

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

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

1. संदर्भ के हिसाब से नीलामी शुरू करना
   उपयोगकर्ता, पब्लिशर पेज पर जाता है.
2. पब्लिशर पेज, पब्लिशर ऐड सर्वर की क्लाइंट-साइड लाइब्रेरी लोड करता है और विज्ञापन स्लॉट के बारे में बताता है.
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 से जुड़ी नीलामी के समय का क्रम.

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

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

1. प्रकाशक साइट, टॉप लेवल सेलर की स्क्रिप्ट लोड करती है.
2. पब्लिशर के विज्ञापन सर्वर की क्लाइंट-साइड लाइब्रेरी, ज़रूरत के हिसाब से नीलामी के लिए बिड की कीमत और कॉम्पोनेंट की नीलामी से जुड़ी कॉन्फ़िगरेशन उपलब्ध कराती है. इसमें, खरीदारों से टॉप-लेवल सेलर को सिग्नल मिलते हैं. प्रासंगिक नीलामी जीतने वाली विज्ञापन बोली की कीमत को नीलामी कॉन्फ़िगरेशन में सेलर सिग्नल के रूप में पास किया जा सकता है (बोली की यह कीमत, टॉप लेवल सेलर के scoreAd() फ़ंक्शन में उपलब्ध होती है).
3. टॉप लेवल सेलर, runAdAuction() को कॉल करके Protected Audience से जुड़ी नीलामी शुरू करता है.
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 ऑब्जेक्ट या ओपेक URN देता है, तो नीलामी में जीतने वाले Protected Audience से जुड़े विज्ञापन को फ़ेंस किए गए फ़्रेम या iframe में रेंडर किया जा सकता है.

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

दिलचस्पी बढ़ाएं और सुझाव दें

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

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

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

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

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

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