हेडर बिडिंग और एक से ज़्यादा सेलर वाली Protected Audience नीलामी के साथ क्रम से होने वाली नीलामी का सेटअप

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

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

परिभाषाएं

नीलामी

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

पार्टी में शामिल लोग

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

सीक्वेंशियल ऑक्शन का सेटअप

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

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

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

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

हेडर बिडिंग की कॉन्टेक्स्टुअल नीलामी के साथ, Protected Audience की मल्टी-सेलर नीलामी के बारे में खास जानकारी.

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

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

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

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

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

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

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

पब्लिशर पेज पर, कॉन्टेक्स्ट के हिसाब से होने वाली नीलामी का टाइम क्रम.

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

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

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 API से जुड़ी कई सेलर वाली नीलामी

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

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

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

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 के तौर पर उपलब्ध हो सकती है. साथ ही, स्कोरिंग लॉजिक उस कॉन्टेक्स्टुअल ऑक्शन की बिड की कीमत की तुलना, सुरक्षित ऑडियंस कॉम्पोनेंट की नीलामी में जीतने वाली बिड की कीमत से कर सकता है.

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

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

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

दर्शकों से जुड़ना और सुझाव/राय देना या शिकायत करना

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

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

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

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

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

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