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

इस पेज में 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 का इस्तेमाल कई तरीकों से किया जा सकता है. इनमें से कुछ तरीकों में, ऑडियंस बनाने के लिए विषयों का इस्तेमाल किया जाता है. वहीं, अन्य तरीकों में मशीन लर्निंग मॉडल को ट्रेन करने के लिए, विषयों को अन्य सिग्नल के साथ इस्तेमाल करने का सुझाव दिया जाता है. इन मॉडल का इस्तेमाल, ऑडियंस की अन्य दिलचस्पी का पता लगाने या बिडिंग लॉजिक को ऑप्टिमाइज़ करने के लिए किया जाएगा.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

प्रोडक्शन तक पहुंच बढ़ाएं

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

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

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

लोड टेस्टिंग

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

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

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

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