Topics API इंटिग्रेशन गाइड

विज्ञापन टेक्नोलॉजी से जुड़ी कुछ खास टेक्नोलॉजी के इस्तेमाल के लिए, Topics API का इस्तेमाल करने का तरीका जानें.

शुरू करने से पहले

सबसे पहले, Topics API और सेवाओं के बारे में जानें.

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

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

इस सेक्शन में बताया गया है कि अलग-अलग डेवलपर के तौर पर, Topics API को कैसे इस्तेमाल किया जा सकता है.

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

अपने ब्राउज़र में Topics की सुविधा चालू करें

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

  1. chrome://flags/#privacy-sandbox-ads-apis खोलें और प्राइवसी सैंडबॉक्स एपीआई को चालू करें.
  2. (सुझाया गया) ज़रूरत के हिसाब से कॉन्फ़िगर करने के लिए, Topics API से जुड़े पैरामीटर का इस्तेमाल करके, Chromium फ़्लैग की मदद से Chrome को कमांड लाइन से चलाएं.
chrome://flags/#privacy-sandbox-ads-apis पर जाकर, प्राइवसी सैंडबॉक्स के एपीआई को चालू करें.
Privacy Sandbox APIs को चालू करना.

कमांड लाइन से Chrome को चलाकर, Topics सुविधाओं पर आपका ज़्यादा कंट्रोल रखा जा सकता है. उदाहरण के लिए, Topics epoch को सेट किया जा सकता है. साथ ही, एपीआई के व्यवहार को अपनी ज़रूरत के हिसाब से कॉन्फ़िगर किया जा सकता है. यह वह समयसीमा होती है जिसका इस्तेमाल, एपीआई उपयोगकर्ता की दिलचस्पी का पता लगाने के लिए करता है.

ध्यान रखें कि अगर chrome://flags/#privacy-sandbox-ads-apis चालू है, तो यह आपकी कमांड-लाइन epoch सेटिंग को बदल देगा और डिफ़ॉल्ट वैल्यू (फ़िलहाल, एक हफ़्ता) पर वापस आ जाएगा.

Topics API मैकेनिक्स की झलक देखें

chrome://topics-internals टूल का इस्तेमाल करके, आपको स्थानीय तौर पर Topics API मैकेनिक्स की जानकारी मिल सकती है.

chrome://topics-internals पर Topics API पर एक नज़र डालें.
chrome://topics-internals टूल के विषयों की स्टेट टैब.

विज़िट की जाने वाली साइटों के आधार पर क्लासिफ़ायर को स्थानीय रूप से टेस्ट करने के लिए, Topics API Internals टूल का इस्तेमाल करें.

इस टूल की मदद से, इन चीज़ों की समीक्षा की जा सकती है:

  • विषय की स्थिति: मौजूदा उपयोगकर्ता के लिए देखे गए विषय दिखाएं.
  • क्लासिफ़ायर: होस्टनेम के लिए अनुमानित विषयों की झलक देखें.
  • सुविधाएं और पैरामीटर: एपीआई पैरामीटर की वैल्यू देखें, ताकि यह पता लगाया जा सके कि फ़ीचर फ़्लैग सही तरीके से काम कर रहे हैं या नहीं.

इंटरनल टूल से विषयों को डीबग करने का तरीका जानें.

एपीआई, विषयों की जानकारी कैसे दिखाता है

अगर किसी epoch (एक हफ़्ते) के लिए टॉप पांच विषय बनाने के लिए, Chrome में काफ़ी संख्या में निगरानी किए गए विषय मौजूद नहीं हैं, तो Topics API ज़रूरी पांच विषयों को पूरा करने के लिए, किसी भी क्रम में विषय जोड़ देगा. विषय के इंटरनल कॉलम रीयल या रैंडम सेक्शन में होते हैं. इससे पता चलता है कि वह विषय, असल निगरानी पर आधारित था या टॉप पांच पेजों को पूरा करने के लिए, अतिरिक्त रैंडम "पैडिंग" पर आधारित था. इस तरीके के बारे में ज़्यादा जानने के लिए, एक्सप्लेनेशंस में जाएं.

हर epoch के लिए चुना गया विषय, उस समयावधि के लिए उपयोगकर्ता के पांच मुख्य विषयों में से किसी भी क्रम में चुना जाता है. अगर epoch के दौरान ज़्यादा विषय नहीं देखे गए हैं, तो अतिरिक्त विषयों को बिना किसी क्रम के चुना जाएगा और कुल पांच विषय चुने जाएंगे. बिना किसी क्रम के चुने गए इन विषयों को फ़िल्टर किया जा सकता है.

निजता को बेहतर बनाने और यह पक्का करने के लिए कि सभी विषय दिखाए जा सकें, इस बात की 5% संभावना होती है कि किसी epoch के लिए चुने गए विषय को सभी विषयों में से किसी भी क्रम में न चुना जाए, न कि मॉनिटर किए गए विषयों से. ऊपर दिए गए मामले में, बिना किसी क्रम के चुने गए विषयों को फ़िल्टर नहीं किया जा सकता. हालांकि, बहुत कम विषयों को देखा गया है.

विषय चुनने के तरीके के बारे में ज़्यादा जानकारी, विषय की कैटगरी तय करना में उपलब्ध है.

अहम सुझाव

  1. फ़्लैग का इस्तेमाल करके नया Chrome शुरू करने से पहले, पक्का करें कि आपने Chrome की सभी प्रोसेस बंद (और बंद) कर दी हों.
  2. अगर स्थानीय एनवायरमेंट में टेस्ट किया जा रहा है, तो आपको chrome://flags/#privacy-sandbox-ads-apis बंद करना चाहिए. ऐसा इसलिए, क्योंकि यह कमांड-लाइन सेटिंग को बदल देता है और डिफ़ॉल्ट वैल्यू को वापस लागू कर देता है.
  3. Topics ऐप्लिकेशन स्थानीय तौर पर कैसे काम कर रहा है, यह जानने के लिए डीबग पेज का इस्तेमाल करें.
  4. अगर आपका कोई सवाल है, तो जानकारी देने वाले टूल के लिए GitHub से जुड़ी समस्याएं देखें.
  5. अगर एपीआई उम्मीद के मुताबिक काम नहीं करता है, तो समस्या को हल करने के लिए हमारे तरीके आज़माएं.

अपने एमवीपी डिप्लॉयमेंट की योजना बनाएं

Topics API से, उपयोगकर्ता की दिलचस्पी के विषयों को ऐक्सेस किया जा सकता है. इसके लिए, उपयोगकर्ताओं को विज़िट की गई साइटों को ट्रैक करने या नेविगेशन इतिहास की जानकारी ज़ाहिर करने की ज़रूरत नहीं पड़ती.

Topics API कॉलर की मदद से, document.browsingTopics() JavaScript तरीके को कॉल किया जाता है या एचटीटीपी अनुरोध हेडर का इस्तेमाल करके, विषयों को देखा और ऐक्सेस किया जाता है. इस मामले में, आपका कोड और eTLD+1 का जिस कोड से कॉल लिया जाता है वह कॉलर है. Topics API को कॉल करने का मतलब है कि आपने उपयोगकर्ता के ब्राउज़र को यह निर्देश दिया है कि जब वह किसी वेबसाइट पर जाता है, तो वह अपनी दिलचस्पी के विषयों पर नज़र बनाए रखे. इसके बाद, अगले epoch के लिए विषयों की गिनती में इस विज़िट को शामिल किया जाता है.

Topics API को हर कॉलर या कॉल करने के कॉन्टेक्स्ट के हर eTLD+1 के नतीजों को फ़िल्टर करने के लिए डिज़ाइन किया गया है. दूसरे शब्दों में, iframe के ऑरिजिन (JavaScript API का इस्तेमाल करते समय) या फ़ेच के अनुरोध के यूआरएल (हेडर का इस्तेमाल करते समय) को कॉलर माना जाता है और विषयों की गिनती उस कॉलर के हिसाब से की जाती है.

नीचे दिए गए डायग्राम में यह तरीका दिखाया गया है:

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

इस डायग्राम में:

  1. कोई उपयोगकर्ता Chrome खोलता है और ऐसी कई वेबसाइटों (customerA.example, customerB.example.br वगैरह) पर जाता है, जिनमें आपकी विज्ञापन तकनीक का iframe (स्रोत: iframe.adtech.example) या फ़ेच कॉल पास करने वाले हेडर शामिल होते हैं.
    • Chrome इस उपयोगकर्ता की पसंद के विषयों को रिकॉर्ड करेगा.
  2. Topics API की मदद से, सात दिनों तक नेविगेट करने के बाद, उसी डिवाइस का इस्तेमाल करने वाला उपयोगकर्ता अपनी पसंद के विषयों की वेबसाइट पर जाता है. इस तरह, वह उपयोगकर्ता किसी टारगेट वेबसाइट (publisher-e.example) पर जाता है. Topics API, विषयों की सूची दिखाता है. इस उदाहरण में, इस उपयोगकर्ता की निगरानी के पिछले हफ़्ते का आकलन किया गया एक विषय दिखाया जाएगा.
    • सिर्फ़ दूसरे चरण में, जिन उपयोगकर्ताओं ने adtech.example देखी है उनके ब्राउज़र ही दूसरे चरण में विषय के नतीजे दिखाएंगे. इसे हम निगरानी फ़िल्टर कहते हैं. उपयोगकर्ताओं के ऐसे विषय नहीं देखे जा सकते जिन्हें आपने पहले कभी नहीं देखा.
  3. फ़िलहाल, सिर्फ़ एक विषय के लिए दी गई इस सूची की मदद से, अपने बैक-एंड एपीआई (ads.adtech.example/topics-backend) को कॉल किया जा सकता है, ताकि विषय से जुड़े डेटा को कॉन्टेक्स्ट के डेटासेट के तौर पर इस्तेमाल किया जा सके.
  4. अब आपके इस्तेमाल के उदाहरण के हिसाब से, इस उपयोगकर्ता को पसंद के मुताबिक अनुभव दिया जा सकता है. इसके लिए, पिछले हफ़्तों में आपने इसकी दिलचस्पी के जिन विषयों का इस्तेमाल किया था उन्हें ऐक्सेस किया जा सकता है.

Topics API को कॉल करना

किसी उपयोगकर्ता के लिए विषयों को देखने और उन्हें ऐक्सेस करने के दो तरीके हैं. आप

  • iframe में मौजूद JavaScript एपीआई:
    • टारगेट की गई वेबसाइटों (पब्लिशर की वेबसाइटों) पर ऐसा iframe जोड़ना जिसमें document.browsingTopics() का इस्तेमाल करके Topics API को कॉल करने वाला JavaScript कोड मौजूद है.
  • हेडर का विकल्प:
    • फ़ेच करें (इसका सुझाव दिया जाता है) या XHR (इसका सुझाव नहीं दिया जाता और सिर्फ़ ऑरिजिन ट्रायल के पूरा होने के दौरान ही उपलब्ध था):
      • Sec-Browsing-Topics हेडर से, विज्ञापन टेक्नोलॉजी के बैक एंड के अनुरोधों में विषयों को ऐक्सेस किया जा सकता है. यह सबसे बेहतर परफ़ॉर्म करने वाला विकल्प है. इससे किसी एक उपयोगकर्ता के विषयों को समझने में कम समय लगता है.
    • browsingtopics एट्रिब्यूट के साथ iframe टैग का इस्तेमाल करना:
      • आपके पास browsingtopics एट्रिब्यूट के साथ कोई iframe जोड़ने का विकल्प होता है. साथ ही, Chrome, iframe के अनुरोध के Sec-Browsing-Topics हेडर में विषयों को शामिल करेगा. ये विषय, iframe के eTLD+1 के लिए देखे जाते हैं.

JavaScript और iframes के साथ लागू करना

हमारा सुझाव है कि आप विषय JavaScript API डेमो या हेडर डेमो को आज़माएं और इनमें से किसी एक का इस्तेमाल अपने कोड के शुरुआती पॉइंट के तौर पर करें.

आपके पास एचटीएमएल में <iframe> एलिमेंट शामिल करने या JavaScript के साथ डाइनैमिक तरीके से iframe जोड़ने का विकल्प होता है. डाइनैमिक तौर पर iframe बनाने का एक तरीका यह है: नीचे दिए गए JavaScript का इस्तेमाल करें:

const iframe = document.createElement('iframe');
iframe.setAttribute('src', 'https://...');
document.body.appendChild(iframe);

सुविधा की पहचान करने की सुविधा की मदद से, देखें कि इस डिवाइस पर Topics API काम करता है या नहीं:

'browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics') ?
  console.log('document.browsingTopics() is supported on this page') :
  console.log('document.browsingTopics() is not supported on this page');

उस iframe में Topics API को कॉल करें:

const topics = await document.browsingTopics();

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

एपीआई से क्या दिखाया जाता है, इसका उदाहरण यहां दिया गया है:

[{'configVersion': String, 
  'modelVersion': String, 
  'taxonomyVersion': String, 
  'topic': Number, 
  'version': String}]
  • configVersion: मौजूदा कॉन्फ़िगरेशन की पहचान करने वाली स्ट्रिंग.
  • modelVersion: विषयों का अनुमान लगाने के लिए इस्तेमाल किए जाने वाले मशीन-लर्निंग क्लासिफ़ायर की पहचान करने वाली स्ट्रिंग.
  • taxonomyVersion: इस स्ट्रिंग से ब्राउज़र में ऐसे विषयों के सेट की पहचान की जाती है जिनका फ़िलहाल इस्तेमाल किया जा रहा है.
  • topic: टेक्सॉनमी में विषय की पहचान करने वाली संख्या.
  • version: configVersion और modelVersion को जोड़ने वाली स्ट्रिंग.

लागू करने की इस प्रक्रिया के बारे में ज़्यादा पढ़ें.

एचटीटीपी हेडर के साथ लागू करना

विषयों को फ़ेच()/XHR अनुरोध के Sec-Browsing-Topics हेडर या iframe अनुरोध से ऐक्सेस किया जा सकता है.

विषयों को सेट करने और वापस पाने के लिए अनुरोध और जवाब के हेडर.
iframe और fetch() के लिए हेडर.

अनुरोध के रिस्पॉन्स पर Observe-Browsing-Topics: ?1 हेडर सेट करके, अनुरोध हेडर से मिले विषयों को 'निगरानी' के तौर पर मार्क किया जा सकता है. इसके बाद, ब्राउज़र उन विषयों का इस्तेमाल करके, किसी उपयोगकर्ता की दिलचस्पी के विषयों की गिनती करेगा.

अगर एपीआई एक या उससे ज़्यादा विषय दिखाता है, तो उस eTLD+1 को फ़ेच करने के अनुरोध में Sec-Browsing-Topics हेडर शामिल होगा जिससे विषय देखे गए थे: 

(325);v=chrome.1:1:1, ();p=P000000000

अगर एपीआई से कोई विषय नहीं दिखता, तो हेडर इस तरह दिखता है:

();p=P0000000000000000000000000000000

Sec-Browsing-Topics की हेडर वैल्यू पैड की जाती हैं, ताकि कोई हमलावर, हेडर की लंबाई के आधार पर कॉलर के कई विषयों की जानकारी सीख सके. इस जोखिम को कम किया जा सकता है.

fetch() के साथ लागू करें

पब्लिशर पेज पर, फ़ेच करने के अनुरोध के लिए अपना कोड जोड़ें. साथ ही, {browsingTopics: true} को शामिल करना न भूलें.

fetch('<topics_caller_eTLD+1>', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

एपीआई के साथ काम करने वाले ब्राउज़र में, fetch() अनुरोध में Sec-Browsing-Topics हेडर शामिल होगा. इस हेडर में, अनुरोध यूआरएल के होस्टनेम से जुड़े विषय शामिल होते हैं.

iframe की मदद से लागू करना

fetch() अनुरोध की तरह ही, iframe पर browsingtopics एट्रिब्यूट का इस्तेमाल करने पर Sec-Browsing-Topics हेडर भेजा जाएगा.

<iframe src="<topics_caller_eTLD+1>" browsingtopics></iframe>

इस मामले में, फ़ेच कॉल की तरह ही कॉलर होगा.

सर्वर साइड—सभी मामलों में एक जैसा

ब्राउज़र ने Sec-Browsing-Topics अनुरोध के हेडर में मौजूद विषयों को'निगरानी में रखा है' के तौर पर मार्क किया हो. इसके लिए, सर्वर के रिस्पॉन्स में Observe-Browsing-Topics: ?1 को शामिल करना ज़रूरी है, ताकि उपयोगकर्ता के अगले epoch टॉपिक के कैलकुलेशन में, मौजूदा पेज विज़िट को भी शामिल किया जा सके.

यहां JavaScript का एक उदाहरण दिया गया है, जिसमें setHeader() का इस्तेमाल किया गया है:

res.setHeader('Observe-Browsing-Topics', '?1');

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

विषयों के लिए बैक एंड जोड़ना ज़रूरी नहीं है. आपका चुनाव इस बात पर निर्भर करता है कि उपयोगकर्ता के डिवाइस पर (ब्राउज़र में) आपके दिए गए विषयों का इस्तेमाल कैसे और कहां करना है. 

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

विषयों का इस्तेमाल, काम के डेटा के तौर पर करना

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

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

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

  1. प्रोडक्शन में उपयोगकर्ताओं की निगरानी करके विषय इकट्ठा करें—अभी तक स्केल नहीं किया गया (अनुमानित समय: करीब एक हफ़्ता)
    1. अपने विकल्पों को समझें: iframe और JavaScript या एचटीटीपी हेडर
    2. iframe का डोमेन तय करें.
    3. डेमो ऐप्लिकेशन का कोड संदर्भ के रूप में इस्तेमाल करके JavaScript कोड बनाएं — या हेडर विकल्प लागू करें.
    4. अपने कंट्रोल एनवायरमेंट (कुछ प्रोडक्शन साइटों) पर विषयों को डिप्लॉय करें.
    5. कुछ टारगेट साइटों में विषय लागू करने की सुविधा जोड़ें (इस समय पांच से ज़्यादा साइटों में नहीं).
    6. फ़ंक्शन की जांच और पुष्टि करना.
  2. [ज़रूरी नहीं] Topics डेटा का इस्तेमाल, कॉन्टेक्स्ट के हिसाब से सिग्नल के तौर पर करें. जैसे, यूआरएल, टैग वगैरह के साथ (अनुमानित समय: करीब तीन दिन).
    1. विषयों की सूची मिलने के बाद, उसे अपने जवाब में काम के दूसरे सिग्नल के साथ भेजा जा सकता है.

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

अब आपके पास कोड है, इसलिए इसे पहले टेस्ट के लिए कुछ टारगेट साइटों में जोड़ते हैं. साथ ही, यह भी पक्का करते हैं कि एपीआई स्टेबल है और इस कंट्रोल एनवायरमेंट में काम कर रहा है.

हमारा सुझाव है कि आप ऐसी टारगेट वेबसाइटें चुनें जो:

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

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

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

  • अगर पिछले सात दिनों में इस साइट और कॉलर के लिए, यह डिवाइस पहली कॉल है, तो विषयों का कलेक्शन खाली है. [].
  • शून्य से तीन विषयों की सूची, जो इस उपयोगकर्ता की रुचियों को दिखाती है.
  • सात दिनों की निगरानी के बाद, आपको यह जानकारी मिलेगी:
    • एक विषय, जो उस हफ़्ते के नेविगेशन इतिहास के आधार पर उस उपयोगकर्ता की दिलचस्पी की जानकारी देता है.
      • एक ज़रूरी जानकारी: अगर Topics API के लिए किसी उपयोगकर्ता ने आपके हिसाब से ज़रूरत के मुताबिक विषय नहीं देखे हैं, तो उस हफ़्ते के पांच टॉप विषयों की गिनती करने के लिए, Topics किसी भी क्रम में जितने चाहें उतने विषय जोड़ देगा. एपीआई के बारे में ज़्यादा जानकारी पाएं.
  • अगर आपने चार हफ़्तों की निगरानी के बाद इस विषय को कॉल किया है, तो तीन में से किसी एक विषय को नई एंट्री दिखेगी.
    • ऐसा इसलिए होता है, क्योंकि Topics API आने वाले हफ़्तों तक स्थिर रहेगा और उपयोगकर्ताओं की दिलचस्पी के बारे में ज़्यादा जानकारी नहीं देगा. GitHub पर ज़्यादा जानकारी पाएं.
  • अगर आपने उपयोगकर्ता के किसी विषय के बारे में तीन हफ़्तों से ज़्यादा समय से निगरानी नहीं की है, तो Topics API फिर से खाली अरे [] दिखाएगा.

उपयोगकर्ता अनुभव की परफ़ॉर्मेंस और मेट्रिक को मेज़र करें.

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

समस्या हल करना

मैं Topics API को कॉल कर रहा/रही हूं, लेकिन मुझे कोई नतीजा नहीं मिल रहा है. ऐसे में, मुझे क्या करना होगा?
किसी उपयोगकर्ता की जानकारी को मॉनिटर करने के पहले हफ़्ते के अंदर, Topics API पर कॉल करने पर, आपको ऐसा करना चाहिए.

अहम सुझाव

  1. अपने फ़्रंट-एंड कोड की जांच करके पक्का करें कि आपकी JavaScript उम्मीद के मुताबिक काम कर रही है.

  2. विषयों के नतीजे पाने के लिए, अपने बैक एंड की जांच करें.

    1. यह पक्का करें कि डेटा टाइप और बैक-एंड एपीआई पैरामीटर सही तरीके से कॉन्फ़िगर किए गए हों.
    2. पक्का करें कि आपके बैक एंड को सही तरीके से स्केल करने के लिए कॉन्फ़िगर किया गया हो.

  3. हमारे अनुभव के मुताबिक, ज़्यादा काम के विषय के नतीजे पाने से पहले, आपको कम से कम तीन हफ़्ते का समय देना होगा.

  4. सभी उपयोगकर्ताओं के लिए विषय की सुविधा चालू नहीं होगी:

    1. लोग Topics API को साफ़ तौर पर बंद कर सकते हैं.
    2. पब्लिशर के पेज, अनुमतियों से जुड़ी नीति को कंट्रोल कर सकते हैं. Topics API डेवलपर गाइड में, (ऑप्ट-आउट) करने का तरीका देखें.
    3. ज़्यादा जानकारी के लिए, chromestatus.com पर जाएं.

  5. इस एनवायरमेंट में मेट्रिक और निगरानी की क्षमता जोड़ें: आपको पहले नतीजों का विश्लेषण करने के लिए उनकी ज़रूरत होगी. मेट्रिक के उदाहरण:

    1. कॉल के इंतज़ार का समय;
    2. विषयों के कॉल में एचटीटीपी की गड़बड़ियां;

  6. कोशिश करें कि शुरुआत के तीन हफ़्तों में, लागू करने में होने वाले बदलावों को सीमित किया जाए.

प्रोडक्शन टू प्रोडक्शन

प्रोडक्शन ट्रैक पर विज्ञापन बनाने के बारे में सिलसिलेवार तरीके से खास जानकारी यहां दी गई है. चरणों से जुड़ी ज़्यादा जानकारी नीचे दी गई है.

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

लागू करने का दायरा बढ़ाएं

ऐसे में, आपके पास सुरक्षित माहौल में कुछ साइटों से, विषयों से जुड़ा डेटा इकट्ठा करने का विकल्प होना चाहिए. इस डेटा को पूरा करने के बारे में ज़्यादा भरोसेमंद तरीके से पता चलना चाहिए.

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

हमारा सुझाव है कि आप:

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

लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें