वेब पर Topics API के लिए सहायता संसाधन

'वेब पर विषय' के लिए, डीबग करने, समस्या हल करने, और सहायता संसाधनों के सुझाव पाएं.

समस्या का हल

अगर हेडर Sec-Browsing-Topics सेट करके document.browsingTopics() कॉल या fetch() अनुरोध किया जाता है, लेकिन जवाब के तौर पर खाली कलेक्शन मिलता है, तो समस्या की मुख्य वजह का पता लगाने के लिए, डीबग करने के कई तरीके अपनाए जा सकते हैं. ये तरीके, आपके लोकल डेवलपमेंट एनवायरमेंट और लाइव सिस्टम, दोनों में काम करते हैं.

स्थानीय तौर पर डीबग करना

अगर स्थानीय तौर पर जांच की जा रही है, तो पक्का करें कि आपने Chrome को ज़रूरी पैरामीटर के साथ चलाया हो.

  • रजिस्टर किए बिना Topics का इस्तेमाल करने के लिए, फ़्लैग chrome://flags/#privacy-sandbox-enrollment-overrides को चालू करें और Topics को कॉल करने वाली साइट का यूआरएल जोड़ें.

  • सुविधा फ़्लैग का इस्तेमाल करके, टेस्टिंग के लिए Topics API को कॉन्फ़िगर करें. इन फ़्लैग की मदद से, आपके पास कुछ पैरामीटर में बदलाव करने का विकल्प होता है. जैसे, एपिक की अवधि, टॉप विषयों की संख्या वगैरह. इससे, Topics की जांच आसानी से की जा सकती है. सुझाई गई सुविधा के इन फ़्लैग का इस्तेमाल किया जा सकता है:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

  • फ़्लैग के साथ Chrome चलाने से पहले, पक्का करें कि आपने Chrome के सभी दूसरे इंस्टेंस और प्रोसेस बंद कर दी हों.

  • सुनिश्चित करें कि:

    • आपके पास Chrome 101 या इसके बाद का वर्शन हो.
    • आपकी स्क्रिप्ट ने Topics API को कॉल किया है, ताकि विषयों को देखा जा सके. जांच करते समय, उन साइटों पर जाकर उपयोगकर्ता के व्यवहार की नकल की जा सकती है जहां आपकी स्क्रिप्ट एम्बेड की गई है. इसका व्यावहारिक उदाहरण देखने के लिए, डेमो देखें.
    • आपके डिवाइस पर कोई विज्ञापन रोकने वाला टूल या ऐसा ही कोई ऐप्लिकेशन या एक्सटेंशन नहीं चल रहा है.
    • आपने गुप्त मोड का इस्तेमाल नहीं किया है.
    • chrome://settings/trackingProtection में, Block all third-party cookies विकल्प बंद है.

लाइव लागू करने की प्रोसेस को डीबग करना

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

  • पक्का करें कि आपकी साइट को Privacy Sandbox में रजिस्टर किया गया हो.
  • अपने फ़्रंटएंड कोड की जांच करके पक्का करें कि आपका JavaScript उम्मीद के मुताबिक काम कर रहा है या नहीं.
  • विषयों के नतीजे पाने के लिए, अपने बैकएंड की जांच करें.
    • यह पक्का करना न भूलें कि डेटा टाइप और बैकएंड एपीआई पैरामीटर सही तरीके से कॉन्फ़िगर किए गए हों.
    • पक्का करें कि आपका बैकएंड, स्केल करने के लिए सही तरीके से कॉन्फ़िगर किया गया हो.
  • हमारे अनुभव के मुताबिक, काम के विषयों के ज़्यादा नतीजे पाने के लिए, कम से कम तीन हफ़्ते इंतज़ार करना ज़रूरी है.
  • सभी उपयोगकर्ताओं के लिए Topics की सुविधा चालू नहीं होगी:
    • उपयोगकर्ता, Topics API को साफ़ तौर पर बंद कर सकते हैं.
    • पब्लिशर के पेज, अनुमतियों की नीति को कंट्रोल कर सकते हैं और अपनी साइटों से ऑप्ट-आउट कर सकते हैं.
  • इस एनवायरमेंट में मेट्रिक और निगरानी की सुविधा जोड़ें: आपको शुरुआती नतीजों का विश्लेषण करने के लिए, इनकी ज़रूरत होगी. उदाहरण के लिए, ये मेट्रिक:
    • कॉल में लगने वाला समय.
    • विषयों के कॉल पर एचटीटीपी से जुड़ी गड़बड़ियां.
  • शुरुआती तीन हफ़्तों के दौरान, लागू करने के तरीके में ज़्यादा बदलाव न करें.

संसाधन