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 का डेमो पेज
एपीआई को आज़माने के लिए glitch.me का डेमो.

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

  • 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 पेज के टॉपिक स्टेट टैब पर जाकर देखा जा सकता है कि कौनसे विषय सही हैं और कौनसे रैंडम हैं. इस स्क्रीनशॉट में, अलग-अलग ब्राउज़िंग सेशन का उदाहरण दिया गया है.

विषयों की स्थिति वाले टैब में, निगरानी किए गए विषयों की जानकारी मिलती है.
'विषय की स्थिति' टैब में असली और बिना किसी क्रम के दिखाए गए विषय दिखते हैं.

अगले चरण

अगर आप विज्ञापन टेक्नोलॉजी से जुड़े डेवलपर हैं, तो Topics API के साथ एक्सपेरिमेंट करें और हिस्सा लें. ज़्यादा जानकारी वाले संसाधनों के लिए डेवलपर गाइड पढ़ें.

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