जाने-पहचाने ग्राहकों की पहचान करने के लिए, 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 this.sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
इस्तेमाल के उदाहरण
यहां शेयर किए गए स्टोरेज के इस्तेमाल के कुछ ही उदाहरण दिए गए हैं. हम सुझाव, शिकायत या राय मिलने और इस्तेमाल के नए उदाहरण खोजते समय, उदाहरण जोड़ते रहेंगे.
कॉन्टेंट चुनें
शेयर किए गए स्टोरेज में इकट्ठा की गई जानकारी के आधार पर, अलग-अलग वेबसाइटों पर फ़ेंस किए गए फ़्रेम में अलग-अलग कॉन्टेंट चुनें और दिखाएं. इस्तेमाल के इन मामलों में, यूआरएल चुनने का आउटपुट गेट होता है.
- क्रिएटिव रोटेशन: क्रिएटिव आईडी, व्यू की संख्या, और उपयोगकर्ता के इंटरैक्शन जैसा डेटा स्टोर करके, यह तय किया जा सकता है कि अलग-अलग साइटों पर कौनसे क्रिएटिव उपयोगकर्ता को दिखे.
- A/B टेस्टिंग: किसी उपयोगकर्ता को एक्सपेरिमेंट ग्रुप में असाइन किया जा सकता है. इसके बाद, उस ग्रुप को क्रॉस-साइट ऐक्सेस करने के लिए, शेयर किए गए स्टोरेज में सेव किया जा सकता है.
- पसंद के मुताबिक उपयोगकर्ता अनुभव: उपयोगकर्ता के रजिस्ट्रेशन की स्थिति या उपयोगकर्ता की अन्य स्थितियों के आधार पर, पसंद के मुताबिक बनाया गया कॉन्टेंट और कॉल-टू-ऐक्शन शेयर करें
खास जानकारी वाली रिपोर्ट जनरेट करना
शेयर किए गए स्टोरेज की मदद से जानकारी इकट्ठा करें और ग़ैर-ज़रूरी और एग्रीगेट की गई खास जानकारी वाली रिपोर्ट जनरेट करें. इस्तेमाल के इन मामलों के लिए आउटपुट गेट प्राइवेट एग्रीगेशन एपीआई है.
- यूनीक रीच मेज़रमेंट: कई कॉन्टेंट प्रोड्यूसर और विज्ञापन देने वाले यह जानना चाहते हैं कि कितने यूनीक लोगों ने उनका कॉन्टेंट देखा. जब किसी उपयोगकर्ता ने पहली बार आपका विज्ञापन, एम्बेड किया वीडियो या पब्लिकेशन देखा हो, तो उसे रिकॉर्ड करने के लिए शेयर किए गए स्टोरेज का इस्तेमाल करें. साथ ही, अलग-अलग साइटों पर उस उपयोगकर्ता की डुप्लीकेट गिनती को रोकने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल करें. इसके बाद, अपनी पहुंच के बारे में खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, Private एग्रीगेशन API का इस्तेमाल करें.
- डेमोग्राफ़िक्स मेज़रमेंट: कॉन्टेंट प्रोड्यूसर अक्सर अपने दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) के बारे में जानना चाहते हैं. शेयर किए गए स्टोरेज का इस्तेमाल, उपयोगकर्ता के डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) डेटा को उस संदर्भ में रिकॉर्ड करने के लिए किया जा सकता है जहां आपके पास वह है, जैसे कि पहले-पक्ष की साइट. साथ ही, एम्बेड किए गए कॉन्टेंट जैसी कई अन्य साइटों पर इसकी रिपोर्ट करने के लिए, एग्रीगेट की गई रिपोर्टिंग का इस्तेमाल किया जा सकता है.
- K+ फ़्रीक्वेंसी मेज़रमेंट: कभी-कभी इसे "असरदार फ़्रीक्वेंसी" भी कहा जाता है. आम तौर पर, किसी कॉन्टेंट को पहचानने या उसे याद रखने से पहले, आम तौर पर उसे कम से कम संख्या में देखा जाता है. आम तौर पर, विज्ञापन देखे जाने के संदर्भ में ऐसा होता है. शेयर किए गए स्टोरेज की मदद से, ऐसे यूनीक उपयोगकर्ताओं की रिपोर्ट बनाई जा सकती हैं जिन्होंने किसी कॉन्टेंट को कम से कम K कितनी बार देखा है.
दिलचस्पी बढ़ाएं और सुझाव दें
शेयर किए गए स्टोरेज के प्रस्ताव पर चर्चा जारी है और इसमें बदलाव हो सकता है आने वाले समय में. अगर आपने इस एपीआई को आज़माया है और आपके पास कोई सुझाव है, तो हमें ज़रूर बताएं.
- GitHub: पढ़ें प्रपोज़ल, व्हाइट पेपर पर जाएं, सवाल पूछें, और चर्चा में हिस्सा लें.
- Shared Storage API के बारे में सूचनाएं: हमारी ईमेल पाने वाले लोगों की सूची से जुड़ी सूचनाएं देखें या उनमें शामिल हों
- डेवलपर सहायता: इस ऐप्लिकेशन पर सवाल पूछें और चर्चाओं में शामिल हों Privacy Sandbox के लिए डेवलपर सहायता का डेटा स्टोर करने की जगह.