एक्सपेरिमेंट करें और जानें कि कम से कम सेटअप वाले होस्टनेम से विषयों का अनुमान कैसे लगाया जाता है.
लागू करने की स्थिति
- Topics API ने सार्वजनिक बातचीत के चरण को पूरा कर लिया है और फ़िलहाल यह 99 प्रतिशत उपयोगकर्ताओं के लिए उपलब्ध है. इसे अब 100 प्रतिशत तक इस्तेमाल किया जा सकता है.
- Topics API पर सुझाव या राय देने के लिए, विषय की जानकारी देने वाले पेज पर समस्या बनाएं या वेब विज्ञापन कारोबार की जगहों के ग्रुप को बेहतर बनाने से जुड़ी चर्चा में हिस्सा लें. जानकारी देने वाले टूल में कई ऐसे सवाल हैं जिनका जवाब देना अभी बाकी है.
- प्राइवसी सैंडबॉक्स की टाइमलाइन, Topics API और प्राइवसी सैंडबॉक्स के अन्य प्रपोज़ल को लागू करने की टाइमलाइन से जुड़ी जानकारी देती है.
- Topics API: नए अपडेट में, Topics API और उसे लागू करने के तरीके में हुए बदलावों और सुधारों की जानकारी दी गई है.
Topics API के डेमो से यह पता चलता है कि होस्टनेम से विषयों का अनुमान कैसे लगाया जाता है. डेमो साइट को ऐक्सेस करने के बाद, उससे जुड़े विषयों की झलक देखी जा सकती है. हालांकि, इसके लिए बहुत कम सेटअप की ज़रूरत होती है.
हमारा डेमो, Topics API की ज़्यादातर सुविधाओं की झलक दिखाता है, ताकि आप यह जान सकें कि एपीआई को कैसे लागू किया जाता है.
Topics colab इस्तेमाल करके, Topics का क्लासिफ़ायर मॉडल भी आज़माया जा सकता है.
नीचे दिए गए वीडियो में डेमो के काम करने का तरीका दिखाया गया है.
chrome://flags या फ़ीचर फ़्लैग की मदद से जांच करना
एक उपयोगकर्ता के तौर पर Topics API को दो तरीके से इस्तेमाल किया जा सकता है; आपको Chrome 101 या उसके बाद का वर्शन चलाना होगा:
chrome://settings/adPrivacy
में शामिल, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.Chrome को इन फ़्लैग के साथ कमांड लाइन से चलाएं:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Topics API का डेमो
Topics डेमो में, सेटिंग में बदलाव करने के लिए दूसरे फ़्लैग इस्तेमाल करने का तरीका बताया गया है, जैसे कि Epoch की लंबाई. अगर कमांड-लाइन फ़्लैग के साथ Chrome को चलाकर, Topics API ऐक्सेस किया जाता है, तो chrome://flags
को सेट न करें, क्योंकि ये कमांड-लाइन सेटिंग को बदल सकते हैं.
फ़्लैग के साथ Chromium चलाएं कमांड लाइन से Chrome और अन्य Chromium आधारित ब्राउज़र चलाते समय फ़्लैग सेट करने का तरीका बताता है, हालांकि यह डेमो खास तौर पर Google Chrome के लिए है.
Topics API हेडर का डेमो
topics-fetch-demo.glitch.me पर मौजूद डेमो दिखाता है कि विषयों को ऐक्सेस करने के लिए fetch()
अनुरोध और जवाब हेडर का इस्तेमाल कैसे करें और उन्हें 'देखा गया' के तौर पर कैसे मार्क करें.
Sec-Browsing-Topics
अनुरोध का हेडर ऐक्सेस करें
किसी उपयोगकर्ता के विषय देखने के लिए, iframe के document.browsingTopics()
का इस्तेमाल करने के बजाय, एपीआई कॉलर किसी फ़ेच() अनुरोध के Sec-Browsing-Topics
अनुरोध हेडर से निगरानी में रखे गए विषयों को ऐक्सेस कर सकते हैं. इसके विकल्प पैरामीटर में {browsingTopics: true}
शामिल होता है या XHR अनुरोध के उसी हेडर से जो deprecatedBrowsingTopics
एट्रिब्यूट को true
पर सेट करता है.
उदाहरण के लिए:
fetch('https://topics-server.glitch.me', {browsingTopics: true})
.then((response) => {
// Process the response
})
एपीआई के साथ काम करने वाले ब्राउज़र में, fetch()
अनुरोध में Sec-Browsing-Topics
हेडर शामिल होगा. इसमें अनुरोध यूआरएल के होस्टनेम के लिए देखे गए विषयों की सूची होगी: इस उदाहरण में, topics-server.glitch.me
.
अगर इस होस्टनेम और इस उपयोगकर्ता के लिए कोई विषय नहीं मिला, तो हेडर शामिल किया जाता है, लेकिन वैल्यू खाली होती है. दूसरे शब्दों में, fetch()
अनुरोध के Sec-Browsing-Topics
हेडर में सिर्फ़ ऐसे विषय शामिल होते हैं जिन्हें मौजूदा उपयोगकर्ता के ब्राउज़र पर उस कॉलर ने देखा है जिसका ऑरिजिन, अनुरोध किए गए यूआरएल के होस्टनेम से मेल खाता है. यह ठीक वैसा ही है जैसे मौजूदा उपयोगकर्ता के लिए निगरानी में रखे गए विषयों को देखने के लिए, iframe से document.browsingTopics()
को कॉल किया जाता था.
अनुरोध के हेडर को तब तक भेजा जाता है, जब तक इसमें अनुमति से जुड़ी सही नीति लागू होती है, कॉन्टेक्स्ट सुरक्षित होता है, और उपयोगकर्ता सेटिंग इसकी अनुमति देती हैं. नेविगेशन के अनुरोधों के लिए हेडर में विषय नहीं दिए जाते.
विषयों के लिए अनुरोध का हेडर इस तरह दिखता है:
Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"
इस उदाहरण में, विषयों की अलग-अलग कैटगरी के दो विषय, 186, और 265 शामिल हैं. साथ ही, हर विषय के वर्शन की जानकारी भी शामिल है.
XHR अनुरोधों में विषय हेडर को शामिल करने की सुविधा सिर्फ़ कुछ समय के लिए उपलब्ध है. साथ ही, आने वाले समय में इसे हटा दिया जाएगा.
Observe-Browsing-Topics
की मदद से, विषयों को 'निगरानी में रखा गया' के तौर पर मार्क करें
अगर किसी अनुरोध में Sec-Browsing-Topics
हेडर शामिल है और उस अनुरोध के जवाब में Observe-Browsing-Topics: ?1
हेडर शामिल है, तो अनुरोध के हेडर में मौजूद विषयों को ब्राउज़र 'निगरानी' के तौर पर मार्क करेगा. जिन विषयों की निगरानी की जा रही है उन्हें Topics API की मदद से कैलकुलेट किया जा सकता है. यह तरीका iframe के JavaScript API का इस्तेमाल करके, दिए गए फ़ंक्शन से मैच करने के लिए डिज़ाइन किया गया है.
नीचे दिए गए स्क्रीनशॉट में, एपीआई डेमो पेज पर साइटों पर जाकर रिकॉर्ड किए गए विषय दिखाए गए हैं.
![glitch.me पर Topics API का डेमो पेज](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/topics-api-demo-page-gli-1a52a773264c2.png?authuser=9&hl=hi)
इस सूची में वे साइटें दिखती हैं जिन पर डेमो देखकर, अपनी पसंद के विषयों को रिकॉर्ड किया जा सकता है. जैसा कि आप देख सकते हैं, कला और स्क्रीनशॉट में दी गई मनोरंजन/हंसी-मज़ाक़ की कैटगरी, इनमें से किसी भी वेबसाइट का विषय नहीं है. इसलिए, रिकॉर्ड किया गया यह विषय ऐसा है जिसे किसी भी पांच प्रतिशत रैंडम विषयों के तौर पर जोड़ा गया है.
- pets-animals-pets-cats.glitch.me
- cats-cats-cats-cats.glitch.me
- cats-pets-animals-pets.glitch.me
- cats-feline-meow-purr-whiskers-pet.glitch.
chrome://topics-internals
पेज के टॉपिक स्टेट टैब पर जाकर देखा जा सकता है कि कौनसे विषय सही हैं और कौनसे रैंडम हैं. इस स्क्रीनशॉट में, अलग-अलग ब्राउज़िंग सेशन का उदाहरण दिया गया है.
![विषयों की स्थिति वाले टैब में, निगरानी किए गए विषयों की जानकारी मिलती है.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/the-topics-state-tab-prov-4a016e2640bad.png?authuser=9&hl=hi)
अगले चरण
अगर आप विज्ञापन टेक्नोलॉजी से जुड़े डेवलपर हैं, तो Topics API के साथ एक्सपेरिमेंट करें और हिस्सा लें. ज़्यादा जानकारी वाले संसाधनों के लिए डेवलपर गाइड पढ़ें.
लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें
- GitHub: Topics API का एक्सप्लेनर पढ़ें. साथ ही, सवाल इकट्ठा करें और एपीआई के डेटा स्टोर करने से जुड़ी समस्याओं पर चर्चा को फ़ॉलो करें.
- W3C: वेब विज्ञापन कारोबार की जगहों के ग्रुप को बेहतर बनाना में, इंडस्ट्री के इस्तेमाल के उदाहरणों पर चर्चा करें.
- एलान: ईमेल पाने वाले लोगों की सूची में शामिल हों या उसे देखें.
- प्राइवसी सैंडबॉक्स डेवलपर सहायता: प्राइवसी सैंडबॉक्स डेवलपर सहायता रेपो पर सवाल पूछें और होने वाली चर्चाओं में शामिल हों.
- Chromium: Chrome में जांच के लिए अभी उपलब्ध लागू किए जाने के बारे में सवाल पूछने के लिए, Chromium बग की फ़ाइल करें.