फ़्रीक्वेंसी के हिसाब से क्रिएटिव चुनें

यूआरएल चुनने और उसे फ़ेंस किए गए फ़्रेम में रेंडर करने के लिए, Shared Storage वाला वर्कलेट चलाएं.

Shared Storage API को प्राइवसी सैंडबॉक्स के प्रपोज़ल के तौर पर इस्तेमाल किया जाता है. इसे अलग-अलग साइट के स्टोरेज के लिए इस्तेमाल किया जाता है. इससे अलग-अलग तरह के डेटा का इस्तेमाल करने की सुविधा मिलती है. फ़्रीक्वेंसी कंट्रोल का एक उदाहरण है, जो Chrome बीटा 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 this.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 this.sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

इस्तेमाल के उदाहरण

यहां शेयर किए गए स्टोरेज के इस्तेमाल के कुछ ही उदाहरण दिए गए हैं. हम सुझाव, शिकायत या राय मिलने और इस्तेमाल के नए उदाहरण खोजते समय, उदाहरण जोड़ते रहेंगे.

कॉन्टेंट चुनें

शेयर किए गए स्टोरेज में इकट्ठा की गई जानकारी के आधार पर, अलग-अलग वेबसाइटों पर फ़ेंस किए गए फ़्रेम में अलग-अलग कॉन्टेंट चुनें और दिखाएं. इस्तेमाल के इन मामलों में, यूआरएल चुनने का आउटपुट गेट होता है.

  • क्रिएटिव रोटेशन: क्रिएटिव आईडी, व्यू की संख्या, और उपयोगकर्ता के इंटरैक्शन जैसा डेटा स्टोर करके, यह तय किया जा सकता है कि अलग-अलग साइटों पर कौनसे क्रिएटिव उपयोगकर्ता को दिखे.
  • A/B टेस्टिंग: किसी उपयोगकर्ता को एक्सपेरिमेंट ग्रुप में असाइन किया जा सकता है. इसके बाद, उस ग्रुप को क्रॉस-साइट ऐक्सेस करने के लिए, शेयर किए गए स्टोरेज में सेव किया जा सकता है.
  • पसंद के मुताबिक उपयोगकर्ता अनुभव: उपयोगकर्ता के रजिस्ट्रेशन की स्थिति या उपयोगकर्ता की अन्य स्थितियों के आधार पर, पसंद के मुताबिक बनाया गया कॉन्टेंट और कॉल-टू-ऐक्शन शेयर करें

खास जानकारी वाली रिपोर्ट जनरेट करना

शेयर किए गए स्टोरेज की मदद से जानकारी इकट्ठा करें और ग़ैर-ज़रूरी और एग्रीगेट की गई खास जानकारी वाली रिपोर्ट जनरेट करें. इस्तेमाल के इन मामलों के लिए आउटपुट गेट प्राइवेट एग्रीगेशन एपीआई है.

  • यूनीक रीच मेज़रमेंट: कई कॉन्टेंट प्रोड्यूसर और विज्ञापन देने वाले यह जानना चाहते हैं कि कितने यूनीक लोगों ने उनका कॉन्टेंट देखा. जब किसी उपयोगकर्ता ने पहली बार आपका विज्ञापन, एम्बेड किया वीडियो या पब्लिकेशन देखा हो, तो उसे रिकॉर्ड करने के लिए शेयर किए गए स्टोरेज का इस्तेमाल करें. साथ ही, अलग-अलग साइटों पर उस उपयोगकर्ता की डुप्लीकेट गिनती को रोकने के लिए, शेयर किए गए स्टोरेज का इस्तेमाल करें. इसके बाद, अपनी पहुंच के बारे में खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, Private एग्रीगेशन API का इस्तेमाल करें.
  • डेमोग्राफ़िक्स मेज़रमेंट: कॉन्टेंट प्रोड्यूसर अक्सर अपने दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) के बारे में जानना चाहते हैं. शेयर किए गए स्टोरेज का इस्तेमाल, उपयोगकर्ता के डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) डेटा को उस संदर्भ में रिकॉर्ड करने के लिए किया जा सकता है जहां आपके पास वह है, जैसे कि पहले-पक्ष की साइट. साथ ही, एम्बेड किए गए कॉन्टेंट जैसी कई अन्य साइटों पर इसकी रिपोर्ट करने के लिए, एग्रीगेट की गई रिपोर्टिंग का इस्तेमाल किया जा सकता है.
  • K+ फ़्रीक्वेंसी मेज़रमेंट: कभी-कभी इसे "असरदार फ़्रीक्वेंसी" भी कहा जाता है. आम तौर पर, किसी कॉन्टेंट को पहचानने या उसे याद रखने से पहले, आम तौर पर उसे कम से कम संख्या में देखा जाता है. आम तौर पर, विज्ञापन देखे जाने के संदर्भ में ऐसा होता है. शेयर किए गए स्टोरेज की मदद से, ऐसे यूनीक उपयोगकर्ताओं की रिपोर्ट बनाई जा सकती हैं जिन्होंने किसी कॉन्टेंट को कम से कम K कितनी बार देखा है.

लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें

शेयर किए गए स्टोरेज के प्रपोज़ल पर अभी चर्चा चल रही है. आने वाले समय में, इसमें बदलाव हो सकता है. अगर आप इस एपीआई को आज़माते हैं और आपके पास कोई सुझाव, राय या शिकायत है, तो हमें खुशी होगी.