यूआरएल की खास जानकारी चुनें

चुनिंदा यूआरएल की मदद से, यह चुना जा सकता है कि किसी उपयोगकर्ता को शेयर किए गए स्टोरेज के डेटा के आधार पर कौनसा कॉन्टेंट दिखाना है. ऐसा करने पर, सेव किए गए डेटा को नहीं दिखाया जाता.

अगर आपको उपयोगकर्ता की निजता को ध्यान में रखते हुए, अलग-अलग साइटों के डेटा के आधार पर कॉन्टेंट दिखाना है, तो Select URL API का इस्तेमाल करें. Select URL API, इन कामों के लिए बेहतर तरीके से काम करता है:

  • एक से ज़्यादा साइटों पर उपयोगकर्ताओं को एक जैसा अनुभव देने के लिए, कॉन्टेंट की A/B टेस्टिंग.
  • जिन उपयोगकर्ताओं के पास खाता है और जिनके पास खाता नहीं है, उनके लिए अलग-अलग लॉगिन बटन दिखाना.
  • विज्ञापन क्रिएटिव को रोटेट करना, ताकि उपयोगकर्ता को एक ही विज्ञापन कई साइटों पर कितनी बार दिखे, यह सीमित किया जा सके.

Select URL API क्या है?

Select URL API की मदद से, अलग-अलग साइटों के डेटा के आधार पर, यूआरएल के सेट में से कोई एक चुना जा सकता है. यह एपीआई, शेयर किए गए स्टोरेज के ऊपर बनाया गया है. साथ ही, उपलब्ध क्रॉस-साइट डेटा को पढ़ने और दिए गए यूआरएल में से किसी एक को चुनने के लिए, SharedStorageWorklet का इस्तेमाल करता है. चुने गए यूआरएल को कॉलर को इस तरह दिखाया जाता है कि उसे फ़ेंस किए गए फ़्रेम के अलावा किसी और जगह पर न पढ़ा जा सके. यूआरएल को कम से कम 2026 तक iframe में भी रेंडर किया जा सकता है.

news.example, blog.example जैसी अलग-अलग पब्लिशर की साइटों में एम्बेड किए गए shoes.example iframe को दिखाने वाला डायग्राम. shoes.com साइट, हर टॉप-लेवल साइट से अपना बिना बंटवारा वाला स्टोरेज ऐक्सेस कर सकती है.

पिछले डायग्राम में, shoes.example साइट को news.example जैसी अन्य पब्लिशर साइटों में एम्बेड किया जा सकता है. साथ ही, एम्बेड करने के लिए सही कॉन्टेंट चुनने के लिए, शेयर किए गए स्टोरेज के साथ Select यूआरएल का इस्तेमाल करके, उसी डेटा को ऐक्सेस किया जा सकता है.

'यूआरएल चुनें' सुविधा कैसे काम करती है

Select URL API का इस्तेमाल करके, किसी यूआरएल को चुना जा सकता है, ताकि उसे क्रॉस-साइट डेटा का इस्तेमाल करके, फ़ेंस किए गए फ़्रेम या iframe में रेंडर किया जा सके. Shared Storage में क्रॉस-साइट डेटा को पढ़ने और उसमें डेटा लिखने के लिए, JavaScript का इस्तेमाल करें. इसके बाद, सेव किए गए डेटा के आधार पर, दी गई सूची से कोई यूआरएल चुनें.

रजिस्टर की गई कोई भी साइट या ऑरिजिन, शेयर किए गए स्टोरेज में डेटा लिख सकता है. इसके बाद, साइटें सिर्फ़ Select URL API की मदद से उस डेटा को पढ़ सकती हैं.

रेंडर किए गए यूआरएल में किसी भी तरह का कॉन्टेंट शामिल हो सकता है: विज्ञापन, लेख, इमेज, एचटीएमएल, कॉल-टू-ऐक्शन (जैसे, बटन) वगैरह.

इस उदाहरण में, आपके पास एक ट्रैवल साइट है और आपने तीन अलग-अलग विज्ञापन क्रिएटिव के साथ एक विज्ञापन कैंपेन चलाया है. आपको उपयोगकर्ता के इंटरैक्शन (व्यू या क्लिक) के आधार पर, इन क्रिएटिव का क्रम तय करना है.

तीन विज्ञापन क्रिएटिव, जो उपयोगकर्ताओं को उनके पिछले इंटरैक्शन के आधार पर दिखाए जाते हैं.
नए दर्शक के लिए पहला क्रिएटिव, "अपने अगले सफ़र पर निकलें" कहता है. अगर उपयोगकर्ता ने विज्ञापन को सिर्फ़ देखा है और उस पर क्लिक नहीं किया है, तो उसे अगला क्रिएटिव दिखेगा. इसमें, "वीकेंड के लिए घूमने-फिरने की जगहें एक्सप्लोर करें" लिखा होगा. तीसरा क्रिएटिव देखने या उस पर क्लिक करने के बाद, उपयोगकर्ताओं को "होटल की छूट पाने के लिए क्लिक करें" का सुझाव दिया जाता है. अगर उपयोगकर्ता पहले विज्ञापन पर क्लिक करता है, तो उसे तीसरा क्रिएटिव दिखेगा.

जब कोई साइट पहली बार विज्ञापन के लिए उपलब्ध जगह देखती है, तो शेयर किए गए स्टोरेज में उस क्रिएटिव के लिए आईडी और क्लिक की स्थिति सेव की जा सकती है.

उदाहरण के लिए:

await sharedStorage.set('last-creative', 'globe');
await sharedStorage.set('click', 'true');

इसका मतलब है कि जब उपयोगकर्ता किसी दूसरी साइट पर जाता है और आप उस साइट पर विज्ञापन नीलामी जीतते हैं, तो उस डेटा के आधार पर, उपयोगकर्ता को कोई दूसरा विज्ञापन दिखाया जा सकता है.

शेयर किए गए स्टोरेज के बारे में जानकारी देने वाली प्रोसेस, जिसमें तीन विज्ञापन क्रिएटिव और उपयोगकर्ता इंटरैक्शन शामिल हैं.

यह जानकारी पाने के लिए, आपका JavaScript SharedStorageWorklet में चलता है. हालांकि, आपका कोड पैरंट पेज पर मौजूद iframe या फ़ेंस किए गए फ़्रेम के बाहर के साथ इंटरैक्ट या कम्यूनिकेट नहीं कर सकता.

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

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

बजट मैनेज करना

अलग-अलग साइटों पर डेटा लीक होने के जोखिम को कम करने के लिए, Select URL API लंबे और छोटे समय के बजट के कॉम्बिनेशन वाले बजट सिस्टम का इस्तेमाल करता है:

  • लंबी अवधि का बजट: selectURL() का इस्तेमाल करते समय, लंबी अवधि का बजट हर कॉलर साइट के लिए, हर दिन 12 बिट होता है. इस बजट का शुल्क सिर्फ़ तब लिया जाता है, जब चुने गए यूआरएल को होस्ट करने वाला फ़्रेम, टॉप-लेवल नेविगेशन करता है. इसकी लागत log2(number of URLs) के तौर पर कैलकुलेट की जाती है. इसलिए, अगर आपने चुनने के लिए आठ यूआरएल दिए हैं, तो लागत तीन बिट होगी. दिन के लिए बचे बजट का हिसाब 12 - (sum of bits deducted in the last 24 hours) के तौर पर लगाया जाता है. अगर बजट खत्म हो जाता है, तो डिफ़ॉल्ट यूआरएल (सूची में पहला यूआरएल) दिखाया जाता है. अगर डिफ़ॉल्ट यूआरएल पर नेविगेट किया जाता है, तो एक बिट लॉग किया जाता है.

  • कुछ समय के लिए तय किए गए बजट: कुछ समय के लिए तय किए गए बजट, हर पेज लोड के हिसाब से अतिरिक्त सीमाएं होती हैं. ये सीमाएं तब तक लागू रहती हैं, जब तक फ़ेंस किए गए फ़्रेम पूरी तरह से लागू नहीं हो जाते और इवेंट-लेवल की रिपोर्टिंग उपलब्ध नहीं हो जाती. हर कॉल करने वाली साइट के लिए, हर पेज लोड पर 6 बिट का बजट होता है. इससे यह तय होता है कि कोई कॉल करने वाली साइट, selectURL() का इस्तेमाल करके कितनी जानकारी लीक कर सकती है. हर पेज लोड के लिए कुल 12 बिट का बजट भी होता है. यह एक पेज पर कॉल करने वाली सभी साइटों के लिए तय की गई कुल सीमा होती है.

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

    सेव की गई क्वेरी लागू करने के लिए, विकल्प ऑब्जेक्ट में अपनी चुनी गई क्वेरी के नाम के साथ savedQuery प्रॉपर्टी जोड़ें, जैसा कि इस उदाहरण में दिखाया गया है.

    const topProductUrls = [
  { url: 'https://ad.example/default-top-product.html' },
  { url: 'https://ad.example/experiment-top-product.html' }];
const relatedProductUrls = [
  { url: 'https://ad.example/default-related-product.html' },
  { url: 'https://ad.example/experiment-related-product.html' }];

// This is the first call to `selectURL()` with `savedQuery: 'control_or_experiment'`
// on this page, so it will be charged to both per-page budgets.
const topProductsConfig = await sharedStorage.selectURL(
  'productExperiment', topProductUrls, {
    savedQuery: 'control_or_experiment',
    keepAlive: true,
    resolveToConfig: true
});
document.getElementById('topProductsFencedFrame').config = topProductsConfig;

// This next call with this savedQuery won't charge either of the per-page budgets.
const relatedProductConfig = await sharedStorage.selectURL(
  'productExperiment', relatedProductUrls, {
    savedQuery: 'control_or_experiment',
    resolveToConfig: true
});
document.getElementById("relatedProductFencedFrame").config = relatedProductConfig;
    फ़्लैग का इस्तेमाल करें

यूआरएल एपीआई के इस्तेमाल के उदाहरण

अगर आपको ऐसी वेबसाइट बनानी है जिसमें अलग-अलग डोमेन पर काम करने वाली सुविधाएं हों, तो इनमें से कोई एक इस्तेमाल का उदाहरण हो सकता है:

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

शेयर किए गए स्टोरेज के साथ Select URL API का इस्तेमाल करके, अलग-अलग टॉप-लेवल साइटों पर एक ही स्टोरेज का ऐक्सेस लेकर, इन इस्तेमाल के उदाहरणों को डेवलप किया जा सकता है.

डेमो आज़माना

शेयर किए गए स्टोरेज के डेमो का इस्तेमाल करके, चुनिंदा यूआरएल के साथ एक्सपेरिमेंट किया जा सकता है.

यह डेमो, विज्ञापन देने वाले, विज्ञापन टेक्नोलॉजी, कॉन्टेंट डिस्ट्रिब्यूटर या तीसरे पक्ष की ऐसी सेवा के नज़रिए से बनाया गया है जो अलग-अलग पब्लिशर की साइटों पर जानकारी सेव करना चाहती है. डेमो में, हर इस्तेमाल के उदाहरण के लिए, तीसरे पक्ष का एक ही कोड, पब्लिशर A और पब्लिशर B, दोनों साइटों पर चलता है. हर पब्लिशर के पेज पर जाकर देखें कि डेटा को क्रॉस-साइट कॉन्टेक्स्ट में कैसे शेयर किया जाता है.

GitHub पर, डेमो के कोड की समीक्षा भी की जा सकती है.

एपीआई की स्थिति

Select URL API, सामान्य तौर पर उपलब्ध है. Select URL API का इस्तेमाल करने या इसे लोकल डेवलपमेंट के लिए चालू करने के लिए, Privacy Sandbox के लिए रजिस्टर करने के निर्देशों का पालन करें.

प्रस्ताव स्थिति
कॉन्टेंट चुनने के लिए इवेंट-लेवल रिपोर्टिंग (selectURL()) कम से कम 2026 तक उपलब्ध रहेगा
हर साइट के हिसाब से बजट तय करना
जानकारी		 M119 में उपलब्ध है
DevTools की मदद से, Shared Storage के वर्कलेट डीबग करना
सेक्शन		 M120 में उपलब्ध है

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

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

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

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

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

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