निजता बनाए रखने वाले रीड ऐक्सेस के साथ, हर साइट के लिए अनलिमिटेड स्टोरेज और लिखने का ऐक्सेस दें.
लागू करने की स्थिति
इस दस्तावेज़ में, अलग-अलग साइट पर स्टोरेज के इस्तेमाल से जुड़े प्रस्ताव के बारे में बताया गया है: 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 की मदद से, साइटें बिना किसी बंटवारे के डेटा को सेव और ऐक्सेस कर सकती हैं क्रॉस-साइट डेटा की ज़रूरत होती है. इस डेटा को सुरक्षित जगह पर पढ़ना ज़रूरी है, ताकि लीक.
शेयर किए गए स्टोरेज के डेटा का इस्तेमाल दो तरीकों से किया जा सकता है:
- क्रॉस-साइट कॉन्टेंट चुनना.
- private एग्रीगेशन API के साथ क्रॉस-साइट डेटा की ग़ैर-ज़रूरी एग्रीगेशन
यह किसके लिए है?
ऐसी कई तरह की कंपनियां हैं जिन्हें इस प्लैटफ़ॉर्म का इस्तेमाल करने से फ़ायदा हो सकता है 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 से मान पढ़ने और प्रोसेस करने की अनुमति है, लेकिन आप वर्कलेट कॉलर को सीधे तौर पर सटीक वैल्यू दिखाता है. काम की जानकारी एक्सट्रैक्ट करने के लिए वर्कलेट से मिली जानकारी, जो "गेट" का एक सेट है उपलब्ध हैं. दो गेट उपलब्ध हैं, लेकिन आने वाले समय में और भी रास्ते जोड़े जा सकते हैं.
Shared Storage API के उपलब्ध आउटपुट गेट:
- क्रॉस-साइट यूआरएल चुनना: वर्कलेट स्क्रिप्ट चलाकर, सेव किए गए डेटा के आधार पर दी गई सूची से यूआरएल चुना जा सकता है. इसके बाद, उस कॉन्टेंट को फ़ेंस किए गए फ़्रेम में रेंडर किया जा सकता है.
- प्राइवेट एग्रीगेशन एपीआई की मदद से शोर की वजह से एग्रीगेशन: Private एग्रीगेशन एपीआई के ज़रिए, क्रॉस-साइट डेटा भेजने के लिए एक वर्कलेट चलाया जा सकता है. साथ ही, खास जानकारी वाली रिपोर्ट दी जा सकती है.
Shared Storage API आज़माएं
यूआरएल चुनने के आउटपुट गेट और प्राइवेट एग्रीगेशन आउटपुट के लिए, Shared Storage API
गेट टेस्टिंग के लिए उपलब्ध हैं. चुने गए कॉन्टेंट की जांच Chrome पर की जा सकती है
कैनरी/डेव/बीटा M105+ और Private एग्रीगेशन API को इन देशों में टेस्ट किया जा सकता है
Chrome M107+ कैनरी और डेवलपर. chrome://settings/adPrivacy
में विज्ञापन देखने वाले की निजता बनाए रखने वाले सभी एपीआई को चालू करके, एपीआई की जांच की जा सकती है.
डेमो का इस्तेमाल करें
डेमो उपलब्ध है और GitHub पर कोड की समीक्षा की जा सकती है.
इस डेमो को विज्ञापन देने वाली कंपनी, विज्ञापन टेक्नोलॉजी, कॉन्टेंट डिस्ट्रिब्यूटर या तीसरे पक्ष की कोई ऐसी सेवा जो स्टोर करना चाहती है अलग-अलग पब्लिशर से मिली जानकारी को साइटें. डेमो में, उसी तीसरे पार्टी का कोड पब्लिशर A और पब्लिशर B, दोनों साइटों पर इस्तेमाल के उदाहरण. पब्लिशर के पेजों पर जाकर देखें कि जानकारी मिलती है.
इस डेमो में, कॉन्टेंट चुनने और निजी एग्रीगेशन के लिए इस्तेमाल के उदाहरण दिए गए हैं.
कॉन्टेंट चुनने के डेमो के लिए, विज्ञापन के क्रिएटिव को घुमाएं, पहले से रजिस्टर ग्राहकों के लिए, इस्तेमाल करने के अनुभव को पसंद के मुताबिक बनाना और रन A/B टेस्टिंग के इस्तेमाल के उदाहरण उपलब्ध हैं.
निजी एग्रीगेशन डेमो के लिए, यूनीक एग्रीगेशन की झलक देखी जा सकती है यूनीक रीच का आकलन करें, K+ फ़्रीक्वेंसी रीच का आकलन करें और उपयोगकर्ता की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) का आकलन करें.
DevTools की मदद से, शेयर किए गए स्टोरेज के वर्कलेट डीबग करना
आप जिस पेज पर हैं उससे शुरू किए गए शेयर किए गए स्टोरेज के वर्कलेट की जांच करने के लिए, "सोर्स" पर जाएं DevTools पैनल में टैब दबाएं और "शेयर किए गए स्टोरेज के लिए वर्कलेट / स्क्रिप्ट का पहला स्टेटमेंट" जोड़ें इवेंट लिसनर ब्रेकपॉइंट. यह ब्रेकपॉइंट, स्टार्टअप पर शुरुआती मॉड्यूल स्क्रिप्ट के एक्ज़ीक्यूशन या कम समय तक चलने वाले वर्कलेट को रोक देगा.
![इवेंट-लेवल लिसनर जोड़कर, Shared Storage के वर्कलेट को डीबग करना.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/shared-storage-devtools-debugging.png?authuser=8&hl=hi)
इसके अलावा, chrome://inspect/#shared-storage-worklets
पेज पर सभी पेजों के ऐक्टिव 'शेयर किए गए स्टोरेज' के वर्कलेट भी दिखते हैं.
दिलचस्पी बढ़ाएं और सुझाव दें
शेयर किए गए स्टोरेज के प्रस्ताव पर चर्चा जारी है और इसमें बदलाव हो सकता है आने वाले समय में. अगर आपने इस एपीआई को आज़माया है और आपके पास कोई सुझाव है, तो हमें ज़रूर बताएं.
- GitHub: पढ़ें प्रपोज़ल, व्हाइट पेपर पर जाएं, सवाल पूछें, और चर्चा में हिस्सा लें.
- Shared Storage API के बारे में सूचनाएं: हमारी ईमेल पाने वाले लोगों की सूची से जुड़ी सूचनाएं देखें या उनमें शामिल हों
- डेवलपर सहायता: इस ऐप्लिकेशन पर सवाल पूछें और चर्चाओं में शामिल हों Privacy Sandbox के लिए डेवलपर सहायता का डेटा स्टोर करने की जगह.