Protected Audience API की खास जानकारी

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

यह दस्तावेज़ किसके लिए है?

इस दस्तावेज़ में, Protected Audience API के बारे में बुनियादी जानकारी दी गई है. साथ ही, इससे जुड़े कुछ बुनियादी सिद्धांतों के बारे में बताया गया है. हालांकि, इसमें ज़्यादा तकनीकी जानकारी शामिल नहीं है.

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

Protected Audience के दस्तावेज़ में इस्तेमाल किए गए शब्दों के बारे में जानने के लिए, ग्लॉसरी देखें. इस दस्तावेज़ के आखिर में, जुड़ने और सुझाव/राय देने या शिकायत करने का तरीका जानें.

Protected Audience API क्या है?

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

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

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

एक मिनट में Protected Audience API के बारे में जानकारी

Protected Audience API के बारे में ज़्यादा जानकारी पाने के लिए, Protected Audience API डेवलपर गाइड पढ़ें.

Protected Audience API, दिलचस्पी वाले ग्रुप का इस्तेमाल करता है. इससे साइटें, अपने उपयोगकर्ताओं को काम के विज्ञापन दिखा पाती हैं.

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

• दिलचस्पी वाले ग्रुप का नाम: उदाहरण के लिए, 'कस्टम-बाइक'.
• इंटरेस्ट ग्रुप का मालिक: उदाहरण के लिए, 'https://dsp.example'.
• दिलचस्पी के हिसाब से बनाए गए ग्रुप की कॉन्फ़िगरेशन की जानकारी, ताकि ब्राउज़र को बिडिंग कोड, विज्ञापन कोड, और रीयल-टाइम डेटा को ऐक्सेस करने की अनुमति मिल सके. ऐसा तब होता है, जब ग्रुप के मालिक को विज्ञापन नीलामी में बिड करने के लिए न्योता भेजा जाता है.

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

बिड सिर्फ़ उन दिलचस्पी वाले ग्रुप के ज़रिए दी जा सकती हैं जिनमें ब्राउज़र सदस्य है. साथ ही, जिनके मालिकों को बिड करने का न्योता भेजा गया है.

बिडिंग कोड, दिलचस्पी वाले ग्रुप के कॉन्फ़िगरेशन में दिए गए यूआरएल से वापस पाया जाता है. यह कोड, दिलचस्पी वाले ग्रुप और सेलर की जानकारी देता है. साथ ही, पेज और ब्राउज़र से कॉन्टेक्स्ट के हिसाब से डेटा भी देता है.

बिड करने वाले हर इंटरेस्ट ग्रुप को खरीदार कहा जाता है.

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

सबसे अच्छा परफ़ॉर्म करने वाले विज्ञापन को फ़ेन्स्ड फ़्रेम में दिखाया जाता है. विज्ञापन क्रिएटिव का यूआरएल, बिड में दिया गया होता है. साथ ही, ओरिजिन, दिलचस्पी वाले ग्रुप के कॉन्फ़िगरेशन में दी गई सूची में से किसी एक से मेल खाना चाहिए.

सेलर, नीलामी के नतीजे (reportResult()) की शिकायत कर सकता है. साथ ही, खरीदार अपनी जीत (reportWin()) की शिकायत कर सकते हैं.

Protected Audience की नीलामी की रिपोर्ट के बारे में जानें.

हमें Protected Audience API की ज़रूरत क्यों है?

उपयोगकर्ता की दिलचस्पी को समझने से, साइट के कॉन्टेंट (कॉन्टेक्स्ट के हिसाब से टारगेटिंग) या विज्ञापन दिखाने वाली साइट पर उपयोगकर्ता की ओर से दी गई जानकारी (पहले पक्ष का डेटा इस्तेमाल करके टारगेटिंग) के आधार पर विज्ञापन चुनने के बजाय, ज़्यादा काम के विज्ञापन दिखाए जा सकते हैं.

आम तौर पर, विज्ञापन प्लैटफ़ॉर्म, उपयोगकर्ताओं की दिलचस्पी के बारे में जानने के लिए, अलग-अलग साइटों पर उनकी गतिविधियों को ट्रैक करते हैं. ब्राउज़र को विज्ञापन प्लैटफ़ॉर्म को यह सुविधा देनी होगी कि वे काम के विज्ञापन चुन सकें. इससे कॉन्टेंट पब्लिशर को, क्रॉस-साइट ट्रैकिंग के बिना विज्ञापन से मिलने वाला रेवेन्यू मिल सकेगा.

Protected Audience API का मकसद, वेब प्लैटफ़ॉर्म को ऐसी स्थिति में लाना है जहां उपयोगकर्ता के डिवाइस पर मौजूद ब्राउज़र के पास यह जानकारी हो कि उस व्यक्ति की दिलचस्पी किस चीज़ में है. यह जानकारी, विज्ञापन देने वाले व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी प्लैटफ़ॉर्म के पास नहीं होनी चाहिए.

मैं Protected Audience API को कैसे आज़माऊं?

• Protected Audience API डेवलपर गाइड में, एपीआई इस्तेमाल करने और स्थानीय तौर पर इसकी जांच करने का तरीका बताया गया है.

• protected-audience-demo.web.app, विज्ञापन देने वाले व्यक्ति या कंपनी और पब्लिशर की साइटों पर Protected Audience को बुनियादी तौर पर डिप्लॉय करने के बारे में जानकारी देता है. Protected Audience के डेमो वीडियो में बताया गया है कि यह कोड कैसे काम करता है. साथ ही, इसमें डीबग करने के लिए Chrome DevTools इस्तेमाल करने का तरीका दिखाया गया है.

ब्राउज़र का कौनसा कॉन्फ़िगरेशन उपलब्ध है?

उपयोगकर्ता, Chrome में Privacy Sandbox के ट्रायल में हिस्सा लेने की सेटिंग में बदलाव कर सकते हैं. इसके लिए, उन्हें chrome://settings/adPrivacy में जाकर टॉप-लेवल की सेटिंग को चालू या बंद करना होगा. शुरुआती टेस्टिंग के दौरान, उपयोगकर्ता Privacy Sandbox की सेटिंग का इस्तेमाल करके, Protected Audience API से ऑप्ट आउट कर सकते हैं.

Chrome, उपयोगकर्ताओं को उन दिलचस्पी वाले ग्रुप की सूची देखने और मैनेज करने की सुविधा देगा जिनमें उन्हें उन साइटों पर जोड़ा गया है जिन पर उन्होंने विज़िट किया है. Privacy Sandbox की टेक्नोलॉजी की तरह ही, उपयोगकर्ता की सेटिंग में भी बदलाव हो सकता है. ऐसा उपयोगकर्ताओं, रेगुलेटर, और अन्य लोगों से मिले सुझाव/राय के आधार पर किया जाता है.

Protected Audience API के डेवलपमेंट के साथ-साथ, हम Chrome में उपलब्ध सेटिंग को अपडेट करते रहेंगे. यह अपडेट, टेस्ट और मिले सुझाव, शिकायत या राय के आधार पर किया जाएगा. आने वाले समय में, हम Protected Audience और उससे जुड़े डेटा को मैनेज करने के लिए, ज़्यादा बेहतर सेटिंग उपलब्ध कराएंगे.

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

क्या Protected Audience API से ऑप्ट आउट किया जा सकता है?

साइट के मालिक या उपयोगकर्ता के तौर पर, Protected Audience API के ऐक्सेस को ब्लॉक करने का तरीका जानें.

मुख्य सिद्धांत

क्या आपको Protected Audience की शब्दावली के बारे में ज़्यादा जानकारी चाहिए? Privacy Sandbox की शब्दावली देखें.

दिलचस्पी रखने वाले लोगों का ग्रुप क्या होता है?

Protected Audience API इंटरेस्ट ग्रुप, एक जैसी दिलचस्पी वाले लोगों के ग्रुप को दिखाता है. यह रीमार्केटिंग सूची से मेल खाता है.

Protected Audience API के हर इंटरेस्ट ग्रुप का एक मालिक होता है. अलग-अलग तरह के मालिक, अलग-अलग इस्तेमाल के उदाहरणों के साथ अलग-अलग तरह के दिलचस्पी वाले ग्रुप बनाएंगे.

ग्रुप का मालिक, उपयोगकर्ता के ब्राउज़र से एक जैसी दिलचस्पी वाले ग्रुप की सदस्यता जोड़ने के लिए कहता है. इसके लिए, वह JavaScript फ़ंक्शन navigator.joinAdInterestGroup() को कॉल करता है. साथ ही, दिलचस्पी वाले ग्रुप से जुड़े विज्ञापनों के डेटा और बिडिंग में इस्तेमाल किए गए JavaScript के यूआरएल जैसी जानकारी देता है. दिलचस्पी के हिसाब से बनाए गए ग्रुप के डेटा (जैसे कि विज्ञापन) को अपडेट किया जा सकता है. साथ ही, दिलचस्पी के हिसाब से बनाए गए ग्रुप को ज़्यादा से ज़्यादा 30 दिनों के लिए चालू किया जा सकता है.

एक जैसी दिलचस्पी वाले ग्रुप के टाइप

नीचे दी गई टेबल में, Protected Audience API के अलग-अलग तरह के इंटरेस्ट ग्रुप और उनके मालिकों के उदाहरण दिए गए हैं.

Chrome, हर मालिक के लिए ज़्यादा से ज़्यादा 1,000 दिलचस्पी वाले ग्रुप और ज़्यादा से ज़्यादा 1,000 दिलचस्पी वाले ग्रुप के मालिकों की अनुमति देता है. इन सीमाओं को सुरक्षा के लिए बनाया गया है. इनका इस्तेमाल सामान्य तौर पर नहीं किया जाना चाहिए.

खरीदार कौन होता है?

Protected Audience API में, खरीदार वह पार्टी होती है जिसके पास इंटरेस्ट ग्रुप का मालिकाना हक होता है और जो विज्ञापन की नीलामी में बोली लगाती है.

उदाहरण के लिए:

• विज्ञापन देने वाला व्यक्ति या कंपनी: खुद के लिए विज्ञापन दिखा रही है.
• डिमांड-साइड प्लैटफ़ॉर्म (डीएसपी): यह विज्ञापन देने वाले लोगों या कंपनियों के लिए काम करता है.
• इंटरेस्ट ग्रुप का मालिक: यह विज्ञापन देने वाले कई लोगों या कंपनियों के लिए काम करता है.

खरीदारों के तीन काम होते हैं:

• नीलामी में हिस्सा लेना है या नहीं, यह चुनें.
• विज्ञापन चुनें और बिड का हिसाब लगाएं.
• नीलामी के नतीजे की शिकायत करें.

ये काम प्रोग्राम के हिसाब से किए जाते हैं. इसके लिए, खरीदार की ओर से उपलब्ध कराया गया कोड इस्तेमाल किया जाता है. यह कोड, Protected Audience API की मदद से होने वाली विज्ञापन नीलामी के दौरान चलता है.

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

• बिडिंग कोड के लिए यूआरएल. इसका इस्तेमाल तब किया जाएगा, जब सेलर, विज्ञापन की नीलामी करेगा.
• संभावित तौर पर, दिलचस्पी वाले ग्रुप के लिए विज्ञापन क्रिएटिव के यूआरएल. (विज्ञापन के यूआरएल को बाद में अपडेट करके जोड़ा जा सकता है.)
• क्वेरी की जाने वाली डेटा कुंजियों की सूची और खरीदार की कुंजी/वैल्यू सेवा का यूआरएल. इससे बिडिंग कोड को नीलामी के दौरान रीयल-टाइम डेटा मिल सकेगा.

नीलामी के नतीजे की जानकारी देने के लिए, खरीदार के कोड में reportWin() फ़ंक्शन भी शामिल किया जा सकता है.

विज्ञापन की नीलामी कौन करता है?

विज्ञापन स्पेस बेचने के लिए, कई पक्ष नीलामी कर सकते हैं.

उदाहरण के लिए:

• कॉन्टेंट पब्लिशर: यह अपनी वेबसाइट पर विज्ञापन का कॉन्टेंट होस्ट करने के लिए काम करता है.
• सप्लाई-साइड प्लैटफ़ॉर्म (एसएसपी): यह पब्लिशर के साथ काम करता है और अन्य सेवाएं उपलब्ध कराता है.
• तीसरे पक्ष की स्क्रिप्ट: यह पब्लिशर के लिए काम करती है, ताकि विज्ञापन नीलामी में हिस्सा लिया जा सके.

Protected Audience API की मदद से, विज्ञापन स्पेस के सेलर को ये तीन काम करने होते हैं:

• पब्लिशर के नियमों को लागू करना: यह बताना कि कौनसे खरीदार और कौनसी बिड ज़रूरी शर्तें पूरी करती हैं.
• नीलामी का लॉजिक लागू करना: JavaScript, वर्कलेट में चलती है. इससे हर बिड के लिए, पसंद किए जाने का स्कोर कैलकुलेट किया जाता है.
• नीलामी के नतीजे की शिकायत करें.

ये काम प्रोग्राम के हिसाब से किए जाते हैं. इसके लिए, सेलर ने जो कोड दिया है उसका इस्तेमाल किया जाता है. सेलर, JavaScript फ़ंक्शन navigator.runAdAuction() को कॉल करके विज्ञापन की नीलामी शुरू करता है.

Protected Audience API की मदद से होने वाली विज्ञापन नीलामी कैसे काम करती है?

यहां दिए गए डायग्राम में, Protected Audience API की मदद से होने वाली विज्ञापन नीलामी के हर चरण के बारे में बताया गया है:

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

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

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

1. कोई उपयोगकर्ता ऐसी साइट पर जाता है जिस पर विज्ञापन दिखाए जाते हैं.
2. विक्रेता का कोड, नीलामी शुरू करता है. विज्ञापन स्पेस बेचने वाला व्यक्ति या कंपनी यह तय करती है कि कौनसे विज्ञापन स्पेस को बेचा जाना है और कौन बिड कर सकता है. साथ ही, वह बिड को स्कोर करने का तरीका भी तय करती है.
3. न्योता पाए खरीदार का कोड, बिड, काम के विज्ञापन क्रिएटिव के लिए यूआरएल, और अन्य डेटा जनरेट करता है. बिडिंग स्क्रिप्ट, खरीदार की कुंजी/वैल्यू सेवा से रीयल-टाइम डेटा के लिए क्वेरी कर सकती है. जैसे, विज्ञापन कैंपेन का बचा हुआ बजट.
4. सेलर का कोड, हर बिड को स्कोर करता है और विजेता चुनता है. यह लॉजिक, बिड की वैल्यू और अन्य डेटा का इस्तेमाल करके, बिड की अहमियत का पता लगाता है. साथ ही, उस विज्ञापन को अस्वीकार कर देता है जो कॉन्टेक्स्ट के हिसाब से सबसे अच्छा परफ़ॉर्म करने वाले विज्ञापन को नहीं हरा सकता. सेलर, रीयल-टाइम डेटा के लिए अपनी कुंजी/वैल्यू सेवा का इस्तेमाल कर सकता है. नीलामी शुरू होने से पहले, विक्रेता उपलब्ध विज्ञापन स्लॉट के लिए सबसे सही कॉन्टेक्स्ट के हिसाब से विज्ञापन ढूंढता है.
5. नीलामी के कॉन्फ़िगरेशन में resolveToConfig फ़्लैग सेट होने पर, जीतने वाले विज्ञापन को फ़ेंस किए गए फ़्रेम के कॉन्फ़िगरेशन ऑब्जेक्ट के तौर पर दिखाया जाता है. इस कॉन्फ़िगरेशन का इस्तेमाल, फ़ेन्स्ड फ़्रेम को विज्ञापन क्रिएटिव पर ले जाने के लिए किया जाता है. साथ ही, क्रिएटिव का यूआरएल सेलर और पब्लिशर, दोनों से छिपा रहता है. अगर resolveToConfig फ़्लैग को false पर सेट किया जाता है या इसे पास नहीं किया जाता है, तो जीतने वाले विज्ञापन को अपारदर्शी URN के तौर पर दिखाया जाता है. इसका इस्तेमाल, विज्ञापन को iframe में रेंडर करने के लिए किया जा सकता है. फ़ेंस किए गए फ़्रेम का कॉन्फ़िगरेशन ऑब्जेक्ट, M114 से उपलब्ध है.
6. नीलामी के बारे में सेलर और बिड जीतने वाले खरीदारों को सूचना दी जाती है.

खरीदारों के कम होने की वजह से होने वाले नुकसान के लिए, रिपोर्टिंग सिस्टम पर बातचीत चल रही है.

Protected Audience API की कुंजी/वैल्यू सेवा क्या है?

Protected Audience API की Key/Value सेवा की मदद से, विज्ञापन टेक्नोलॉजी कंपनियां रीयल-टाइम डेटा के लिए क्वेरी कर सकती हैं. ऐसा तब होता है, जब खरीदार बिड करता है. साथ ही, सेलर निजता बनाए रखते हुए विज्ञापनों को स्कोर कर सकते हैं. Protected Audience API की सेवाओं में, Protected Audience API की Key/Value सेवा और अन्य सेवाओं के बारे में पढ़ा जा सकता है.

Key/Value सेवा को, विज्ञापन टेक्नोलॉजी कंपनी के क्लाउड इंफ़्रास्ट्रक्चर पर डिप्लॉय किया जाता है. साथ ही, यह सेवा भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट में काम करती है. कुंजी/वैल्यू सेवा के लिए किए गए अनुरोध से, इवेंट-लेवल की लॉगिंग नहीं हो सकती या इसके अन्य साइड इफ़ेक्ट नहीं हो सकते. Key/Value सेवा, उपयोगकर्ता के तय किए गए फ़ंक्शन (यूडीएफ़) के साथ भी काम करेगी. इससे विज्ञापन टेक्नोलॉजी कंपनियां, Key/Value सेवा में अपना कस्टम लॉजिक लागू कर पाएंगी.

खरीदार या विक्रेता, 'कुंजियों' की एक सूची देता है. इससे यह पता चलता है कि उसे Protected Audience API की कुंजी/वैल्यू सेवा से कौन-सा डेटा चाहिए. कुंजी/वैल्यू सेवा, हर कुंजी के लिए वैल्यू का जवाब देती है.

Protected Audience API की Key/Value सेवा का कोड अब Privacy Sandbox के GitHub डेटा स्टोर में उपलब्ध है. इस सेवा का इस्तेमाल, Chrome और Android डेवलपर कर सकते हैं.

एपीआई के बारे में जानकारी देने वाले दस्तावेज़ और भरोसे के मॉडल के बारे में जानकारी देने वाले दस्तावेज़ में, Protected Audience API की मुख्य/वैल्यू सेवा के बारे में ज़्यादा जानें.

नीलामियों में रीयल-टाइम डेटा को कैसे शामिल किया जाता है?

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

Protected Audience API की निजता से जुड़ी ज़रूरी शर्तों को पूरा करने के लिए, विज्ञापन की नीलामी के दौरान ज़रूरी रीयल-टाइम डेटा, Key/Value सेवा उपलब्ध कराती है. जब हर खरीदार navigator.joinAdInterestGroup() को कॉल करता है, तो खरीदार, कुंजी/वैल्यू सेवा का यूआरएल तय करता है. साथ ही, उन कुंजियों के बारे में बताता है जिनके लिए नीलामी के दौरान सेवा से क्वेरी की जानी है. इसी तरह, जब सेलर navigator.runAdAuction() को कॉल करके विज्ञापन की नीलामी करता है, तो वह अपनी मुख्य/वैल्यू सेवा के लिए एक यूआरएल उपलब्ध कराता है. सेलर की Key/Value सेवा से, क्रिएटिव के रेंडर यूआरएल के बारे में क्वेरी की जाएगी.

शुरुआती टेस्टिंग के लिए, "Bring Your Own Server" मॉडल का इस्तेमाल किया जाता है. लंबे समय तक, विज्ञापन टेक्नोलॉजी से जुड़ी कंपनियों को रीयल-टाइम डेटा पाने के लिए, ओपन-सोर्स Protected Audience API Key/Value सेवाओं का इस्तेमाल करना होगा. ये सेवाएं, भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट में काम करती हैं.

हमारा मानना है कि तीसरे पक्ष की कुकी के इस्तेमाल पर रोक लगने के बाद, कुछ समय तक ओपन-सोर्स Key/Value सेवाओं या भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट का इस्तेमाल करने की ज़रूरत नहीं होगी. इससे यह पक्का किया जा सकेगा कि इकोसिस्टम के पास टेस्टिंग के लिए काफ़ी समय है. हम डेवलपर को इस ट्रांज़िशन के बारे में पहले से सूचना देंगे, ताकि वे टेस्टिंग शुरू कर सकें और इसे अपना सकें.

Protected Audience ऑक्शन में, पहले पक्ष (ग्राहक) के डेटा का इस्तेमाल कैसे किया जाता है?

पहले पक्ष (ग्राहक) का डेटा, साइट के उन उपयोगकर्ताओं का डेटा होता है जिन पर साइट का मालिकाना हक होता है. उदाहरण के लिए, अगर किसी उपयोगकर्ता ने विज्ञापन देने वाले व्यक्ति या कंपनी या पब्लिशर की साइट पर अपना पसंदीदा रंग बताया है, तो उस रंग को पहले पक्ष (ग्राहक) का डेटा माना जाता है.

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

उदाहरण के लिए, अगर विज्ञापन देने वाले व्यक्ति या कंपनी को उपयोगकर्ता के पसंदीदा रंग के बारे में पता है, तो उपयोगकर्ता को किसी इंटरेस्ट ग्रुप में शामिल करते समय, इंटरेस्ट ग्रुप के कॉन्फ़िगरेशन में वैल्यू को userBiddingSignals के तौर पर सेट किया जा सकता है:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

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

इस उदाहरण में बताया गया है कि पब्लिशर, पहले पक्ष से मिले डेटा को नीलामी में हिस्सा लेने वाले अलग-अलग लोगों या कंपनियों को कैसे पास कर सकता है:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

ज़्यादा जानें

Protected Audience API के बारे में ज़्यादा जानकारी पाने के लिए, Protected Audience API डेवलपर गाइड पढ़ें.

डेवलपर

अगर आपको Protected Audience API का इस्तेमाल शुरू करना है, तो एक्सपेरिमेंट करना और हिस्सा लेना लेख पढ़ें.

हमने एपीआई डेवलपर गाइड लिखी है. साथ ही, Protected Audience API का डेमो बनाया है. इसमें, Protected Audience API को बुनियादी तौर पर डिप्लॉय करने के बारे में बताया गया है. Protected Audience API के डेमो वीडियो में बताया गया है कि डेमो कोड कैसे काम करता है. साथ ही, इसमें Protected Audience API को डीबग करने के लिए, Chrome DevTools का इस्तेमाल करने का तरीका दिखाया गया है.

सुझाव/राय देना या शिकायत करना

• GitHub: एक्सप्लेनर पढ़ें, सवाल पूछें और चर्चा को फ़ॉलो करें.
• सूचनाएं: Protected Audience API की ईमेल पाने वाली सूची में शामिल हों या पिछली सूचनाएं देखें.
• W3C: वेब विज्ञापन के कारोबार को बेहतर बनाने वाले ग्रुप में, इंडस्ट्री के इस्तेमाल के उदाहरणों पर चर्चा करें.
• मौजूदा तरीका: Chrome में Protected Audience को लागू करने से जुड़े सवालों के लिए: Chromium में बग की शिकायत करें.