Topics API का सेटअप

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

ऐप्लिकेशन को स्थानीय तौर पर बनाएं और टेस्ट करें

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

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

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

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

अहम सुझाव

  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 चालू किया गया विज्ञापन के एपीआई चालू करता है: एट्रिब्यूशन रिपोर्टिंग, सुरक्षित दर्शक, विषय, फ़ेंस किए गए फ़्रेम.
PrivacySandboxSettings4 बंद है प्राइवसी सैंडबॉक्स की यूज़र इंटरफ़ेस (यूआई) सेटिंग की चौथी रिलीज़ को चालू करती है.
OverridePrivacySandboxSettingsLocalTesting चालू किया गया अगर यह सेटिंग चालू है, तो प्राइवसी सैंडबॉक्स की सुविधाओं को चालू करने के लिए, ब्राउज़र में पहले से मौजूद सेटिंग को चालू करने की ज़रूरत नहीं होगी.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck बंद है अगर यह सेटिंग चालू है, तो विषयों के हिसाब से रैंक तय करने के लिए, यह जांच नहीं की जाएगी कि आईपी पता सार्वजनिक तौर पर रूट किया जा सकता है या नहीं.
BrowsingTopics:number_of_epochs_to_expose 3 अनुरोध किए गए कॉन्टेक्स्ट के लिए, विषयों का हिसाब लगाने के क्रम से epoch की संख्या. ब्राउज़र अंदरूनी तौर पर, N+1 ऐप्स तक सेव रखेगा.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s हर epoch का कुल समय. डीबग करने के लिए, इसे डिफ़ॉल्ट सात दिनों के बजाय 15 सेकंड पर सेट करने से मदद मिल सकती है.
BrowsingTopics:number_of_top_topics_per_epoch 5 हर epoch के हिसाब से कैलकुलेट किए गए विषयों की संख्या.
BrowsingTopics:use_random_topic_probability_percent 5 इस बात की संभावना कि किसी epoch में मौजूद कोई विषय, विषयों की सभी कैटगरी से बिना किसी क्रम के मिला है. रैंडमिटी, किसी खास समय और साइट के लिए तय होती है.
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 को अपडेट किए बिना कॉन्फ़िगरेशन पैरामीटर को अपडेट करना, स्थानीय जांच के लिए ठीक होता है. हालांकि, कुछ स्थितियों में ब्राउज़र के काम न करने की वजह से, ब्राउज़र क्रैश हो सकता है. जैसे, number_of_top_topics_per_epoch को अपडेट करना.
BrowsingTopics:taxonomy_version 1 एपीआई का इस्तेमाल करने वाला टैक्सोनमी वर्शन.

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

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

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

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

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