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ılama sınıfının devreye girdiğini görmek için bot.type alanını kontrol edin (tam sözlük için bkz. Bot türleri):
| bot.type | Yaygın Yanlış Pozitif Nedeni | Çözüm |
|---|---|---|
automation | Bir test aracı tarayıcıyı otomasyon modunda bıraktı | Test çalıştırmaları dışında otomasyon modunu kapatın |
headless | Gerçek bir GPU olmadan işleme yapan VDI / uzak masaüstü | Aşağıdaki "Kurumsal ortamlar" bölümüne bakın |
extension | Otomasyon, proxy veya VPN tarayıcı uzantısı etkin | Uzantıyı gözden geçirin |
other | Ayrıntısı belirtilmeyen bir otomasyon göstergesi devreye girdi | Sınıf için reasons (Business+) alanına bakın |
Business ve Enterprise planlarında webhook'taki reasons dizisi, kararın arkasındaki
gözlem sınıfını adlandırır — yanlış pozitifi anlamanın en hızlı yolu budur. Bkz.
Neden kodları.
2. Yazılımsal işleme kullanan kurumsal ortamlar
Citrix, VDI ve terminal sunucu ortamları gerçek bir GPU olmadan işleme yapar; bu da
headless bir çalışma ortamına benzer. 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") { // VDI and remote-desktop users render without a real GPU and can trip the // headless classification — 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, diğer test cihazlarınıza ve ağlarınıza kıyasla
gözle görülür şekilde daha uzun 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. Toplama çok uzun sürüyor
Daha düşük performanslı cihazlarda toplama daha uzun sürer. Yavaş olabilecek her kontrol kendi zaman aşımıyla sınırlıdır, bu nedenle toplama asla süresiz olarak engellemez — süresi dolan bir kontrol yalnızca kullanılamıyor olarak raporlanır ve tanımlama onsuz devam eder.
Tanımlama tamamlanır, ancak belirli bir tarayıcı veya cihaz sınıfında güven beklenenden düşüktür.
Her kontrol her ortamda çalışamaz: katı CSP, platform kısıtlamaları ve tarayıcının gizlilik özellikleri bunların bir kısmını kullanılamaz hâle getirir. Bu beklenen bir durumdur ve zarif bir şekilde ele alınır — güven, gerçekten toplanabilenlerden hesaplanır; sertleştirilmiş tarayıcıların standart bir tarayıcıya kıyasla meşru biçimde daha düşük güvenle tanımlanmasının nedeni budur.
Sizin tarafınızda herhangi bir işlem gerekmez. Güven, trafiğinizin büyük bir bölümünde
sürekli düşükse, bir requestId ile destek ekibine başvurun — bu, tarayıcıdan değil,
sunucu tarafındaki kayıttan teşhis edilir.
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