このページでは、TRACIO 統合中に遭遇する一般的な問題とその解決策を扱います。TRACIO はマネージドクラウドサービスであるため、ほとんどの問題はインフラ側ではなくクライアント側（スクリプトのブロック、Cookie、ブラウザのプライバシー機能）です。
エージェントスクリプトまたは識別リクエストの読み込みに失敗する、あるいはブラウザコンソールに edge.tracio.ai に対する CORS エラーが表示されます。
1. オリジンが鍵に対して許可リストに登録されていない
各公開鍵は許可オリジンのセットにロックできます。サイトのオリジンが許可リストにない場合、エッジはリクエストを拒否します（403）。ダッシュボードの Request Filtering でオリジンを追加するか、使用している鍵が別のサイトにオリジンロックされていないか確認してください。
2. 広告ブロッカーまたは CSP によるリクエストのブロック
プライバシー拡張機能（uBlock Origin、AdBlock）や厳格な Content-Security-Policy は、エージェントスクリプトやそのネットワークリクエストをブロックすることがあります。SDK はこれを blocked エラーとして表面化します（エラー処理 を参照）。ブロックを困難にするには、scriptUrl / endpoint オプションを使用してファーストパーティのサブドメインからエージェントを配信してください。
3. 誤ったエンドポイント／リージョン
正しいエンドポイントを指していることを確認してください。region を設定すると、SDK は edge.us.tracio.ai または edge.eu.tracio.ai と通信します。未設定の場合は edge.tracio.ai を使用します。
再訪問者に対して信頼度スコアが一貫して 0.90 を下回ります。
1. Cookie が永続化されていない
_vid_t Cookie が正しく設定されていない可能性があります。ブラウザで確認してください。
// In browser consoledocument.cookie.split(";").filter((c) => c.includes("_vid_t"))Cookie が見つからない場合は、下記の Cookie が永続化されない セクションを参照してください。
2. 新しいワークスペース
新規のワークスペースは訪問者データベースが空であるため、すべての訪問者が「新規」として、およそ 0.90 の信頼度で表示されます。24〜48 時間後には、再訪問者がより高い信頼度で認識されます。
3. シークレット／プライベートブラウジング
シークレットモードでは、セッション終了時に Cookie と localStorage がクリアされます。TRACIO はシグナルのみのマッチングにフォールバックし、信頼度は低くなります（通常 0.85〜0.95）。
4. 積極的なアンチフィンガープリンティングを備えたブラウザ
Brave、Firefox（strict モード）、Safari（ITP）は、一部のブラウザシグナルを改変またはブロックします。これによりマッチングに利用できるシグナルセットが減少します。TRACIO はこれらのブラウザを検知し、それに応じて信頼度を調整します。
ダッシュボード（Visitors / Events）で識別を確認するか、各イベントについて
identification.confidence、identification.incognito、bot 判定を保持する
webhook 配信に基づいて処理してください。
正当な人間の訪問者がボットとしてフラグ付けされます。
1. navigator プロパティを改変するブラウザ拡張機能
一部のプライバシー拡張機能は navigator.userAgent、navigator.platform などのプロパティを改変します。これは改ざん検知器をトリガーする可能性がありますが、単独でボット検知をトリガーすべきではありません。
bot.type フィールドを確認して、どの検知器が発火したかを特定します。
| bot.type | よくある誤検知の原因 | 解決策 |
|---|---|---|
webdriver | ブラウザテストツールが navigator.webdriver = true を残した | ユーザーはテストモードを無効化すべき |
headless | ソフトウェア GPU レンダリングを伴う VNC／リモートデスクトップ | SwiftShader/llvmpipe が GPU レンダラーか確認 |
unknown | ブラウザ拡張機能による eval 長の異常 | 拡張機能を確認 |
rateBot | 自動的なページ再読み込みまたは積極的なポーリング | リクエスト頻度を下げる |
2. ソフトウェアレンダリングを伴う企業環境
Citrix、VDI、ターミナルサーバー環境では、ソフトウェア GPU レンダリング（SwiftShader、llvmpipe）が使用されることが多く、これはヘッドレスのマーカーです。ユーザーがこれらの環境で作業する場合、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 Cookie が訪問間で消失し、すべての訪問が「新規」訪問者として表示されます。
1. 非 HTTPS サイト
_vid_t Cookie は Secure フラグを使用し、HTTPS 経由でのみ設定されます。サイトが HTTPS を使用していることを確認してください。
2. クロスサイトでの読み込み
TRACIO は Cookie に SameSite=Lax を設定します。厳格なクロスサイトコンテキストでエージェントが読み込まれると、Cookie がブロックされることがあります。ファーストパーティのサブドメイン（scriptUrl / endpoint 経由）からエージェントを配信すると、同一サイトに保たれます。
3. Safari ITP
Safari の Intelligent Tracking Prevention（ITP）は、クライアントが設定した Cookie の有効期間を制限することがあります。TRACIO は Set-Cookie ヘッダー経由でサーバーサイドでも _vid_t を発行し、UID を localStorage にミラーリングするため、Cookie が制限されてもアイデンティティは維持されます。
4. Cookie を消去するブラウザ
一部のブラウザ（Brave、Firefox Focus）はセッション終了時に Cookie を消去します。積極的なプライバシー設定のユーザーは、常に新規訪問者として表示されます。
tracio.getResult() の応答に 500ms を超える時間がかかります。
1. エッジへの遅いネットワーク
リージョナルエッジへのラウンドトリップレイテンシを確認します。
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. シグナル収集に時間がかかりすぎる
一部のシグナルにはタイムアウトがあります。低速なデバイスでは、収集に 200ms 以上かかることがあります。レイテンシを増やす可能性が最も高いシグナルは、オーディオフィンガープリント（iOS で AudioContext が suspended になる）、WebRTC/TURN プローブ、フォント検知、DRM タイミングです。これらはタイムアウトで制限されており、無限にブロックすることはありません。
一部のシグナルが非成功ステータス（たとえば "not available" や "timeout"）を返します。
シグナルエラーは想定内であり、適切に処理されます — システムは利用可能なシグナルに基づいて信頼度を調整します。よくある例: CSP による canvas のブロック、iOS での AudioContext のタイムアウト、ほとんどのブラウザでの WebGPU 非対応、Chromium 以外での Client Hints の非対応。多くの訪問者にわたって重要なシグナル（canvas、WebGL、audio）が一貫して失敗しない限り、対応は不要です。
ここで扱われていない問題に遭遇した場合: