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

यूआरएल चुनने और उसे फ़ेंस किए गए फ़्रेम में रेंडर करने के लिए, 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 टेस्टिंग: किसी उपयोगकर्ता को एक्सपेरिमेंट ग्रुप में असाइन किया जा सकता है. इसके बाद, उस ग्रुप को शेयर किए गए स्टोरेज में सेव किया जा सकता है, ताकि उसे अलग-अलग साइटों से ऐक्सेस किया जा सके.
  • उपयोगकर्ताओं को कस्टम अनुभव देना: उपयोगकर्ता के रजिस्ट्रेशन स्टेटस या अन्य स्थितियों के आधार पर, कस्टम कॉन्टेंट और कॉल-टू-ऐक्शन शेयर करना

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

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

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

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

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

हम शेयर किए गए स्टोरेज के एपीआई के बारे में आपके विचार जानना चाहते हैं.

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

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

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