निजता बनाए रखते हुए, पढ़ने का ऐक्सेस देने के साथ-साथ क्रॉस-साइट स्टोरेज में लिखने का अनलिमिटेड ऐक्सेस दें.
लागू किए जाने की स्थिति
इस दस्तावेज़ में, क्रॉस-साइट स्टोरेज के लिए एक प्रस्ताव दिया गया है, जिसे बांटा नहीं गया है: Shared Storage API.
- शेयर किया गया स्टोरेज एपीआई अब सामान्य उपलब्धता पर उपलब्ध है.
- टेस्ट की तरह, लाइव डेमो उपलब्ध है:
- यूआरएल चुनने का आउटपुट गेट, Chrome M105+ के लोकल टेस्टिंग के लिए उपलब्ध है.
- निजी एग्रीगेशन आउटपुट गेट, Chrome M107+ की स्थानीय जांच के लिए उपलब्ध है.
- Private एग्रीगेशन एपीआई से मेज़रमेंट करने की सुविधा, अब सामान्य रूप से उपलब्ध है.
- Chrome प्लैटफ़ॉर्म का स्टेटस
| प्रस्ताव | स्थिति |
|---|---|
कॉन्टेंट चुनने के लिए इवेंट-लेवल की रिपोर्टिंग (selectURL()) |
कम से कम 2026 तक उपलब्ध है |
| हर साइट के लिए बजट तय करना पूरी जानकारी |
M119 में उपलब्ध है |
| रिस्पॉन्स हेडर से लिखने की अनुमति दें एक्सप्लेनर GitHub से जुड़ी समस्या |
M124 में उपलब्ध है. इसे M119-M123 पर मैन्युअल तरीके से चालू किया जा सकता है |
| निजी एग्रीगेशन योगदान का टाइम आउट पूरी जानकारी |
M119 में उपलब्ध है |
| DevTools की मदद से, शेयर किए गए स्टोरेज के वर्कलेट को डीबग करना सेक्शन |
M120 में उपलब्ध है |
| शेयर किए गए स्टोरेज के डेटा के लिए स्टोरेज की सीमा 5 एमबी तक अपडेट करें पूरी जानकारी |
M124 वर्शन में उपलब्ध है |
हमें इस एपीआई की ज़रूरत क्यों है?
क्रॉस-साइट उपयोगकर्ता ट्रैकिंग को रोकने के लिए, ब्राउज़र हर तरह के स्टोरेज (कुकी, localStorage, कैश वगैरह) को पार्टिशन कर रहे हैं. हालांकि, इस्तेमाल के ऐसे कई सही उदाहरण हैं जो स्टोरेज के लिए अलग-अलग वर्शन पर निर्भर हैं. नए वेब एपीआई की मदद के बिना, इनका इस्तेमाल करना नामुमकिन होता है. उदाहरण के लिए, हो सकता है कि कॉन्टेंट बनाने वाला व्यक्ति, क्रॉस-साइट आइडेंटिफ़ायर के बिना, अलग-अलग साइटों पर रीच को मेज़र करना चाहे.
Shared Storage API, साइटों को अलग-अलग क्रॉस-साइट डेटा को सेव और ऐक्सेस करने की अनुमति देता है. इस डेटा को सुरक्षित एनवायरमेंट में पढ़ा जाना चाहिए, ताकि लीकेज से बचा जा सके.
शेयर किए गए स्टोरेज में मौजूद डेटा का इस्तेमाल दो तरीकों से किया जा सकता है:
- क्रॉस-साइट कॉन्टेंट चुनना.
- प्राइवेट एग्रीगेशन एपीआई की मदद से क्रॉस-साइट डेटा को बिना किसी आवाज़ के एग्रीगेशन
यह किसके लिए है?
शेयर किए गए स्टोरेज एपीआई का इस्तेमाल करने से कई तरह की कंपनियों को फ़ायदा हो सकता है. उदाहरण के लिए:
- विज्ञापन टेक्नोलॉजी से कैंपेन की पहुंच का आकलन किया जा सकता है, फ़्रीक्वेंसी कैप सेट की जा सकती हैं, और क्रिएटिव को बदला जा सकता है. फ़िलहाल, ये सभी टेक्नोलॉजी तीसरे पक्ष की कुकी पर निर्भर हैं.
- पेमेंट की सेवा देने वाली कंपनियां यह तय कर सकती हैं कि उपयोगकर्ता मौजूदा ग्राहक है या नहीं और चेकआउट अनुभव को बेहतर बना सकती हैं.
- वेब सुरक्षा कंपनियां संदिग्ध या खतरनाक गतिविधियों को फ़्लैग करने के लिए, पसंद के मुताबिक लॉजिक बना सकती हैं.
क्या आपकी कंपनी क्रॉस-साइट स्टोरेज के ऐसे समाधान ढूंढ रही है जिन पर अब तक ध्यान नहीं दिया गया है? अपने इस्तेमाल का उदाहरण शेयर करें.
इस्तेमाल के उदाहरण
Shared Storage API का मकसद है, इस्तेमाल के कई उदाहरणों में मदद पाना. यह तीसरे पक्ष की कुकी के मौजूदा इस्तेमाल की जगह ले रहा है. ऐसे कॉन्टेंट के कुछ उदाहरण यहां दिए गए हैं:
| इस्तेमाल का उदाहरण | ब्यौरा | आउटपुट गेट |
|---|---|---|
| विज्ञापन क्रिएटिव घुमाएं | क्रिएटिव आईडी, व्यू की संख्या, और उपयोगकर्ता इंटरैक्शन जैसा डेटा स्टोर करके, यह तय किया जा सकता है कि अलग-अलग साइटों पर कौनसे क्रिएटिव उपयोगकर्ताओं को दिखे. इससे आपको कॉन्टेंट के व्यू के बीच संतुलन बनाने और किसी कॉन्टेंट के ज़रूरत से ज़्यादा इस्तेमाल होने से बचाने में मदद मिलती है. साथ ही, दर्शकों को खराब अनुभव देने से बचा जा सकता है. | यूआरएल चुनना |
| A/B टेस्टिंग करना | किसी उपयोगकर्ता को एक्सपेरिमेंट ग्रुप में शामिल किया जा सकता है. इसके बाद, उस ग्रुप को शेयर किए गए स्टोरेज में सेव किया जा सकता है, ताकि उसे क्रॉस-साइट ऐक्सेस किया जा सके. | यूआरएल चुनना |
| जाने-पहचाने ग्राहकों के लिए उपयोगकर्ता अनुभव को पसंद के मुताबिक बनाना | उपयोगकर्ता के रजिस्ट्रेशन के स्टेटस या उपयोगकर्ता की अन्य स्थितियों के आधार पर, कस्टम कॉन्टेंट और कॉल-टू-ऐक्शन शेयर किया जा सकता है. | यूआरएल चुनना |
| गलत इस्तेमाल को रोकने के लिए बनी नीतियां | गलत इस्तेमाल का विरोध करने, धोखाधड़ी रोकने, और वेब सुरक्षा से जुड़े संगठन, नुकसान पहुंचाने वाले उपयोगकर्ताओं का पता लगाने के लिए अक्सर अपने मालिकाना हक वाली तकनीकों का इस्तेमाल करते हैं. इनमें, अपने-आप काम करने वाले बॉट या नुकसान पहुंचाने वाले असली इंसान शामिल हैं. यहां कई अलग-अलग रणनीतियों को टेस्ट किया जा सकता है. जैसे, उपयोगकर्ता की भरोसेमंद रेटिंग को कोड में बदलने के लिए, यूआरएल चुनने के आउटपुट गेट का इस्तेमाल करना या गड़बड़ी का पता लगाने के लिए डेटासेट बनाने के लिए, प्राइवेट एग्रीगेशन आउटपुट गेट का इस्तेमाल करना. | यूआरएल चुनना, निजी एग्रीगेशन एपीआई |
| यूनीक रीच मेज़र करना | कॉन्टेंट बनाने वाले और विज्ञापन देने वाले कई लोग अक्सर यह जानना चाहते हैं कि उनका कॉन्टेंट कितने यूनीक लोगों ने देखा. शेयर किए गए स्टोरेज का इस्तेमाल, किसी उपयोगकर्ता के पहली बार आपका विज्ञापन, एम्बेड किए गए वीडियो, और पब्लिकेशन को देखने पर रिपोर्ट करने के लिए किया जा सकता है. साथ ही, किसी दूसरी साइट पर उसी उपयोगकर्ता की डुप्लीकेट गिनती को रोकने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल किया जा सकता है. इससे आपको यूनीक रीच के बारे में इकट्ठा की गई एक रिपोर्ट मिलती है. | Private Aggregation API |
| उपयोगकर्ता की डेमोग्राफ़िक्स का आकलन करना | कॉन्टेंट प्रोड्यूसर अक्सर अपने दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) के बारे में जानना चाहते हैं. आपके पास जिस कॉन्टेक्स्ट में डेमोग्राफ़िक डेटा को रिकॉर्ड करने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल किया जा सकता है उसका इस्तेमाल किया जा सकता है, जैसे कि पहले पक्ष की आपकी साइट. साथ ही, एग्रीगेट की गई रिपोर्टिंग का इस्तेमाल करके, एम्बेड की गई कॉन्टेंट जैसी कई अन्य साइटों पर रिपोर्ट की जा सकती है. | Private Aggregation API |
| K+ फ़्रीक्वेंसी रीच को मेज़र करना | कभी-कभी इसे "असरदार फ़्रीक्वेंसी" के तौर पर बताया जाता है. किसी कॉन्टेंट को पहचानने या उसे याद रखने से पहले, आम तौर पर विज्ञापन पर मिले व्यू की संख्या, आम तौर पर कम से कम होती है. शेयर किए गए स्टोरेज का इस्तेमाल करके, उन यूनीक उपयोगकर्ताओं की रिपोर्ट बनाई जा सकती हैं जिन्होंने किसी कॉन्टेंट को कम से कम K बार देखा है. | Private Aggregation API |
इस प्रस्ताव का मकसद ऐसे सामान्य मकसद वाले एपीआई बनाना है जो आने वाले समय में ज़रूरत के मुताबिक इस्तेमाल किए जाने वाले कई उदाहरणों का समर्थन करे. इससे वेब नेटवर्क के साथ-साथ आगे प्रयोग करने और बदलाव करने की अनुमति मिलती है.
शेयर किए गए स्टोरेज की सुविधा कैसे काम करती है?
शेयर किए गए स्टोरेज की मदद से, एम्बेड की गई साइट के साथ उपयोगकर्ता की जानकारी (जैसे कि ब्राउज़र इतिहास या अन्य निजी जानकारी) शेयर किए बिना या आपके सर्वर पर डेटा बाहर निकाले बिना, क्रॉस-साइट डेटा के आधार पर सोच-समझकर फ़ैसले लिए जा सकते हैं.
आपके पास किसी भी समय, शेयर किए गए स्टोरेज में डेटा सेव करने का विकल्प होता है. जैसे, localStorage या indexDB जैसे अन्य JavaScript स्टोरेज एपीआई. अन्य स्टोरेज एपीआई के उलट, शेयर किए गए स्टोरेज की वैल्यू को सुरक्षित एनवायरमेंट में ही पढ़ा जा सकता है. इसे 'शेयर किए गए स्टोरेज वर्कलेट' कहा जाता है.
वर्कलेट वह जगह है जहां कारोबार के लॉजिक को जोड़ा जाता है. वर्कलेट में, आपको शेयर किए गए स्टोरेज से वैल्यू को पढ़ने और प्रोसेस करने की अनुमति होती है, लेकिन वर्कलेट कॉलर को सीधे सटीक वैल्यू नहीं दी जा सकती. वर्कलेट से काम की जानकारी निकालने के लिए, "गेट" का एक सेट मौजूद है. यहां दो गेट उपलब्ध हैं, लेकिन आने वाले समय में और भी गेट जोड़े जा सकते हैं.
उपलब्ध Shared Storage API के आउटपुट गेट:
- क्रॉस-साइट यूआरएल चुनना: सेव किए गए डेटा के आधार पर, दी गई सूची में से कोई यूआरएल चुनने के लिए, वर्कलेट स्क्रिप्ट चलाई जा सकती है. इसके बाद, उस कॉन्टेंट को फ़ेंस किए गए फ़्रेम में रेंडर किया जा सकता है.
- प्राइवेट एग्रीगेशन एपीआई की मदद से नॉइज़ एग्रीगेशन: Private एग्रीगेशन एपीआई की मदद से क्रॉस-साइट डेटा भेजने और खास जानकारी वाली रिपोर्ट देने के लिए, वर्कलेट चलाया जा सकता है.
Shared Storage API आज़माएं
यूआरएल चुनने के आउटपुट गेट और निजी एग्रीगेशन आउटपुट गेट के लिए Shared Storage API, जांच के लिए उपलब्ध हैं. चुने गए कॉन्टेंट की जांच Chrome में की जा सकती है
Canary/Dev/Beta M105+ और Private एग्रीगेशन एपीआई
की जांच Chrome के M107+ Canary और Dev में की जा सकती है. chrome://flags/#privacy-sandbox-ads-apis पर Privacy Sandbox Ads API प्रयोग फ़्लैग को चालू करके, एपीआई की जांच की जा सकती है.
डेमो का इस्तेमाल करें
डेमो उपलब्ध है और GitHub पर कोड की समीक्षा की जा सकती है.
यह डेमो किसी विज्ञापन देने वाले, विज्ञापन टेक्नोलॉजी, कॉन्टेंट डिस्ट्रिब्यूटर या तीसरे पक्ष की ऐसी सेवा को ध्यान में रखकर बनाया गया है जो अलग-अलग पब्लिशर की साइटों पर जानकारी स्टोर करना चाहती है. डेमो में, इस्तेमाल के हर उदाहरण के लिए, तीसरे पक्ष का कोड पब्लिशर A और पब्लिशर B, दोनों साइटों पर चलेगा. पब्लिशर के पेजों पर जाकर देखें कि क्रॉस-साइट में डेटा को कैसे शेयर किया जाता है.
डेमो में कॉन्टेंट चुनने और निजी एग्रीगेशन के लिए इस्तेमाल के उदाहरण शामिल हैं.
कॉन्टेंट चुनने के डेमो के लिए, विज्ञापन क्रिएटिव घुमाएं, जाने-पहचाने ग्राहकों के लिए इस्तेमाल के अनुभव को पसंद के मुताबिक बनाएं, और A/B टेस्टिंग चलाएं के इस्तेमाल के उदाहरण उपलब्ध हैं.
निजी एग्रीगेशन डेमो के लिए, यूनीक यूनीक रीच मेज़र करें, K+ फ़्रीक्वेंसी रीच मेज़र करें की झलक देखें. उपयोगकर्ता की डेमोग्राफ़िक्स का आकलन करना और
DevTools की मदद से, शेयर किए गए स्टोरेज के वर्कलेट को डीबग करना
आप जिस पेज पर हैं उससे शेयर किए गए स्टोरेज के वर्कलेट की जांच करने के लिए, DevTools पैनल में "सोर्स" टैब पर जाएं. इसके बाद, "शेयर किए गए स्टोरेज के लिए वर्कलेट / स्क्रिप्ट का पहला स्टेटमेंट" इवेंट लिसनर ब्रेकपॉइंट जोड़ें. यह ब्रेकपॉइंट, स्टार्टअप पर शुरुआती मॉड्यूल स्क्रिप्ट या कुछ समय तक काम करने वाले वर्कलेट को रोक देगा.
इसके अलावा, chrome://inspect/#shared-storage-worklets पेज पर, सभी पेजों से शेयर किए गए स्टोरेज के सभी चालू वर्कलेट दिखते हैं.
लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें
शेयर किए गए स्टोरेज के प्रपोज़ल पर अभी चर्चा चल रही है. आने वाले समय में, इसमें बदलाव हो सकता है. अगर आप इस एपीआई को आज़माते हैं और आपके पास कोई सुझाव, राय या शिकायत है, तो हमें खुशी होगी.
- GitHub: प्रस्ताव पढ़ें, सवाल उठाएं, और चर्चा में हिस्सा लें.
- Shared Storage API से जुड़ी सूचनाएं: हमारी मेलिंग सूची में शामिल हों या पिछली सूचनाएं देखें
- डेवलपर सहायता: प्राइवसी सैंडबॉक्स डेवलपर सहायता रेपो पर सवाल पूछें और होने वाली चर्चाओं में शामिल हों.