शेयर किए गए स्टोरेज की खास जानकारी

निजता बनाए रखते हुए, पढ़ने का ऐक्सेस देने के साथ-साथ क्रॉस-साइट स्टोरेज में लिखने का अनलिमिटेड ऐक्सेस दें.

लागू किए जाने की स्थिति

इस दस्तावेज़ में, क्रॉस-साइट स्टोरेज के लिए एक प्रस्ताव दिया गया है, जिसे बांटा नहीं गया है: Shared Storage API.

  • Shared Storage API 现已正式发布。
  • 提供现场演示，测试也是如此：
    • 网址选择输出门控可在 Chrome M105 及更高版本中用于本地测试。
    • 从 Chrome M107 及更高版本中，私有汇总输出关口可用于本地测试。
    • 使用 Private Aggregation API 进行衡量的功能现已正式发布。
  • Chrome 平台状态
Proposal Status
Event-level reporting for Content Selection (selectURL()) Available until at least 2026
Per-site budgeting
Explainer		 Available in M119
Allow writing from response headers
Explainer
GitHub Issue		 Available in M124. Can be manually enabled in M119-M123
Private Aggregation contribution timeout
Explainer		 Available in M119
Debugging Shared Storage worklets with DevTools
Section		 Available in M120
Update Shared Storage data storage limit to 5MB
Explainer		 Available in 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 के आउटपुट गेट:

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 प्रयोग फ़्लैग को चालू करके, एपीआई की जांच की जा सकती है.

इन एपीआई का इस्तेमाल करने के लिए, Privacy Sandbox Ads API का एक्सपेरिमेंट 'चालू है' पर सेट करें.

डेमो का इस्तेमाल करें

डेमो उपलब्ध है और GitHub पर कोड की समीक्षा की जा सकती है.

यह डेमो किसी विज्ञापन देने वाले, विज्ञापन टेक्नोलॉजी, कॉन्टेंट डिस्ट्रिब्यूटर या तीसरे पक्ष की ऐसी सेवा को ध्यान में रखकर बनाया गया है जो अलग-अलग पब्लिशर की साइटों पर जानकारी स्टोर करना चाहती है. डेमो में, इस्तेमाल के हर उदाहरण के लिए, तीसरे पक्ष का कोड पब्लिशर A और पब्लिशर B, दोनों साइटों पर चलेगा. पब्लिशर के पेजों पर जाकर देखें कि क्रॉस-साइट में डेटा को कैसे शेयर किया जाता है.

डेमो में कॉन्टेंट चुनने और निजी एग्रीगेशन के लिए इस्तेमाल के उदाहरण शामिल हैं.

कॉन्टेंट चुनने के डेमो के लिए, विज्ञापन क्रिएटिव घुमाएं, जाने-पहचाने ग्राहकों के लिए इस्तेमाल के अनुभव को पसंद के मुताबिक बनाएं, और A/B टेस्टिंग चलाएं के इस्तेमाल के उदाहरण उपलब्ध हैं.

निजी एग्रीगेशन डेमो के लिए, यूनीक यूनीक रीच मेज़र करें, K+ फ़्रीक्वेंसी रीच मेज़र करें की झलक देखें. उपयोगकर्ता की डेमोग्राफ़िक्स का आकलन करना और

DevTools की मदद से, शेयर किए गए स्टोरेज के वर्कलेट को डीबग करना

आप जिस पेज पर हैं उससे शेयर किए गए स्टोरेज के वर्कलेट की जांच करने के लिए, DevTools पैनल में "सोर्स" टैब पर जाएं. इसके बाद, "शेयर किए गए स्टोरेज के लिए वर्कलेट / स्क्रिप्ट का पहला स्टेटमेंट" इवेंट लिसनर ब्रेकपॉइंट जोड़ें. यह ब्रेकपॉइंट, स्टार्टअप पर शुरुआती मॉड्यूल स्क्रिप्ट या कुछ समय तक काम करने वाले वर्कलेट को रोक देगा.

इवेंट-लेवल लिसनर जोड़कर, शेयर किए गए स्टोरेज वाले वर्कलेट को डीबग करना.
शेयर किए गए स्टोरेज के वर्कलेट में ब्रेकपॉइंट जोड़ा जा सकता है.

इसके अलावा, chrome://inspect/#shared-storage-worklets पेज पर, सभी पेजों से शेयर किए गए स्टोरेज के सभी चालू वर्कलेट दिखते हैं.

लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें

शेयर किए गए स्टोरेज के प्रपोज़ल पर अभी चर्चा चल रही है. आने वाले समय में, इसमें बदलाव हो सकता है. अगर आप इस एपीआई को आज़माते हैं और आपके पास कोई सुझाव, राय या शिकायत है, तो हमें खुशी होगी.