यह पेज TRACIO इंटीग्रेशन के दौरान आने वाली सामान्य समस्याओं और उनके समाधानों को कवर करता है। TRACIO एक मैनेज्ड क्लाउड सेवा है, इसलिए अधिकांश समस्याएँ क्लाइंट-साइड होती हैं (स्क्रिप्ट ब्लॉक होना, कुकीज़, ब्राउज़र की प्राइवेसी सुविधाएँ), न कि इंफ्रास्ट्रक्चर से जुड़ी।
एजेंट स्क्रिप्ट या आइडेंटिफिकेशन रिक्वेस्ट लोड नहीं हो पाती, या ब्राउज़र कंसोल edge.tracio.ai के विरुद्ध CORS त्रुटि दिखाता है।
1. आपकी की के लिए Origin allowlist में नहीं है
प्रत्येक पब्लिक की को अनुमत origins के एक सेट तक सीमित किया जा सकता है। यदि आपकी साइट की origin allowlist में नहीं है, तो एज रिक्वेस्ट को अस्वीकार कर देता है (403)। डैशबोर्ड में Request Filtering के अंतर्गत अपनी origin जोड़ें, या पुष्टि करें कि आप जिस की का उपयोग कर रहे हैं वह किसी अन्य साइट से origin-lock तो नहीं है।
2. Ad blocker या CSP रिक्वेस्ट को ब्लॉक कर रहा है
प्राइवेसी एक्सटेंशन (uBlock Origin, AdBlock) या एक सख्त Content-Security-Policy एजेंट स्क्रिप्ट या उसकी नेटवर्क रिक्वेस्ट को ब्लॉक कर सकते हैं। SDK इसे blocked त्रुटि के रूप में दर्शाता है (Error Handling देखें)। ब्लॉक करना कठिन बनाने के लिए, scriptUrl / endpoint विकल्पों का उपयोग करके एजेंट को first-party सबडोमेन से सर्व करें।
3. गलत endpoint / region
सुनिश्चित करें कि आप सही endpoint की ओर इंगित कर रहे हैं। जब आप region सेट करते हैं, तो SDK edge.us.tracio.ai या edge.eu.tracio.ai से संवाद करता है; सेट न होने पर यह edge.tracio.ai का उपयोग करता है।
लौटने वाले विज़िटर्स के लिए कॉन्फिडेंस स्कोर लगातार 0.90 से नीचे रहते हैं।
1. कुकी परसिस्ट नहीं हो रही
हो सकता है _vid_t कुकी सही तरीके से सेट न हो रही हो। ब्राउज़र में जाँचें:
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))यदि कुकी मौजूद नहीं है, तो नीचे दिए गए कुकी परसिस्ट नहीं हो रही अनुभाग को देखें।
2. नया वर्कस्पेस
एकदम नए वर्कस्पेस का विज़िटर डेटाबेस खाली होता है, इसलिए सभी विज़िटर लगभग 0.90 के कॉन्फिडेंस के साथ "नए" के रूप में दिखते हैं। 24–48 घंटों के बाद, लौटने वाले विज़िटर्स को उच्च कॉन्फिडेंस के साथ पहचाना जाता है।
3. Incognito/प्राइवेट ब्राउज़िंग
Incognito मोड में, सत्र समाप्त होने पर कुकीज़ और localStorage साफ़ हो जाते हैं। TRACIO तब केवल सिग्नल-आधारित मैचिंग पर निर्भर हो जाता है, जिसका कॉन्फिडेंस कम होता है (आमतौर पर 0.85–0.95)।
4. आक्रामक anti-fingerprinting वाले ब्राउज़र
Brave, Firefox (strict मोड) और Safari (ITP) कुछ ब्राउज़र सिग्नल को संशोधित या ब्लॉक कर देते हैं। इससे मैचिंग के लिए उपलब्ध सिग्नल सेट कम हो जाता है। TRACIO इन ब्राउज़रों का पता लगाता है और उसके अनुसार कॉन्फिडेंस को समायोजित करता है।
आइडेंटिफिकेशन की जाँच dashboard (Visitors / Events) में करें, या
webhook डिलीवरी पर कार्रवाई करें, जो प्रत्येक इवेंट के लिए
identification.confidence, identification.incognito और bot verdict
वहन करती है।
वैध मानव विज़िटर्स को बॉट के रूप में फ़्लैग किया जाता है।
1. Navigator प्रॉपर्टीज़ को संशोधित करने वाले ब्राउज़र एक्सटेंशन
कुछ प्राइवेसी एक्सटेंशन navigator.userAgent, navigator.platform या अन्य प्रॉपर्टीज़ को संशोधित कर देते हैं। इससे tampering डिटेक्टर ट्रिगर हो सकता है, लेकिन इसे अकेले बॉट डिटेक्शन को ट्रिगर नहीं करना चाहिए।
यह पहचानने के लिए कि कौन-सा डिटेक्टर फ़ायर हुआ, bot.type फ़ील्ड जाँचें:
| bot.type | सामान्य फॉल्स पॉज़िटिव कारण | समाधान |
|---|---|---|
webdriver | ब्राउज़र टेस्टिंग टूल ने navigator.webdriver = true छोड़ दिया | उपयोगकर्ता को टेस्टिंग मोड अक्षम करना चाहिए |
headless | सॉफ़्टवेयर GPU रेंडरिंग वाला VNC/रिमोट डेस्कटॉप | जाँचें कि GPU रेंडरर SwiftShader/llvmpipe तो नहीं है |
unknown | ब्राउज़र एक्सटेंशन से Eval लंबाई विसंगति | एक्सटेंशन की समीक्षा करें |
rateBot | स्वचालित पेज रिफ़्रेशिंग या आक्रामक polling | रिक्वेस्ट आवृत्ति घटाएँ |
2. सॉफ़्टवेयर रेंडरिंग वाले कॉर्पोरेट वातावरण
Citrix, VDI और टर्मिनल सर्वर वातावरण अक्सर सॉफ़्टवेयर GPU रेंडरिंग (SwiftShader, llvmpipe) का उपयोग करते हैं, जो एक headless मार्कर है। यदि आपके उपयोगकर्ता ऐसे वातावरण में काम करते हैं, तो जब webhook headless बॉट प्रकार दिखाए, तब एक नरम नीति लागू करें:
// `event` is the webhook delivery body (/docs/webhooks)if (event.bot.result === "bot" && event.bot.type === "headless") { // Software-GPU (SwiftShader/llvmpipe) VDI users can trip the headless // detector — consider applying a softer policy for these.}3. प्रोडक्शन में स्वचालित टेस्टिंग
यदि आपकी QA टीम प्रोडक्शन के विरुद्ध Selenium/Playwright टेस्ट चलाती है, तो उन्हें सही रूप से बॉट के रूप में पहचाना जाएगा। टेस्ट ट्रैफ़िक के लिए एक अलग की का उपयोग करें।
_vid_t कुकी विज़िट के बीच गायब हो जाती है, जिससे हर विज़िट एक "नए" विज़िटर के रूप में दिखती है।
1. Non-HTTPS साइट
_vid_t कुकी Secure फ़्लैग का उपयोग करती है और केवल HTTPS पर ही सेट होती है। सुनिश्चित करें कि आपकी साइट HTTPS का उपयोग करती है।
2. Cross-site लोडिंग
TRACIO कुकी पर SameSite=Lax सेट करता है। यदि एजेंट को सख्ती से cross-site संदर्भ में लोड किया जाता है, तो कुकी ब्लॉक हो सकती है। एजेंट को first-party सबडोमेन से सर्व करना (scriptUrl / endpoint के माध्यम से) इसे same-site बनाए रखता है।
3. Safari ITP
Safari की Intelligent Tracking Prevention (ITP) क्लाइंट द्वारा सेट की गई कुकीज़ की अवधि सीमित कर सकती है। TRACIO _vid_t को Set-Cookie हेडर के माध्यम से server-side भी जारी करता है और UID को localStorage में मिरर करता है, ताकि कुकी सीमित होने पर भी पहचान बनी रहे।
4. ब्राउज़र द्वारा कुकीज़ साफ़ करना
कुछ ब्राउज़र (Brave, Firefox Focus) सत्र समाप्त होने पर कुकीज़ साफ़ कर देते हैं। आक्रामक प्राइवेसी सेटिंग्स वाले उपयोगकर्ता हमेशा नए विज़िटर के रूप में दिखेंगे।
tracio.getResult() को लौटने में 500ms से अधिक समय लगता है।
1. एज तक धीमा नेटवर्क
अपने क्षेत्रीय एज तक round-trip लेटेंसी जाँचें:
curl -o /dev/null -s -w "DNS: %{time_namelookup}s\nConnect: %{time_connect}s\nTLS: %{time_appconnect}s\nTotal: %{time_total}s\n" https://edge.tracio.ai/health2. सिग्नल संग्रह में बहुत समय लगना
कुछ सिग्नलों के अपने timeout होते हैं। धीमे डिवाइस पर, संग्रह में 200ms+ लग सकता है। जो सिग्नल सबसे अधिक लेटेंसी जोड़ने की संभावना रखते हैं वे हैं ऑडियो फ़िंगरप्रिंट (iOS पर AudioContext सस्पेंडेड), WebRTC/TURN प्रोब, फ़ॉन्ट डिटेक्शन और DRM टाइमिंग। ये timeout द्वारा सीमित हैं और कभी भी अनिश्चित काल तक ब्लॉक नहीं करते।
कुछ सिग्नल non-success स्टेटस लौटाते हैं (उदाहरण के लिए "not available" या "timeout")।
सिग्नल त्रुटियाँ अपेक्षित हैं और इन्हें सुचारू रूप से संभाला जाता है — सिस्टम उपलब्ध सिग्नलों के आधार पर कॉन्फिडेंस को समायोजित करता है। सामान्य उदाहरण: CSP द्वारा canvas ब्लॉक होना, iOS पर AudioContext का timeout, अधिकांश ब्राउज़रों पर WebGPU समर्थित न होना, Chromium के बाहर Client Hints उपलब्ध न होना। जब तक कि महत्वपूर्ण सिग्नल (canvas, WebGL, audio) कई विज़िटर्स में लगातार विफल न हों, तब तक किसी कार्रवाई की आवश्यकता नहीं है।
यदि आपको यहाँ कवर न की गई किसी समस्या का सामना करना पड़े:
debug: true SDK विकल्प के साथ विस्तृत डायग्नोस्टिक्स सक्षम करेंrequestId के साथ सपोर्ट से संपर्क करें