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

यूआरएल चुनने और उसे फ़ेंस किए गए फ़्रेम में रेंडर करने के लिए, 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);

उपयोग के उदाहरण

Select URL API के इस्तेमाल के सभी उपलब्ध उदाहरण, इस सेक्शन में देखे जा सकते हैं. हमें सुझाव, राय, और शिकायत मिलने पर, हम नए उदाहरण जोड़ते रहेंगे. साथ ही, नए टेस्ट केस भी जोड़ते रहेंगे.

Engage and share feedback

Note that the Select URL API proposal is under active discussion and development and subject to change.

We're eager to hear your thoughts on the Select URL API.

Stay Informed

  • Mailing List: Subscribe to our mailing list for the latest updates and announcements related to the Select URL and Shared Storage APIs.

Need Help?