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

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

Shared Storage API, प्राइवसी सैंडबॉक्स से जुड़ा एक प्रस्ताव है. इसे अलग-अलग कामों के लिए, अलग-अलग कामों के लिए इस्तेमाल किया जाता है. इससे कई तरीकों से मदद मिल सकती है. फ़्रीक्वेंसी कंट्रोल का एक उदाहरण है, जो Chrome बीटा 104.0.5086.0 और उसके बाद के वर्शन में जांच के लिए उपलब्ध है.

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

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

शेयर किए गए स्टोरेज और फ़ेंस किए गए फ़्रेम की मदद से, फ़्रीक्वेंसी के हिसाब से क्रिएटिव चुनने की जांच करने के लिए, पुष्टि करें कि Chrome 104.0.5086.0 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है. इसके बाद, chrome://flags/#privacy-sandbox-ads-apis पर जाकर Privacy Sandbox Ads API प्रयोग फ़्लैग को चालू करें.

इन एपीआई का इस्तेमाल करने के लिए, Privacy Sandbox Ads API का एक्सपेरिमेंट 'चालू है' पर सेट करें

कमांड लाइन में --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 कितनी बार देखा है.

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

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