Topics API का सेटअप

Topics API की मदद से, वेब ऐप्लिकेशन का इस्तेमाल, उनकी जांच, और उन्हें डेवलप करने के लिए अपना एनवायरमेंट तैयार करें.

स्थानीय तौर पर बनाना और टेस्ट करना

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

अपने ब्राउज़र में Topics चालू करना

स्थानीय टेस्टिंग के लिए, अपने Chrome इंस्टेंस में Topics API चालू करने के लिए, आपके पास ये दो विकल्प हैं:

  1. chrome://settings/adPrivacy में जाकर, विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करें.
  2. (सुझाया गया) ज़रूरत के मुताबिक कॉन्फ़िगर करने के लिए, Topics API के लिए खास तौर पर बनाए गए पैरामीटर का इस्तेमाल करके, Chromium फ़्लैग के साथ कमांड लाइन से Chrome चलाएं. कमांड लाइन से Chrome चलाकर, आपको Topics की सुविधाओं पर ज़्यादा बेहतर कंट्रोल मिलता है. उदाहरण के लिए, Topics API के लिए, ईपॉक (वह समयावधि जिसका इस्तेमाल एपीआई, उपयोगकर्ता की दिलचस्पी का हिसाब लगाने के लिए करता है) सेट किए जा सकते हैं. साथ ही, अपनी ज़रूरतों के हिसाब से एपीआई के व्यवहार को कॉन्फ़िगर किया जा सकता है.

अहम सुझाव

  1. झंडों का इस्तेमाल करके नई प्रोसेस शुरू करने से पहले, पक्का करें कि आपने Chrome की सभी प्रोसेस बंद कर दी हों.
  2. पक्का करें कि chrome://settings/adPrivacy में, विज्ञापन के लिए निजता बनाए रखने से जुड़े सभी एपीआई चालू हों.
  3. अगर एपीआई उम्मीद के मुताबिक काम नहीं करता है, तो समस्या हल करने के लिए दिए गए सुझाव आज़माएं.
  4. अगर आपका कोई सवाल है, तो एक्सप्लेनर के लिए GitHub की समस्याएं देखें.

Chrome फ़्लैग की मदद से Topics API को कंट्रोल करना

Chrome फ़्लैग, Topics API के काम करने के तरीके में बदलाव कर सकते हैं. टेस्टिंग को आसान बनाने के लिए, कमांड लाइन से Chrome को उन पैरामीटर के साथ चलाएं जो आपने तय किए हैं. उदाहरण के लिए, हेडर डेमो में इन फ़्लैग का इस्तेमाल करने का सुझाव दिया गया है:

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

यहां दी गई टेबल में, हर पैरामीटर, उसकी डिफ़ॉल्ट वैल्यू, और उसके मकसद के बारे में बताया गया है.

फ़्लैग का नाम डिफ़ॉल्ट मान ब्यौरा
BrowsingTopics चालू किया गया Topics API चालू है या नहीं.
PrivacySandboxAdsAPIsOverride चालू किया गया यह विज्ञापनों से जुड़े इन एपीआई को चालू करता है: Attribution Reporting, Protected Audience, Topics, और Fenced Frames.
PrivacySandboxSettings4 बंद है इस कुकी से, Privacy Sandbox की यूज़र इंटरफ़ेस (यूआई) सेटिंग की चौथी रिलीज़ चालू होती है.
OverridePrivacySandboxSettingsLocalTesting चालू किया गया इस सुविधा के चालू होने पर, ब्राउज़र को Privacy Sandbox की सुविधाएं चालू करने के लिए, बुनियादी सेटिंग चालू करने की ज़रूरत नहीं होती.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck बंद है अगर यह सेटिंग चालू है, तो विषय के हिसाब से पेज को शामिल करने की ज़रूरी शर्तें तय करते समय, यह जांच नहीं की जाएगी कि आईपी पता सार्वजनिक तौर पर रूट किया जा सकता है या नहीं.
BrowsingTopics:number_of_epochs_to_expose 3 उन इपॉकों की संख्या जहां से अनुरोध करने वाले कॉन्टेक्स्ट को दिए जाने वाले विषयों का हिसाब लगाया जाता है. ब्राउज़र, अंदरूनी तौर पर N+1 युगों तक डेटा को सेव रखेगा.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s हर युग की अवधि. डीबग करने के लिए, इसे डिफ़ॉल्ट रूप से सात दिन के बजाय 15 सेकंड पर सेट करना फ़ायदेमंद हो सकता है.
BrowsingTopics:number_of_top_topics_per_epoch 5 हर युग के हिसाब से कैलकुलेट किए गए विषयों की संख्या.
BrowsingTopics:use_random_topic_probability_percent 5 इस बात की संभावना कि किसी युग में कोई विषय, विषयों की पूरी टैक्सोनॉमी से रैंडम तरीके से चुना गया है. रैंडमनेस, एक इपोक और साइट के लिए एक जैसी होती है.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 एपीआई के इस्तेमाल से जुड़े डेटा (यानी कि विषयों से जुड़ी जानकारी) के कितने इपोक का इस्तेमाल, कॉलिंग कॉन्टेक्स्ट के लिए विषयों को फ़िल्टर करने के लिए किया जाएगा.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 हर मुख्य विषय के लिए, कॉन्टेक्स्ट डोमेन के तौर पर देखे गए डोमेन की ज़्यादा से ज़्यादा संख्या. इस इंटेंट का मकसद, इस्तेमाल की जा रही मेमोरी को सीमित करना है.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 एपीआई के इस्तेमाल के संदर्भों के लिए, हर क्वेरी के लिए डेटाबेस से ज़्यादा से ज़्यादा कितनी एंट्री वापस लाई जा सकती हैं. विषयों का हिसाब लगाने के दौरान, हर युग में एक बार क्वेरी की जाएगी. इसका मकसद, मेमोरी के इस्तेमाल की सीमा तय करना है.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 हर पेज लोड पर, एपीआई के इस्तेमाल के कॉन्टेक्स्ट डोमेन की ज़्यादा से ज़्यादा संख्या को सेव करने की अनुमति है.
BrowsingTopics:config_version 1 यह कुकी, Topics API के कॉन्फ़िगरेशन पैरामीटर को कोड में बदलती है. हर वर्शन नंबर को सिर्फ़ एक कॉन्फ़िगरेशन सेट से मैप किया जाना चाहिए. आम तौर पर, लोकल टेस्टिंग के लिए config_version को अपडेट किए बिना कॉन्फ़िगरेशन पैरामीटर अपडेट करना ठीक होता है. हालांकि, कुछ मामलों में इससे ब्राउज़र की स्थिति ठीक नहीं रहती और ब्राउज़र क्रैश हो सकता है. उदाहरण के लिए, config_version को अपडेट करना.number_of_top_topics_per_epoch
BrowsingTopics:taxonomy_version 1 एपीआई के लिए इस्तेमाल किया गया टैक्सोनॉमी वर्शन.

लागू करने से पहले

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

  1. डेवलपर के लिए उपलब्ध दस्तावेज़ देखें:
    1. Topics API के मकसद और दिलचस्पी के हिसाब से विज्ञापन दिखाने में इसकी भूमिका के बारे में जानें
    2. जानें कि वेब पर विषय के हिसाब से विज्ञापन दिखाने की सुविधा कैसे काम करती है.
    3. डेमो आज़माएं. साथ ही, विषयों के डेमो, Colab, और टूल का वॉकट्रू वीडियो देखें.
    4. डेमो को फ़ोर्क करें और उन्हें अपनी साइट से चलाएं.
    5. ज़्यादा जानकारी के लिए, एपीआई के बारे में जानकारी देने वाला लेख पढ़ें.
  2. अगर आने वाले समय में, ज़्यादातर उपयोगकर्ताओं के लिए तीसरे पक्ष की कुकी उपलब्ध नहीं होंगी, तो विज्ञापन को ज़्यादा काम का बनाने में एपीआई की भूमिका को समझें.
  3. एपीआई में स्थिति के बदलावों के बारे में सूचना पाने के लिए, डेवलपर के लिए ईमेल पाने वाले लोगों की सूची में शामिल हों. साथ ही, Topics API से जुड़े नए अपडेट के बारे में जानने के लिए हमारे साथ बने रहें.
  4. GitHub की समस्याओं या W3C कॉल पर बातचीत में हिस्सा लें.
  5. अगर आपको कुछ ऐसे शब्द दिखते हैं जिनके बारे में आपको नहीं पता, तो Privacy Sandbox की शब्दावली देखें.
  6. Chrome के कॉन्सेप्ट के बारे में ज़्यादा जानने के लिए, goo.gle/cc पर उपलब्ध छोटे वीडियो और लेख देखें. जैसे, Chrome फ़्लैग.

आगे क्या करना होगा

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