जाने-पहचाने ग्राहकों की पहचान करने के लिए, Shared Storage के वर्कलेट का इस्तेमाल करें.
Shared Storage API को निजता के तौर पर इस्तेमाल किया जाता है सामान्य उद्देश्य के लिए सैंडबॉक्स प्रस्ताव, क्रॉस-साइट स्टोरेज, जो कई इस्तेमाल के कुछ उदाहरण हो सकते हैं. इसका एक उदाहरण है, जाने-पहचाने ग्राहकों की पहचान करना, जो Chrome 104.0.5086.0 और उसके बाद के वर्शन में टेस्ट करने के लिए उपलब्ध है.
यह स्टोर किया जा सकता है कि उपयोगकर्ता ने आपकी साइट के लिए, Shared Storage में रजिस्टर किया है या नहीं, फिर इस बात के आधार पर एक अलग एलीमेंट रेंडर करें कि उपयोगकर्ता की संग्रहित स्थिति ( कोई उपयोगकर्ता "जाना-पहचाना है" ग्राहक).
जाने-पहचाने ग्राहक सेट करें
शेयर किए गए स्टोरेज में, जाने-पहचाने ग्राहकों की पहचान करने के लिए एक्सपेरिमेंट करने के लिए, पुष्टि करें कि Chrome 104.0.5086.0 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है. chrome://settings/adPrivacy
में शामिल, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
कमांड लाइन में मौजूद --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
फ़्लैग के साथ, शेयर किए गए स्टोरेज की सुविधा भी चालू की जा सकती है.
कोड सैंपल के साथ प्रयोग करें
उपयोगकर्ता को किसी दूसरी साइट पर देखा गया था या नहीं, इसके आधार पर शायद आप कोई अलग एलिमेंट रेंडर करना चाहें. उदाहरण के लिए, पेमेंट की सेवा देने वाली कंपनी को "रजिस्टर करें" या "अभी खरीदें" बटन पर क्लिक किया जा सकता है. यह बटन, पेमेंट की सेवा देने वाली कंपनी की साइट पर उपयोगकर्ता के रजिस्टर है या नहीं. शेयर किए गए स्टोरेज का इस्तेमाल, उपयोगकर्ता के स्टेटस को सेट करने और उसके हिसाब से उपयोगकर्ता अनुभव को पसंद के मुताबिक बनाने के लिए किया जा सकता है.
इस उदाहरण में:
known-customer.js
को किसी फ़्रेम में एम्बेड किया गया है. यह स्क्रिप्ट वे विकल्प सेट करती है जिनके लिए साइट पर बटन "रजिस्टर करें" को दिखाना ज़रूरी है या "अभी खरीदें."known-customer-worklet.js
, शेयर किए गए स्टोरेज का वर्कलेट है, जो तय करता है कि उपयोगकर्ता आपकी पहचान का है या नहीं. अगर उपयोगकर्ता की जानकारी पहले से होती है, तो उसे जानकारी दी जाती है. अगर उपयोगकर्ता की जानकारी नहीं है, तो उसे "रजिस्टर करें" दिखाने के लिए वापस कर दिया जाता है बटन पर क्लिक करता है और उपयोगकर्ता को 'आने वाले समय के लिए जाना जाता है' के तौर पर मार्क किया जाता है.
// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
{ url: `https://${advertiserUrl}/ads/register-button.html` },
{ url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];
async function injectButton() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('known-customer-worklet.js');
// Set the initial status to unknown ('0' is unknown and '1' is known)
window.sharedStorage.set('known-customer', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose the button based on the user status
const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('button-slot').src = fencedFrameConfig;
}
injectButton();
class SelectURLOperation {
async run(urls) {
const knownCustomer = await sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
उपयोग के उदाहरण
ये, शेयर किए गए स्टोरेज के इस्तेमाल के कुछ संभावित उदाहरण हैं. हम में आप लगातार उदाहरण जोड़ रहे हैं, सुझाव या राय दो और इसके इस्तेमाल के नए उदाहरणों के बारे में जान सकते हैं.
कॉन्टेंट चुनें
इसमें अलग-अलग वेबसाइटों पर अलग-अलग कॉन्टेंट चुनना और दिखाना जानकारी के आधार पर, फ़ेंस किए गए फ़्रेम शेयर किए गए स्टोरेज में इकट्ठा किए गए आइटम. इस्तेमाल के इन उदाहरणों के लिए, आउटपुट गेट यूआरएल को चुनना है.
- क्रिएटिव रोटेशन: क्रिएटिव आईडी, व्यू की संख्या, और उपयोगकर्ता इंटरैक्शन जैसे डेटा को स्टोर करें, ताकि यह तय किया जा सके कि किस क्रिएटिव उपयोगकर्ता की अलग-अलग साइटों पर दिखते हैं.
- A/B टेस्टिंग: किसी उपयोगकर्ता को, किसी टेस्ट ग्रुप में असाइन करके, उस ग्रुप को Shared Storage में स्टोर किया जा सकता है, ताकि उसे क्रॉस-साइट ऐक्सेस किया जा सके.
- पसंद के मुताबिक उपयोगकर्ता अनुभव: उपयोगकर्ता के रजिस्ट्रेशन स्टेटस या अन्य उपयोगकर्ता की स्थिति के आधार पर, पसंद के मुताबिक कॉन्टेंट और कॉल-टू-ऐक्शन शेयर करें
खास जानकारी वाली रिपोर्ट जनरेट करें
Shared Storage की मदद से जानकारी इकट्ठा करें और तेज़ आवाज़ में इकट्ठा की गई खास जानकारी वाली रिपोर्ट जनरेट करें. इस्तेमाल के इन उदाहरणों के लिए आउटपुट गेट यह है प्राइवेट एग्रीगेशन एपीआई.
- यूनीक रीच मेज़रमेंट: कई कॉन्टेंट प्रोड्यूसर और विज्ञापन देने वाले यह जानना चाहते हैं कि लोगों ने उनका कॉन्टेंट देखा. किसी उपयोगकर्ता के पहली बार रिकॉर्ड करने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल करना ने आपके विज्ञापन, एम्बेड किए गए वीडियो या पब्लिकेशन को देखा और डुप्लीकेट कॉन्टेंट को रोका अलग-अलग साइटों पर एक ही उपयोगकर्ता की संख्या बढ़ाना. इसके बाद, अपनी पहुंच के बारे में खास जानकारी वाली रिपोर्ट बनाने के लिए, Private एग्रीगेशन एपीआई का इस्तेमाल किया जा सकता है.
- डेमोग्राफ़िक्स मेज़रमेंट: कॉन्टेंट प्रोड्यूसर आम तौर पर, अपने कॉन्टेंट के दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) और ऑडियंस. शेयर किए गए स्टोरेज का इस्तेमाल करके, उपयोगकर्ता के डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) का डेटा रिकॉर्ड किया जा सकता है उपलब्ध होते हैं, जैसे आपके पहले-पक्ष की साइट पर उपलब्ध हैं और एग्रीगेट किए गए कई दूसरी साइटों, जैसे कि एम्बेड किए गए कॉन्टेंट पर रिपोर्ट करने के लिए.
- K+ फ़्रीक्वेंसी मेज़रमेंट: कभी-कभी इसे "असरदार फ़्रीक्वेंसी" भी कहा जाता है. अक्सर एक कम से कम संख्या से पहले कि उपयोगकर्ता कुछ सामग्री को पहचान सके या याद रख पाए (अक्सर संदर्भ) शामिल है. रिपोर्ट बनाने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल किया जा सकता है उन यूनीक उपयोगकर्ताओं की संख्या जिन्होंने किसी कॉन्टेंट को कम से कम K बार देखा है.
दिलचस्पी बढ़ाएं और सुझाव दें
शेयर किए गए स्टोरेज के प्रस्ताव पर चर्चा जारी है और इसमें बदलाव हो सकता है आने वाले समय में. अगर आपने इस एपीआई को आज़माया है और आपके पास कोई सुझाव है, तो हमें ज़रूर बताएं.
- GitHub: पढ़ें प्रपोज़ल, व्हाइट पेपर पर जाएं, सवाल पूछें, और चर्चा में हिस्सा लें.
- Shared Storage API के बारे में सूचनाएं: हमारी ईमेल पाने वाले लोगों की सूची से जुड़ी सूचनाएं देखें या उनमें शामिल हों
- डेवलपर सहायता: इस ऐप्लिकेशन पर सवाल पूछें और चर्चाओं में शामिल हों Privacy Sandbox के लिए डेवलपर सहायता का डेटा स्टोर करने की जगह.