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

निजता बनाए रखने वाले रीड ऐक्सेस के साथ, हर साइट के लिए अनलिमिटेड स्टोरेज और लिखने का ऐक्सेस दें.

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

इस दस्तावेज़ में, अलग-अलग साइट पर स्टोरेज के इस्तेमाल से जुड़े प्रस्ताव के बारे में बताया गया है: Shared Storage API.

प्रस्ताव स्थिति
कॉन्टेंट चुनने के लिए इवेंट-लेवल की रिपोर्टिंग (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

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

शेयर किया गया स्टोरेज कैसे काम करता है?

Shared Storage से आप क्रॉस-साइट डेटा के आधार पर, एम्बेड करने वाली साइट के साथ उपयोगकर्ता की जानकारी (जैसे कि ब्राउज़र इतिहास या अन्य निजी जानकारी) शेयर किए बिना या अपने सर्वर से डेटा बाहर निकाले बिना, सही फ़ैसले ले सकते हैं.

शेयर किए गए स्टोरेज में किसी भी समय लिखा जा सकता है, जैसे कि localStorage याindexDB जैसे अन्य JavaScript स्टोरेज एपीआई. अन्य स्टोरेज एपीआई के उलट, शेयर किए गए स्टोरेज की वैल्यू को सिर्फ़ सुरक्षित एनवायरमेंट में पढ़ा जा सकता है. इसे शेयर किए गए स्टोरेज वर्कलेट के तौर पर जाना जाता है.

वर्कलेट वह जगह है जहां कारोबार के नियम जोड़े जाते हैं. वर्कलेट के अंदर, आपको शेयर किए गए स्टोरेज से वैल्यू को पढ़ने और प्रोसेस करने की अनुमति है, लेकिन वर्कलेट कॉलर को सीधे तौर पर सटीक वैल्यू नहीं दिखाई जा सकती. वर्कलेट से काम की जानकारी निकालने के लिए, "गेट" का एक सेट उपलब्ध है. यहां दो गेट उपलब्ध हैं, लेकिन आने वाले समय में और भी कई गेट जोड़े जा सकते हैं.

Shared Storage API के उपलब्ध आउटपुट गेट:

  • क्रॉस-साइट यूआरएल चुनना: वर्कलेट स्क्रिप्ट चलाकर, सेव किए गए डेटा के आधार पर दी गई सूची से यूआरएल को चुना जा सकता है. इसके बाद, उस कॉन्टेंट को फ़ेंस किए गए फ़्रेम में रेंडर किया जा सकता है.
  • प्राइवेट एग्रीगेशन एपीआई की मदद से ग़ैर-ज़रूरी डेटा इकट्ठा करना: Private एग्रीगेशन एपीआई के ज़रिए, क्रॉस-साइट डेटा भेजने के लिए एक वर्कलेट चलाया जा सकता है. साथ ही, खास जानकारी वाली रिपोर्ट भी दी जा सकती है.

Shared Storage API आज़माएं

यूआरएल चुनने के आउटपुट गेट और निजी एग्रीगेशन आउटपुट गेट के लिए, Shared Storage API की जांच की जा सकती है. कॉन्टेंट के चुने जाने की जांच Chrome में की जा सकती है Canary/Dev/Beta M105+ और Private एग्रीगेशन API को Chrome M107+ कैनरी और Dev में टेस्ट किया जा सकता है. chrome://settings/adPrivacy में सभी Ad Privacy API चालू करके एपीआई की जांच की जा सकती है.

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

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

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

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

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

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

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

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

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

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

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

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