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

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

Use cases

All available use cases for Select URL API can be found in this section. We'll continue to add examples as we receive feedback and discover new test cases.

• Rotate ad creatives: Store data, such as creative ID and user interaction, to determine which creative users' see across different sites.
• Select ad creatives by frequency: Use view count data to determine which creative users' see across different sites.
• Run A/B testing: You can assign a user to an experiment group, then store that group in Shared Storage to be accessed cross-site.
• Customize experience for known customers: Share custom content and calls-to-action based on a user's registration status or other user states.

दर्शकों से जुड़ना और सुझाव, राय या शिकायत शेयर करना

ध्यान दें कि Select URL API के प्रस्ताव पर फ़िलहाल चर्चा की जा रही है और इसे डेवलप किया जा रहा है. इसमें बदलाव किया जा सकता है.

हमें Select URL API के बारे में आपके विचार जानने में दिलचस्पी है.

• प्रस्ताव: ज़्यादा जानकारी वाले प्रस्ताव की समीक्षा करें.
• चर्चा: सवाल पूछने और अपनी अहम जानकारी शेयर करने के लिए, चल रही चर्चा में शामिल हों.

अप-टू-डेट रहना

• मेल सूची: चुनिंदा यूआरएल और शेयर किए गए स्टोरेज एपीआई से जुड़े नए अपडेट और सूचनाओं के लिए, हमारी मेलिंग सूची की सदस्यता लें.

क्या आपको मदद चाहिए?

• डेवलपर सहायता: दूसरे डेवलपर से जुड़ें और Privacy Sandbox के डेवलपर सहायता रिपॉज़िटरी में अपने सवालों के जवाब पाएं.