यह पेज 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 त्रुटि के रूप में दर्शाता है (त्रुटि प्रबंधन देखें)। ब्लॉक करना कठिन बनाने के लिए, 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 | सामान्य फॉल्स पॉज़िटिव कारण | समाधान |
|---|---|---|
automation | टेस्टिंग टूल ने ब्राउज़र को ऑटोमेशन मोड में छोड़ दिया | टेस्ट रन के बाहर ऑटोमेशन मोड बंद रखें |
headless | बिना असली GPU के रेंडर करता VDI / रिमोट डेस्कटॉप | नीचे "कॉर्पोरेट वातावरण" देखें |
extension | कोई ऑटोमेशन, प्रॉक्सी या VPN ब्राउज़र एक्सटेंशन सक्रिय है | एक्सटेंशन की समीक्षा करें |
other | कोई अनिर्दिष्ट ऑटोमेशन संकेतक फ़ायर हुआ | श्रेणी जानने के लिए reasons (Business+) देखें |
Business और Enterprise प्लान पर, webhook का reasons ऐरे बताता है कि निर्णय के पीछे किस श्रेणी का
अवलोकन था — फॉल्स पॉज़िटिव समझने का यह सबसे तेज़ रास्ता है। देखें
रीज़न कोड।
2. सॉफ़्टवेयर रेंडरिंग वाले कॉर्पोरेट वातावरण
Citrix, VDI और टर्मिनल सर्वर वातावरण बिना असली GPU के रेंडर करते हैं, जो headless रनटाइम जैसा दिखता
है। यदि आपके उपयोगकर्ता ऐसे वातावरण में काम करते हैं, तो जब webhook headless बॉट प्रकार दिखाए, तब
एक नरम नीति लागू करें:
// `event` is the webhook delivery body (/docs/webhooks)if (event.bot?.result === "bot" && event.bot.type === "headless") { // VDI and remote-desktop users render without a real GPU and can trip the // headless classification — 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() को लौटने में आपके अन्य टेस्ट डिवाइस और नेटवर्क की तुलना में
साफ़ तौर पर अधिक समय लगता है।
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 से सीमित है, इसलिए संग्रह कभी भी अनिश्चित काल तक ब्लॉक नहीं करता — जिस जाँच का समय समाप्त हो जाता है, उसे बस अनुपलब्ध बता दिया जाता है और पहचान उसके बिना आगे बढ़ जाती है।
पहचान पूरी हो जाती है, लेकिन किसी विशेष ब्राउज़र या डिवाइस श्रेणी पर कॉन्फिडेंस अपेक्षा से कम रहता है।
हर जाँच हर वातावरण में नहीं चल सकती: सख़्त CSP, प्लेटफ़ॉर्म की पाबंदियाँ और ब्राउज़र के प्राइवेसी फ़ीचर उनमें से कुछ को अनुपलब्ध कर देते हैं। यह अपेक्षित है और इसे सुचारू रूप से संभाला जाता है — कॉन्फिडेंस उसी से गणना होता है जो वास्तव में एकत्र हुआ, इसीलिए हार्डन किए गए ब्राउज़र सामान्य ब्राउज़र की तुलना में जायज़ तौर पर कम कॉन्फिडेंस के साथ पहचाने जाते हैं।
आपकी ओर से किसी कार्रवाई की आवश्यकता नहीं है। यदि आपके ट्रैफ़िक के बड़े हिस्से में कॉन्फिडेंस लगातार कम
रहता है, तो requestId के साथ सपोर्ट से संपर्क करें — इसका निदान सर्वर-साइड रिकॉर्ड से होता है, ब्राउज़र
से नहीं।
यदि आपको यहाँ कवर न की गई किसी समस्या का सामना करना पड़े:
debug: true SDK विकल्प के साथ विस्तृत डायग्नोस्टिक्स सक्षम करेंrequestId के साथ सपोर्ट से संपर्क करें