इसे कभी-कभी "असल फ़्रीक्वेंसी" भी कहा जाता है. आम तौर पर, किसी कॉन्टेंट को पहचानने या याद रखने से पहले, उपयोगकर्ता को कम से कम एक तय संख्या में व्यू मिलना ज़रूरी होता है. आम तौर पर, यह संख्या विज्ञापन व्यू के संदर्भ में होती है. Shared Storage का इस्तेमाल करके, उन यूनीक उपयोगकर्ताओं की रिपोर्ट बनाई जा सकती हैं जिन्होंने किसी कॉन्टेंट को कम से कम K बार देखा है.
Shared Storage API, Privacy Sandbox का एक प्रस्ताव है. इसका मकसद, अलग-अलग कामों के लिए क्रॉस-साइट स्टोरेज उपलब्ध कराना है. इस स्टोरेज का इस्तेमाल कई कामों के लिए किया जा सकता है. Private Aggregation API, Shared Storage में उपलब्ध एक आउटपुट है. इसकी मदद से, अलग-अलग साइटों से जुड़ा डेटा इकट्ठा किया जा सकता है.
K से ज़्यादा बार विज्ञापन देखे जाने का पता लगाने की सुविधा आज़माएं
Shared Storage और Private Aggregation की मदद से, K+ फ़्रीक्वेंसी मेज़रमेंट को एक्सपेरिमेंट के तौर पर आज़माने के लिए, पक्का करें कि आपके पास Chrome M107 या इसके बाद का वर्शन हो. chrome://settings/adPrivacy
में जाकर, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
कमांड लाइन में --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
फ़्लैग की मदद से भी, शेयर किया गया स्टोरेज चालू किया जा सकता है.
कोड सैंपल आज़माना
हो सकता है कि आपको उन उपयोगकर्ताओं की संख्या मेज़र करनी हो जिन्होंने अलग-अलग साइटों पर, किसी क्लाइंट को K या उससे ज़्यादा बार आपका कॉन्टेंट देखा है. इस उदाहरण में, इंप्रेशन की संख्या को शेयर किए गए स्टोरेज में जोड़ा जाता है. जब भी कॉन्टेंट लोड होता है, तो यह संख्या एक बढ़ जाती है. इंप्रेशन की संख्या तीन तक पहुंचने पर, Private Aggregation API को कॉल किया जाता है. Content ID डाइमेंशन को एग्रीगेशन कुंजी के तौर पर कोड में बदला जाता है. साथ ही, गिनती का इस्तेमाल एग्रीगेट की जा सकने वाली वैल्यू के तौर पर किया जाता है. खास जानकारी वाली रिपोर्ट में, "लगभग 391 उपयोगकर्ताओं ने विज्ञापन कैंपेन आईडी 123 को कम से कम तीन बार देखा है" जैसी जानकारी मिलेगी.
इस उदाहरण में:
k-frequency-measurement.js
को फ़्रेम का इस्तेमाल करके लोड किया जाता है. साथ ही, यह शेयर किए गए स्टोरेज के वर्कलेट को लोड करने के लिए ज़िम्मेदार होता है.k-frequency-measurement-worklet.js
, शेयर किए गए स्टोरेज का वर्कलेट है. यह शेयर किए गए स्टोरेज में इंप्रेशन की संख्या को पढ़ता है और Private Aggregation API का इस्तेमाल करके रिपोर्ट भेजता है.
k-frequency-measurement.js
async function injectContent() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule('k-freq-measurement-worklet.js');
// Run the K-frequency measurement operation
await window.sharedStorage.run('k-freq-measurement', { data: { kFreq: 3, contentId: 123 });
}
injectContent();
kuency-measurement-worklet.js
// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;
/**
* The bucket key must be a number, and in this case, it is just the content
* ID itself. For more complex bucket key construction, see other use cases in
* this demo.
*/
function convertContentIdToBucket(contentId) {
return BigInt(contentId);
}
class KFreqMeasurementOperation {
async run(data) {
const { kFreq, contentId } = data;
// Read from Shared Storage
const hasReportedContentKey = 'has-reported-content';
const impressionCountKey = 'impression-count';
const hasReportedContent = (await sharedStorage.get(hasReportedContentKey)) === 'true';
const impressionCount = parseInt((await sharedStorage.get(impressionCountKey)) || 0);
// Don't report if a report has been sent already
if (hasReportedContent) {
return;
}
// Check impression count against frequency limit
if (impressionCount < kFreq) {
await sharedStorage.set(impressionCountKey, impressionCount + 1);
return;
}
// Generate the aggregation key and the aggregatable value
const bucket = convertContentIdToBucket(contentId);
const value = 1 * SCALE_FACTOR;
// Send an aggregatable report using the Private Aggregation API
privateAggregation.contributeToHistogram({ bucket, value });
// Set the report submission status flag
await sharedStorage.set(hasReportedContentKey, 'true');
}
}
// Register the operation
register('k-freq-measurement', KFreqMeasurementOperation); \
दर्शकों से जुड़ना और सुझाव, राय या शिकायत शेयर करना
ध्यान दें कि Shared Storage API के प्रस्ताव पर फ़िलहाल चर्चा की जा रही है और इसे डेवलप किया जा रहा है. इसलिए, इसमें बदलाव हो सकते हैं.
हम शेयर किए गए स्टोरेज के एपीआई के बारे में आपके विचार जानना चाहते हैं.
- प्रस्ताव: ज़्यादा जानकारी वाले प्रस्ताव की समीक्षा करें.
- चर्चा: सवाल पूछने और अपनी अहम जानकारी शेयर करने के लिए, चल रही चर्चा में शामिल हों.
अप-टू-डेट रहना
- मेल सूची: Shared Storage API से जुड़े नए अपडेट और सूचनाओं के लिए, हमारी मेल सूची की सदस्यता लें.
क्या आपको मदद चाहिए?
- डेवलपर सहायता: दूसरे डेवलपर से जुड़ें और Privacy Sandbox के डेवलपर सहायता रिपॉज़िटरी में अपने सवालों के जवाब पाएं.