यूआरएल चुनने और उसे फ़ेंस किए गए फ़्रेम में रेंडर करने के लिए, Shared Storage वाला वर्कलेट चलाएं.
Shared Storage API को निजता के तौर पर इस्तेमाल किया जाता है सामान्य उद्देश्य के लिए सैंडबॉक्स प्रस्ताव, क्रॉस-साइट स्टोरेज, जो कई इस्तेमाल के कुछ उदाहरण हो सकते हैं. इसका एक उदाहरण फ़्रीक्वेंसी कंट्रोल है, जो Chrome Beta 104.0.5086.0 और इसके बाद के वर्शन में टेस्ट करें.
सेव की गई सूची के आधार पर, दी गई सूची से यूआरएल चुनने के लिए वर्कलेट स्क्रिप्ट चलाएं डेटा को एक्सपोर्ट कर सकता है और फिर उस यूआरएल को फ़ेंस किए गए फ़्रेम में रेंडर कर सकता है. इसका इस्तेमाल चुनने के लिए किया जा सकता है नए विज्ञापन या अन्य कॉन्टेंट, जब फ़्रीक्वेंसी सीमा पूरी हो जाए.
फ़्रीक्वेंसी के हिसाब से क्रिएटिव चुनने की जांच करना
शेयर किए गए स्टोरेज और फ़ेंस किए गए फ़्रेम की मदद से, फ़्रीक्वेंसी के हिसाब से क्रिएटिव चुनने की जांच करने के लिए, पुष्टि करें कि आपने
Chrome 104.0.5086.0 या इसके बाद के वर्शन का इस्तेमाल करके. chrome://settings/adPrivacy
में शामिल, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
कमांड लाइन में मौजूद --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
फ़्लैग के साथ, शेयर किए गए स्टोरेज की सुविधा भी चालू की जा सकती है.
कोड सैंपल के साथ प्रयोग करें
ओपेक यूआरएल चुनने और बनाने के लिए, वर्कलेट मॉड्यूल रजिस्टर करें, ताकि उसे शेयर किया गया पढ़ा जा सके सेव किया जा सकता है. वर्कलेट क्लास को ज़्यादा से ज़्यादा आठ यूआरएल की सूची मिलती है और इसके बाद चुने गए यूआरएल का इंडेक्स दिखाता है.
जब क्लाइंट sharedStorage.selectURL()
को कॉल करता है, तो वर्कलेट
फ़ेंस किए गए फ़्रेम में रेंडर होने के लिए, ओपेक यूआरएल को एक्ज़ीक्यूट करता है और दिखाता है.
मान लें कि आपको विज्ञापन या कॉन्टेंट को किसी अन्य विज्ञापन या कॉन्टेंट को इस आधार पर चुनना है कि उपयोगकर्ता ने उसे पहले कितनी बार देखा है. आपके पास इस बात की गिनती करने का विकल्प होता है कि किसी व्यक्ति ने कितनी बार कॉन्टेंट देखा है और उस वैल्यू को शेयर किए गए स्टोरेज में सेव किया जा सकता है. स्टोर हो जाने के बाद, शेयर किए गए स्टोरेज की वैल्यू, अलग-अलग ऑरिजिन पर आपके लिए उपलब्ध हो जाती है.
इसके बाद, शेयर किए गए स्टोरेज का वर्कलेट, शेयर किए गए स्टोरेज की वैल्यू को पढ़ता है और हर अतिरिक्त व्यू के साथ काउंटर को बढ़ाता है. अगर सदस्यों की संख्या, पहले से तय की गई सीमा तक नहीं पहुंची है, तो आपको जो कॉन्टेंट रेंडर करना है उसे वापस कर दिया जाता है (इंडेक्स 1
). अगर ऐसा नहीं है, तो डिफ़ॉल्ट यूआरएल दिखता है (इंडेक्स 0
).
इस उदाहरण में:
creative-selection-by-frequencyjs
, कॉन्टेंट प्रोड्यूसर या विज्ञापन देने वाले के iframe के ज़रिए लोड होता है और इसके लिए ज़िम्मेदार है को लोड करने और लौटाए गए ओपेक को रेंडर करने के लिए को फ़ेंस किए गए फ़्रेम में डाल सकते हैं.creative-selection-by-frequency-worklet.js
शेयर किए गए स्टोरेज का वर्कलेट है, जिस पर लिखा है से तय होता है कि किसी कॉन्टेंट या विज्ञापन क्रिएटिव के लिए कौनसा यूआरएल दिखाया जाएगा.
creative-selection-by-frequency.js
// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
{ url: `https://${contentProducerUrl}/default-content.html` },
{ url: `https://${contentProducerUrl}/example-content.html` },
];
async function injectAd() {
// Load the worklet module.
await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');
// Set the initial frequency count
window.sharedStorage.set('frequency-count', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose an ad based on the frequency count in shared storage.
const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
creative-selection-by-frequency-worklet.js
const FREQUENCY_LIMIT = 5;
class CreativeSelectionByFrequencyOperation {
async run(urls, data) {
// Read the current frequency limit in shared storage
const count = parseInt(await sharedStorage.get('frequency-count'));
// Check if the frequency limit has been reached.
if (count === FREQUENCY_LIMIT) {
console.log('Frequency limit has been reached, and the default content will be rendered.');
return 0;
}
// Set the new frequency count in shared storage
await sharedStorage.set('frequency-count', count + 1);
return 1;
}
}
// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);
उपयोग के उदाहरण
ये, शेयर किए गए स्टोरेज के इस्तेमाल के कुछ संभावित उदाहरण हैं. हम में आप लगातार उदाहरण जोड़ रहे हैं, सुझाव या राय दो और इसके इस्तेमाल के नए उदाहरणों के बारे में जान सकते हैं.
कॉन्टेंट चुनें
इसमें अलग-अलग वेबसाइटों पर अलग-अलग कॉन्टेंट चुनना और दिखाना जानकारी के आधार पर, फ़ेंस किए गए फ़्रेम शेयर किए गए स्टोरेज में इकट्ठा किए गए आइटम. इस्तेमाल के इन उदाहरणों के लिए, आउटपुट गेट यूआरएल को चुनना है.
- क्रिएटिव रोटेशन: क्रिएटिव आईडी, व्यू की संख्या, और उपयोगकर्ता इंटरैक्शन जैसे डेटा को स्टोर करें, ताकि यह तय किया जा सके कि किस क्रिएटिव उपयोगकर्ता की अलग-अलग साइटों पर दिखते हैं.
- A/B टेस्टिंग: किसी उपयोगकर्ता को, किसी टेस्ट ग्रुप में असाइन करके, उस ग्रुप को Shared Storage में स्टोर किया जा सकता है, ताकि उसे क्रॉस-साइट ऐक्सेस किया जा सके.
- पसंद के मुताबिक उपयोगकर्ता अनुभव: उपयोगकर्ता के रजिस्ट्रेशन स्टेटस या अन्य उपयोगकर्ता की स्थिति के आधार पर, पसंद के मुताबिक कॉन्टेंट और कॉल-टू-ऐक्शन शेयर करें
खास जानकारी वाली रिपोर्ट जनरेट करें
Shared Storage की मदद से जानकारी इकट्ठा करें और तेज़ आवाज़ में इकट्ठा की गई खास जानकारी वाली रिपोर्ट जनरेट करें. इस्तेमाल के इन उदाहरणों के लिए आउटपुट गेट यह है प्राइवेट एग्रीगेशन एपीआई.
- यूनीक रीच मेज़रमेंट: कई कॉन्टेंट प्रोड्यूसर और विज्ञापन देने वाले यह जानना चाहते हैं कि लोगों ने उनका कॉन्टेंट देखा. किसी उपयोगकर्ता के पहली बार रिकॉर्ड करने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल करना ने आपके विज्ञापन, एम्बेड किए गए वीडियो या पब्लिकेशन को देखा और डुप्लीकेट कॉन्टेंट को रोका अलग-अलग साइटों पर एक ही उपयोगकर्ता की संख्या बढ़ाना. इसके बाद, अपनी पहुंच के बारे में खास जानकारी वाली रिपोर्ट बनाने के लिए, Private एग्रीगेशन एपीआई का इस्तेमाल किया जा सकता है.
- डेमोग्राफ़िक्स मेज़रमेंट: कॉन्टेंट प्रोड्यूसर आम तौर पर, अपने कॉन्टेंट के दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) और ऑडियंस. शेयर किए गए स्टोरेज का इस्तेमाल करके, उपयोगकर्ता के डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) का डेटा रिकॉर्ड किया जा सकता है उपलब्ध होते हैं, जैसे आपके पहले-पक्ष की साइट पर उपलब्ध हैं और एग्रीगेट किए गए कई दूसरी साइटों, जैसे कि एम्बेड किए गए कॉन्टेंट पर रिपोर्ट करने के लिए.
- K+ फ़्रीक्वेंसी मेज़रमेंट: कभी-कभी इसे "असरदार फ़्रीक्वेंसी" भी कहा जाता है. अक्सर एक कम से कम संख्या से पहले कि उपयोगकर्ता कुछ सामग्री को पहचान सके या याद रख पाए (अक्सर संदर्भ) शामिल है. रिपोर्ट बनाने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल किया जा सकता है उन यूनीक उपयोगकर्ताओं की संख्या जिन्होंने किसी कॉन्टेंट को कम से कम K बार देखा है.
दिलचस्पी बढ़ाएं और सुझाव दें
शेयर किए गए स्टोरेज के प्रस्ताव पर चर्चा जारी है और इसमें बदलाव हो सकता है आने वाले समय में. अगर आपने इस एपीआई को आज़माया है और आपके पास कोई सुझाव है, तो हमें ज़रूर बताएं.
- GitHub: पढ़ें प्रपोज़ल, व्हाइट पेपर पर जाएं, सवाल पूछें, और चर्चा में हिस्सा लें.
- Shared Storage API के बारे में सूचनाएं: हमारी ईमेल पाने वाले लोगों की सूची से जुड़ी सूचनाएं देखें या उनमें शामिल हों
- डेवलपर सहायता: इस ऐप्लिकेशन पर सवाल पूछें और चर्चाओं में शामिल हों Privacy Sandbox के लिए डेवलपर सहायता का डेटा स्टोर करने की जगह.