Topics API डेमो

एक्सपेरिमेंट करें और जानें कि कम से कम सेटअप के साथ होस्टनेम से विषयों का अनुमान कैसे लगाया जाता है.

लागू किए जाने की स्थिति

Topics API डेमो की मदद से, होस्टनेम से विषयों का अनुमान लगाने का तरीका पता चलता है. किसी डेमो साइट पर जाकर, यह देखा जा सकता है कि उसमें कौनसे विषय देखे गए हैं. इसके लिए, बहुत कम सेटअप की ज़रूरत होती है.

हमारे डेमो में Topics API की ज़्यादातर सुविधाओं की झलक दिखाई गई है. इससे, आपको एपीआई लागू करने के तरीके के बारे में पूरी जानकारी मिल जाएगी.

विषयों को कैटगरी तय करने वाला मॉडल आज़माने के लिए, विषयों का कोलैब भी चलाया जा सकता है.

नीचे दिए गए वीडियो में डेमो के काम करने का तरीका बताया गया है.

chrome://flags या फ़ीचर फ़्लैग की मदद से जांच करें

एक उपयोगकर्ता के तौर पर Topics API को आज़माने के दो तरीके हैं; आपके पास Chrome 101 या इसके बाद का वर्शन होना चाहिए:

  • chrome://flags/#privacy-sandbox-ads-apis Chrome पेज में जाकर, एपीआई चालू करें:

    chrome://flags/#privacy-sandbox-ads-apis पेज का इस्तेमाल करके Topics API को चालू करें
    chrome://flags/#privacy-sandbox-ads-apis पेज, जहां एपीआई को चालू या बंद किया जा सकता है.

  • कमांड लाइन से, इन फ़्लैग की मदद से 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() का इस्तेमाल करने के बजाय, एपीआई कॉलर fetch() अनुरोध के 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 हेडर में सिर्फ़ ऐसे विषय शामिल होते हैं जिन्हें मौजूदा उपयोगकर्ता के ब्राउज़र पर किसी ऐसे कॉलर ने देखा है जिसका ऑरिजिन, अनुरोध यूआरएल के होस्टनेम से मेल खाता है. यह ठीक वैसे ही होता है, जैसे कि मौजूदा उपयोगकर्ता के मॉनिटर किए गए विषयों को देखने के लिए, document.browsingTopics() को iframe से कॉल किया जाता है.

अनुरोध का हेडर तब तक ही भेजा जाता है, जब तक उसके पास उचित अनुमति नीति चल रही हो, संदर्भ सुरक्षित हो, और उपयोगकर्ता सेटिंग इसकी अनुमति देती हो. नेविगेशन के अनुरोधों के लिए, हेडर में विषय नहीं दिए गए हैं.

विषय अनुरोध का हेडर कुछ ऐसा दिखता है:

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 का इस्तेमाल करके एक्सपेरिमेंट करें और इसमें हिस्सा लें. ज़्यादा जानकारी वाले संसाधनों के लिए डेवलपर गाइड पढ़ें.

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