Halaman ini membahas masalah umum yang muncul selama integrasi TRACIO beserta solusinya. TRACIO adalah layanan cloud terkelola, sehingga sebagian besar masalah bersifat client-side (skrip diblokir, cookie, fitur privasi browser) dan bukan masalah infrastruktur.
Skrip agen atau permintaan identifikasi gagal dimuat, atau konsol browser menampilkan error CORS terhadap edge.tracio.ai.
1. Origin tidak masuk allowlist untuk key Anda
Setiap public key dapat dikunci ke sekumpulan origin yang diizinkan. Jika origin situs Anda tidak ada dalam allowlist, edge akan menolak permintaan (403). Tambahkan origin Anda di bawah Request Filtering pada dashboard, atau pastikan key yang Anda gunakan tidak dikunci ke origin situs lain.
2. Ad blocker atau CSP memblokir permintaan
Ekstensi privasi (uBlock Origin, AdBlock) atau Content-Security-Policy yang ketat dapat memblokir skrip agen atau permintaan jaringannya. SDK menampilkan ini sebagai error blocked (lihat Error Handling). Untuk mempersulit pemblokiran, sajikan agen dari subdomain first-party menggunakan opsi scriptUrl / endpoint.
3. Endpoint / region salah
Pastikan Anda mengarah ke endpoint yang benar. Saat Anda menetapkan region, SDK berkomunikasi dengan edge.us.tracio.ai atau edge.eu.tracio.ai; jika tidak ditetapkan, ia menggunakan edge.tracio.ai.
Skor confidence secara konsisten di bawah 0,90 untuk pengunjung yang kembali.
1. Cookie tidak persisten
Cookie _vid_t mungkin tidak terpasang dengan benar. Periksa di browser:
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))Jika cookie tidak ada, lihat bagian Cookie Tidak Persisten di bawah.
2. Workspace baru
Workspace yang benar-benar baru memiliki basis data pengunjung yang kosong, sehingga semua pengunjung tampak sebagai "baru" dengan confidence sekitar 0,90. Setelah 24-48 jam, pengunjung yang kembali dikenali dengan confidence yang lebih tinggi.
3. Mode incognito/penjelajahan privat
Dalam mode incognito, cookie dan localStorage dihapus saat sesi berakhir. TRACIO beralih ke pencocokan berbasis sinyal saja, yang memiliki confidence lebih rendah (biasanya 0,85-0,95).
4. Browser dengan anti-fingerprinting agresif
Brave, Firefox (mode ketat), dan Safari (ITP) mengubah atau memblokir sebagian sinyal browser. Hal ini mengurangi kumpulan sinyal yang tersedia untuk pencocokan. TRACIO mendeteksi browser ini dan menyesuaikan confidence sesuai kondisi.
Periksa identifikasi di dashboard (Visitors / Events), atau bertindak berdasarkan
pengiriman webhook, yang membawa identification.confidence,
identification.incognito, dan verdict bot untuk setiap event.
Pengunjung manusia yang sah ditandai sebagai bot.
1. Ekstensi browser yang mengubah properti navigator
Beberapa ekstensi privasi mengubah navigator.userAgent, navigator.platform, atau properti lainnya. Hal ini dapat memicu detektor tampering, tetapi seharusnya tidak memicu deteksi bot dengan sendirinya.
Periksa field bot.type untuk mengidentifikasi detektor mana yang aktif:
| bot.type | Penyebab Umum False Positive | Solusi |
|---|---|---|
webdriver | Alat pengujian browser meninggalkan navigator.webdriver = true | Pengguna harus menonaktifkan mode pengujian |
headless | VNC/remote desktop dengan rendering GPU perangkat lunak | Periksa apakah SwiftShader/llvmpipe adalah renderer GPU |
unknown | Anomali panjang eval dari ekstensi browser | Tinjau ekstensi tersebut |
rateBot | Refresh halaman otomatis atau polling agresif | Kurangi frekuensi permintaan |
2. Lingkungan korporat dengan rendering perangkat lunak
Lingkungan Citrix, VDI, dan terminal server sering menggunakan rendering GPU perangkat lunak (SwiftShader, llvmpipe), yang merupakan penanda headless. Jika pengguna Anda beroperasi di lingkungan ini, terapkan kebijakan yang lebih lunak ketika webhook menunjukkan tipe bot 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. Pengujian otomatis di produksi
Jika tim QA Anda menjalankan pengujian Selenium/Playwright terhadap produksi, pengujian tersebut akan terdeteksi dengan benar sebagai bot. Gunakan key terpisah untuk trafik pengujian.
Cookie _vid_t menghilang di antara kunjungan, sehingga setiap kunjungan tampak sebagai pengunjung "baru".
1. Situs non-HTTPS
Cookie _vid_t menggunakan flag Secure dan hanya dipasang melalui HTTPS. Pastikan situs Anda menggunakan HTTPS.
2. Pemuatan lintas situs
TRACIO menetapkan SameSite=Lax pada cookie. Jika agen dimuat dalam konteks lintas situs yang ketat, cookie dapat diblokir. Menyajikan agen dari subdomain first-party (melalui scriptUrl / endpoint) menjaganya tetap same-site.
3. Safari ITP
Intelligent Tracking Prevention (ITP) pada Safari dapat membatasi masa hidup cookie yang ditetapkan klien. TRACIO juga menerbitkan _vid_t di sisi server melalui header Set-Cookie dan mencerminkan UID ke localStorage, sehingga identitas tetap bertahan bahkan saat cookie dibatasi.
4. Browser menghapus cookie
Beberapa browser (Brave, Firefox Focus) menghapus cookie saat sesi berakhir. Pengguna dengan pengaturan privasi agresif akan selalu tampak sebagai pengunjung baru.
tracio.getResult() membutuhkan lebih dari 500ms untuk mengembalikan hasil.
1. Jaringan lambat ke edge
Periksa latensi round-trip ke edge regional Anda:
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. Pengumpulan sinyal memakan waktu terlalu lama
Beberapa sinyal memiliki timeout. Pada perangkat lambat, pengumpulan bisa memakan waktu 200ms+. Sinyal yang paling mungkin menambah latensi adalah audio fingerprint (AudioContext ditangguhkan di iOS), probe WebRTC/TURN, deteksi font, dan timing DRM. Semuanya dibatasi oleh timeout dan tidak pernah memblokir tanpa batas.
Beberapa sinyal mengembalikan status non-success (misalnya "not available" atau "timeout").
Error sinyal adalah hal yang wajar dan ditangani dengan baik — sistem menyesuaikan confidence berdasarkan sinyal yang tersedia. Contoh umum: canvas diblokir oleh CSP, AudioContext timeout di iOS, WebGPU tidak didukung di sebagian besar browser, Client Hints tidak tersedia di luar Chromium. Tidak ada tindakan yang diperlukan kecuali sinyal kritis (canvas, WebGL, audio) secara konsisten gagal pada banyak pengunjung.
Jika Anda menemukan masalah yang tidak tercakup di sini:
debug: truerequestId dari identifikasi yang terpengaruh