このページでは、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 | よくある誤検知の原因 | 解決策 |
|---|---|---|
automation | テストツールがブラウザを自動化モードのままにした | テスト実行以外では自動化モードを無効化 |
headless | 実 GPU なしでレンダリングする VDI／リモートデスクトップ | 後述の「企業環境」を参照 |
extension | 自動化、プロキシ、VPN のブラウザ拡張機能が有効 | 拡張機能を確認 |
other | 特定できない自動化の指標が発火した | クラスは reasons（Business 以上）で確認 |
Business および Enterprise プランでは、Webhook の reasons 配列が判定の根拠となった観測のクラスを示します。誤検知を理解する最短の手段です。理由コードを参照してください。
2. ソフトウェアレンダリングを伴う企業環境
Citrix、VDI、ターミナルサーバー環境は実 GPU なしでレンダリングするため、ヘッドレスの実行環境に似て見えます。ユーザーがこれらの環境で作業する場合、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 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() の応答に、お手元のほかのテスト用デバイスやネットワークと比べて明らかに時間がかかります。
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. 収集に時間がかかりすぎる
性能の低いデバイスでは、収集により時間がかかります。遅くなりうるチェックはいずれも個別のタイムアウトで上限が定められているため、収集が無限にブロックすることはありません。時間切れになったチェックは単に利用不可として報告され、識別はそれなしで進みます。
識別は完了するものの、特定のブラウザやデバイスクラスで信頼度が想定より低くなります。
すべてのチェックがすべての環境で実行できるわけではありません。厳格な CSP、プラットフォームの制約、ブラウザのプライバシー機能によって、一部は利用できなくなります。これは想定内であり、適切に処理されます — 信頼度は実際に収集できたものから算出されるため、堅牢化されたブラウザが標準的なブラウザより低い信頼度で識別されるのは正当な結果です。
対応は不要です。トラフィックの大きな割合にわたって信頼度が一貫して低い場合は、requestId を添えてサポートにご連絡ください。これはブラウザからではなく、サーバー側の記録から診断します。
ここで扱われていない問題に遭遇した場合: