Bu sayfa, TRACIO entegrasyonu sırasında karşılaşılan yaygın sorunları ve bunların çözümlerini ele alır. TRACIO yönetilen bir bulut hizmetidir, bu nedenle sorunların çoğu altyapı kaynaklı değil, istemci tarafında (betik engellendi, çerezler, tarayıcının gizlilik özellikleri) gerçekleşir.
Agent betiği veya tanımlama isteği yüklenemez ya da tarayıcı konsolu edge.tracio.ai için bir CORS hatası gösterir.
1. Origin, anahtarınız için izin listesinde değil
Her genel anahtar, izin verilen origin kümesiyle sınırlandırılabilir. Sitenizin origin'i izin listesinde değilse, edge isteği reddeder (403). Origin'inizi panodaki Request Filtering altına ekleyin veya kullandığınız anahtarın farklı bir siteye origin-kilitli olmadığından emin olun.
2. Reklam engelleyici veya CSP isteği engelliyor
Gizlilik uzantıları (uBlock Origin, AdBlock) veya katı bir Content-Security-Policy, agent betiğini ya da onun ağ isteğini engelleyebilir. SDK bunu bir blocked hatası olarak sunar (bkz. Hata Yönetimi). Engellemeyi zorlaştırmak için, scriptUrl / endpoint seçeneklerini kullanarak agent'ı bir first-party alt alan adından sunun.
3. Yanlış endpoint / bölge
Doğru endpoint'i hedeflediğinizden emin olun. region ayarladığınızda SDK, edge.us.tracio.ai veya edge.eu.tracio.ai ile konuşur; ayarlanmadığında edge.tracio.ai kullanır.
Güven skorları, geri dönen ziyaretçiler için sürekli olarak 0.90'ın altında.
1. Çerez kalıcı olmuyor
_vid_t çerezi doğru şekilde ayarlanmıyor olabilir. Tarayıcıda kontrol edin:
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))Çerez eksikse, aşağıdaki Çerez Kalıcı Olmuyor bölümüne bakın.
2. Yeni çalışma alanı
Yepyeni bir çalışma alanının ziyaretçi veritabanı boştur, bu yüzden tüm ziyaretçiler yaklaşık 0.90 güvenle "yeni" olarak görünür. 24-48 saat sonra, geri dönen ziyaretçiler daha yüksek güvenle tanınır.
3. Gizli/özel tarama
Gizli modda, oturum sona erdiğinde çerezler ve localStorage temizlenir. TRACIO, daha düşük güvene sahip olan (tipik olarak 0.85-0.95) yalnızca sinyal tabanlı eşleştirmeye geri döner.
4. Agresif anti-fingerprinting özelliğine sahip tarayıcılar
Brave, Firefox (katı mod) ve Safari (ITP), bazı tarayıcı sinyallerini değiştirir veya engeller. Bu, eşleştirme için kullanılabilir sinyal kümesini azaltır. TRACIO bu tarayıcıları algılar ve güveni buna göre ayarlar.
Tanımlamayı panoda (Visitors / Events) inceleyin veya her olay için
identification.confidence, identification.incognito ve bot verdiktini taşıyan
webhook teslimatı üzerinden işlem yapın.
Meşru insan ziyaretçiler bot olarak işaretleniyor.
1. Navigator özelliklerini değiştiren tarayıcı uzantıları
Bazı gizlilik uzantıları navigator.userAgent, navigator.platform veya diğer özellikleri değiştirir. Bu, kurcalama (tampering) algılayıcısını tetikleyebilir, ancak tek başına bot algılamayı tetiklememelidir.
Hangi algılayıcının devreye girdiğini belirlemek için bot.type alanını kontrol edin:
| bot.type | Yaygın Yanlış Pozitif Nedeni | Çözüm |
|---|---|---|
webdriver | Tarayıcı test aracı navigator.webdriver = true bıraktı | Kullanıcı test modunu devre dışı bırakmalı |
headless | Yazılımsal GPU işleme yapan VNC/uzak masaüstü | GPU işleyicisinin SwiftShader/llvmpipe olup olmadığını kontrol edin |
unknown | Tarayıcı uzantısından kaynaklanan eval uzunluğu anomalisi | Uzantıyı gözden geçirin |
rateBot | Otomatik sayfa yenileme veya agresif polling | İstek sıklığını azaltın |
2. Yazılımsal işleme kullanan kurumsal ortamlar
Citrix, VDI ve terminal sunucu ortamları genellikle yazılımsal GPU işleme (SwiftShader, llvmpipe) kullanır ve bu bir headless işaretçisidir. Kullanıcılarınız bu ortamlarda çalışıyorsa, webhook headless bot türü gösterdiğinde daha yumuşak bir politika uygulayın:
// `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. Üretimde otomatik test
QA ekibiniz üretime karşı Selenium/Playwright testleri çalıştırıyorsa, bunlar doğru bir şekilde bot olarak algılanır. Test trafiği için ayrı bir anahtar kullanın.
_vid_t çerezi ziyaretler arasında kayboluyor ve her ziyaretin "yeni" bir ziyaretçi olarak görünmesine neden oluyor.
1. HTTPS olmayan site
_vid_t çerezi Secure bayrağını kullanır ve yalnızca HTTPS üzerinden ayarlanır. Sitenizin HTTPS kullandığından emin olun.
2. Çapraz site yükleme
TRACIO çerez üzerine SameSite=Lax ayarlar. Agent kesinlikle çapraz site bir bağlamda yüklenirse, çerez engellenebilir. Agent'ı bir first-party alt alan adından sunmak (scriptUrl / endpoint aracılığıyla) onu aynı site (same-site) tutar.
3. Safari ITP
Safari'nin Intelligent Tracking Prevention (ITP) özelliği, istemci tarafında ayarlanan çerezlerin ömrünü sınırlayabilir. TRACIO ayrıca _vid_t çerezini Set-Cookie başlığı aracılığıyla sunucu tarafında da yayınlar ve UID'yi localStorage'a yansıtır, böylece çerez sınırlandırılsa bile kimlik korunur.
4. Tarayıcının çerezleri temizlemesi
Bazı tarayıcılar (Brave, Firefox Focus) oturum sonunda çerezleri temizler. Agresif gizlilik ayarlarına sahip kullanıcılar her zaman yeni ziyaretçi olarak görünür.
tracio.getResult() sonuç döndürmesi 500ms'den fazla sürüyor.
1. Edge'e yavaş ağ
Bölgesel edge'inize gidiş-dönüş gecikmesini kontrol edin:
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. Sinyal toplama çok uzun sürüyor
Bazı sinyallerin zaman aşımı vardır. Yavaş cihazlarda toplama 200ms+ sürebilir. Gecikme eklemesi en olası sinyaller şunlardır: ses parmak izi (iOS'ta AudioContext askıya alınmış), WebRTC/TURN sondası, yazı tipi algılama ve DRM zamanlaması. Bunlar zaman aşımlarıyla sınırlıdır ve asla süresiz olarak engellemez.
Bazı sinyaller başarısız bir durum döndürür (örneğin "not available" veya "timeout").
Sinyal hataları beklenir ve zarif bir şekilde ele alınır — sistem, mevcut sinyallere göre güveni ayarlar. Yaygın örnekler: CSP tarafından engellenen canvas, iOS'ta AudioContext zaman aşımı, çoğu tarayıcıda desteklenmeyen WebGPU, Chromium dışında kullanılamayan Client Hints. Kritik sinyaller (canvas, WebGL, audio) birçok ziyaretçide sürekli olarak başarısız olmadıkça herhangi bir işlem gerekmez.
Burada ele alınmayan bir sorunla karşılaşırsanız:
debug: true SDK seçeneğiyle ayrıntılı tanılamayı etkinleştirinrequestId değeriyle destek ekibiyle iletişime geçin