विषयों पर आधारित समाधान की जांच करें, उसे डिप्लॉय करें, और उसे बड़े पैमाने पर उपलब्ध कराएं

इस पेज पर, Topics API का इस्तेमाल करके प्रोडक्शन के लिए, किसी सुविधा को बनाने, उसकी जांच करने, और उसे बड़े पैमाने पर लागू करने का तरीका बताया गया है.

विषयों को बैकएंड में लागू करना

बैकएंड को लागू करने का तरीका इस बात पर निर्भर करता है कि आपको ब्राउज़र में कैलकुलेट किए गए विषयों का इस्तेमाल कैसे करना है. हमारा सुझाव है कि विज्ञापन टेक्नोलॉजी से जुड़े समाधान, Topics का इस्तेमाल एक अतिरिक्त IBA सिग्नल के तौर पर करें.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Topics का इस्तेमाल अतिरिक्त सिग्नल के तौर पर करना

विषयों के डेटा को अन्य सिग्नल के साथ इस्तेमाल किया जा सकता है. जैसे, यूआरएल, कीवर्ड या अन्य मेटाडेटा. इससे आपको अपनी ऑडियंस के बारे में ज़्यादा जानकारी मिलती है.

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

बनाना और डिप्लॉय करना

  1. प्रोडक्शन में उपयोगकर्ताओं की गतिविधि के आधार पर विषयों को इकट्ठा करें (लागू करने का अनुमानित समय: करीब एक हफ़्ता):
    • अपने विकल्पों के बारे में जानें: एचटीटीपी हेडर या आईफ़्रेम और JavaScript का इस्तेमाल करके, विषयों को कैसे कॉल करें.
    • उस iframe का डोमेन तय करें जो Topics API को कॉल करेगा.
    • कोड के रेफ़रंस के तौर पर हेडर डेमो या JavaScript डेमो का इस्तेमाल करके, अपना समाधान बनाएं.
    • अपने कोड में Topics को इंटिग्रेट करें. पब्लिशर इस कोड को अपनी साइटों पर एम्बेड करते हैं. उदाहरण के लिए, आपका विज्ञापन iframe. पक्का करें कि आपने एम्बेड किए गए कॉन्टेंट से विषयों को कॉल किया हो.
    • उपयोगकर्ता विषयों को ट्रैक करने के लिए, अपनी प्रोडक्शन वेबसाइटों पर स्क्रिप्ट का नया वर्शन एम्बेड करें. हमारा सुझाव है कि आप इसे उन वेबसाइटों पर लागू करके देखें जिन पर हर महीने कम विज़िट मिलती हैं. इस चरण में, हमारा सुझाव है कि आप विषय के हिसाब से बनाए गए नए समाधान को कम से कम पांच साइटों पर एम्बेड करें.
    • इस समय, एपीआई से नतीजे के तौर पर एक खाली कलेक्शन मिलने की उम्मीद है. ऐसा इसलिए है, क्योंकि उपयोगकर्ता के लिए अब तक कोई विषय नहीं देखा गया है. उपयोगकर्ता के विषयों की जानकारी मिलने में तीन हफ़्ते लग सकते हैं.
    • फ़ंक्शन की जांच और पुष्टि करें. अपने समाधान की जांच मैन्युअल तरीके से या अपने-आप की जा सकती है. उदाहरण के लिए:
      • फ़्लैग के साथ अपना ब्राउज़र खोलें और इपोक को 15 सेकंड पर सेट करें, ताकि ब्राउज़र जल्द ही विषयों का फिर से हिसाब लगा सके.
      • उन साइटों पर जाएं जिन्होंने आपकी स्क्रिप्ट को एम्बेड किया है.
      • देखें कि आपकी स्क्रिप्ट, chrome://topics-internals/ पर विषयों को मॉनिटर कर रही है या नहीं.
      • देखें कि आपको कौनसे नतीजे मिल सकते हैं.
  2. कॉन्टेक्स्ट से जुड़े अन्य सिग्नल (जैसे कि यूआरएल, मेटाडेटा वगैरह) के साथ-साथ, Topics के डेटा का इस्तेमाल करना (अनुमानित समय: करीब तीन दिन).
    • प्रोडक्शन में तीन हफ़्ते पूरे होने के बाद, आपकी स्क्रिप्ट को कुछ उपयोगकर्ताओं के विषयों के बारे में जानकारी मिल जानी चाहिए. इस समय, आपको अतिरिक्त सिग्नल के तौर पर विषय के डेटा का इस्तेमाल करना चाहिए.
    • जब आपको विषयों की ऐसी सूची मिलने लगे जिसमें कुछ न कुछ जानकारी हो, तब उसे कॉन्टेक्स्ट के हिसाब से काम के अन्य सिग्नल के साथ अपने बैकएंड को भेजें.

टारगेट साइटों पर डिप्लॉय करना

अपनी स्क्रिप्ट में Topics API कॉल को इंटिग्रेट करने के बाद, पक्का करें कि इसे पहली बार टेस्ट करने के लिए, कुछ प्रोडक्शन साइटों पर एम्बेड किया गया हो. पक्का करें कि लागू किया गया तरीका उम्मीद के मुताबिक काम कर रहा हो:

  • Topics API को कॉल किया जाता है.
  • इस कंट्रोल किए गए एनवायरमेंट में, विषयों को देखा जा सकता है.
  • विषयों को ऐक्सेस किया जा सकता है. इसका मतलब है कि एपीआई, उपयोगकर्ता के लिए देखे गए विषयों को दिखाता है.

टारगेट साइटें चुनें

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

  • साइट पर हर महीने कम संख्या में विज़िट मिलती हैं (हर महीने करीब दस लाख से कम विज़िट): आपको सबसे पहले, कम संख्या में दर्शकों के लिए एपीआई डिप्लॉय करना चाहिए.
  • आपके पास साइट का मालिकाना हक और कंट्रोल होता है: अगर ज़रूरी हो, तो बिना किसी मुश्किल मंज़ूरी के, इसे तुरंत बंद किया जा सकता है.
  • साइट कारोबार के लिए ज़रूरी नहीं है: कम जोखिम वाली टारगेट साइटों से शुरुआत करें.
  • कुल पांच से ज़्यादा साइटें नहीं: फ़िलहाल, आपको ज़्यादा ट्रैफ़िक या एक्सपोज़र की ज़रूरत नहीं होगी.
  • टारगेट की गई साइटें अलग-अलग थीम के बारे में जानकारी देती हों: ऐसी वेबसाइटें चुनें जो अलग-अलग कैटगरी के बारे में जानकारी देती हों. उदाहरण के लिए, एक खेल-कूद के बारे में, दूसरी खबरों के बारे में, और तीसरी खाने-पीने की चीज़ों के बारे में. Chrome में मौजूद इंटरनल Topics टूल का इस्तेमाल करके, डोमेन की पुष्टि की जा सकती है. साथ ही, यह भी देखा जा सकता है कि Topics मशीन-लर्निंग क्लासिफ़ायर, डोमेन को कैसे कैटगरी में बांटता है.

फ़ंक्शन की जांच और पुष्टि करना

सीमित एनवायरमेंट में Topics API को कॉल करने पर, आपको ये नतीजे मिल सकते हैं:

  • अगर पिछले सात दिनों में, इस डिवाइस से इस साइट और कॉलर के लिए यह पहला कॉल है, तो विषयों का खाली कलेक्शन [].

  • इस उपयोगकर्ता की दिलचस्पी के हिसाब से, शून्य से तीन विषयों की सूची. सात दिनों तक निगरानी करने के बाद, आपको ये चीज़ें मिलेंगी:

    • उपयोगकर्ता के लिए सबसे ज़्यादा ब्राउज़ किए गए पांच विषयों में से चुना गया एक विषय. इसका हिसाब, उन पेजों के होस्टनेम से लगाया जाता है जिन पर कॉलर ने उस हफ़्ते विषयों को देखा है.

  • Topics API के पिछले सभी कॉल की तरह ही, एपीआई से मिला जवाब. कॉल करने वाले व्यक्ति, उपयोगकर्ता, और टॉप-लेवल साइट के लिए, एपीआई पूरे युग के लिए एक ही विषय दिखाएगा. इससे उपयोगकर्ता की बहुत ज़्यादा दिलचस्पी ज़ाहिर नहीं होती. GitHub पर ज़्यादा जानकारी पाएं.

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

  • अगर आपने पिछले तीन हफ़्तों या इससे ज़्यादा समय से उपयोगकर्ता के लिए विषयों को नहीं देखा है, तो Topics API फिर से खाली कलेक्शन [] दिखाएगा.

उपयोगकर्ता अनुभव का आकलन करने के लिए, परफ़ॉर्मेंस मेट्रिक इकट्ठा करें:

  • क्रॉस-ऑरिजिन iframe में Topics API को किए गए JavaScript कॉल के रन टाइम को मेज़र किया जाना चाहिए, ताकि इसका इस्तेमाल परफ़ॉर्मेंस के आने वाले समय के विश्लेषण में किया जा सके.
  • विषय मिलने के बाद, iframe और postMessage() विषयों को बनाने में लगा समय.

समस्या हल करने के लिए, सहायता सेक्शन देखें.

प्रोडक्शन के लिए स्केल करना

इस समय तक, आपको नियंत्रित एनवायरमेंट (आपकी कुछ साइटों पर) में विषय के हिसाब से विज्ञापन दिखाने की सुविधा की जांच कर लेनी चाहिए. अगर सब कुछ उम्मीद के मुताबिक काम करता है, तो अब इस सुविधा को बड़े पैमाने पर लागू करने का समय है. एक ही कोड को ज़्यादा टारगेट वेबसाइटों पर डिप्लॉय करें. इससे आपको ज़्यादा उपयोगकर्ताओं को ट्रैक करने, ज़्यादा विषयों का डेटा इकट्ठा करने, और अपनी ऑडियंस को बेहतर तरीके से समझने में मदद मिलेगी.

यहां प्रोडक्शन के लिए स्केल करने के तरीके के बारे में सिलसिलेवार जानकारी दी गई है:

  1. ज़्यादा ट्रैफ़िक पर, विषयों पर आधारित समाधान को आज़माएं.
    • अपने iframe को उन साइटों पर जोड़ें जिन पर ज़्यादा विज़िट मिलती हैं. इसके बाद, लोड टेस्टिंग करने के लिए यहां दिए गए निर्देशों का पालन करें.
  2. पब्लिशर की साइटों पर अपना समाधान लागू करें.
    • जब आपका समाधान, आपके टेस्ट एनवायरमेंट में सही तरीके से काम करने लगे, तब पब्लिशर के साथ मिलकर काम करें. इससे, उनके साथ अपने iframe को उनकी वेबसाइटों में इंटिग्रेट किया जा सकेगा. उदाहरण के लिए, उन्हें उस लाइब्रेरी को अपडेट करना पड़ सकता है जिसमें आपका iframe शामिल है.
  3. विषयों के डेटा को प्रोसेस करना और उसका इस्तेमाल करना (अनुमानित समय: करीब चार हफ़्ते).
    • अन्य डेटा के साथ-साथ, Topics के डेटा को भी एक अतिरिक्त सिग्नल के तौर पर शामिल करें.
    • रीयल-टाइम बिडिंग की टेस्टिंग करने वाले पार्टनर का सोर्स.
    • अपने अन्य डेटा के साथ-साथ Topics को भी एक अतिरिक्त सिग्नल के तौर पर इस्तेमाल करके, यूटिलिटी टेस्टिंग करें.

लोड टेस्टिंग

हमारा सुझाव है कि पब्लिशर की साइटों पर, विषयों पर आधारित समाधान को डिप्लॉय करने से पहले, लोड टेस्टिंग करें. इससे यह पक्का किया जा सकेगा कि आपका सिस्टम ट्रैफ़िक को मैनेज कर सकता है.

  1. इसे अपनी ज़्यादा टारगेट साइटों पर धीरे-धीरे डिप्लॉय करें. खास तौर पर, उन साइटों पर जहां ट्रैफ़िक ज़्यादा है.
  2. अपने अनुमानित ट्रैफ़िक के हिसाब से, विषयों के डेटा के लिए लोड टेस्टिंग करें.
    • आपको iframe से विषय की जानकारी अपने बैकएंड को भेजनी होगी. इससे, Topics API के नतीजों को आगे प्रोसेस किया जा सकता है. साथ ही, इनका इस्तेमाल अतिरिक्त सिग्नल के तौर पर किया जा सकता है. इससे, ऐसे विज्ञापन चुनने में मदद मिलती है जो उपयोगकर्ता के लिए ज़्यादा काम के हों. ज़्यादा साइटें आपके एम्बेड किए गए कॉन्टेंट को शामिल करेंगी, तो आपके बैकएंड पर कॉल की संख्या काफ़ी बढ़ जाएगी. पुष्टि करें कि आपका बैकएंड, iframe से आने वाली बड़ी संख्या में कॉल को मैनेज कर सकता है.
    • विश्लेषण के लिए, मेट्रिक कलेक्शन और लॉग सेट अप करें.
  3. Topics API को डिप्लॉय करने के तुरंत बाद, अपनी मेट्रिक की जांच करें. इससे असली उपयोगकर्ता से जुड़ी किसी भी गंभीर समस्या का पता लगाया जा सकेगा. अपनी मेट्रिक को समय-समय पर देखते रहें.
  4. अगर कोई रुकावट आती है या कोई समस्या होती है, तो डिप्लॉयमेंट को पहले जैसा करें. साथ ही, समस्या को समझने और उसे ठीक करने के लिए, अपने लॉग का विश्लेषण करें.

इन्हें भी देखें

वेब पर Topics API को बेहतर तरीके से समझने के लिए, हमारे संसाधन देखें.