クリックイベントについて

Elido の短縮リンクをクリックするたびに、ClickHouse に単一のクリックイベントが生成されます。イベントに何が含まれ、何が含まれないかを知ることは、高速なダッシュボードの構築と、フラストレーションのたまるサポートチケットの発生を分ける重要なポイントです。

記録される内容#

各クリックについて、以下の情報を保存します：

• Link ID — どの短縮リンクがクリックされたか。
• Workspace ID — クエリにおけるマルチテナントの分離に使用されます。
• Timestamp — UTC、マイクロ秒精度のタイムスタンプ。
• Country — MaxMind GeoLite2 を介して訪問者の IP から導出されます。IP アドレス自体は保存されません。
• Device class — User-Agent から導出されるデスクトップ / モバイル / タブレットの分類。
• Browser family — Chrome、Firefox、Safari など。デフォルトではバージョンレベルの詳細は記録されません。
• Operating system family — Windows、macOS、Linux、iOS、Android。
• Referrer host — t.co、linkedin.com など。パスではなく、ホスト名のみを記録します。
• UTM parameters — 転送先 URL に存在するか、短縮 URL に追加されている場合、utm_source、utm_medium、utm_campaign、utm_content、utm_term を記録します。
• Bot flag — User-Agent が当社のボットリスト（Slackbot、Twitterbot、セキュリティクローラー）に一致する場合に true となります。

記録されない内容#

• Full IP address — 地理情報の検索後に破棄されます。
• User-Agent string verbatim — ファミリーフィールドのみを抽出し、生の文字列は破棄します。
• Click coordinates / mouse movement / dwell time — 当社はリダイレクトサービスであり、ヒートマップツールではありません。
• Cookies on the redirect — クッキーの設定は行いません。

パイプライン#

1. エッジ POP (Hetzner FRA / OVH FRA / OVH SGP) が 20ms 未満でリダイレクトを処理します。
2. クリックイベントは Redpanda に fire-and-forget（投げっぱなし）方式で送信されます。リダイレクト処理はこの送信を待ちません。
3. click-ingester がトピックをコンシュームし、ClickHouse にバッチ挿入します（定常状態で約 5 秒のラグが発生します）。
4. ダッシュボードの分析タブは analytics-api を介して ClickHouse にクエリを実行します。

つまり、クリックした直後のデータは、数秒間ダッシュボードに表示されません。テストを行っていてクリックがすぐに反映されない場合は、30 秒待ってから更新してください。

保存期間#

クリックイベントはデフォルトで 365 日間保存されます。Pro+ ワークスペースでは、GDPR のデータの最小化のために、より短い保存期間（60 / 90 / 180 日）を設定できます。Business ワークスペースでは、規制の厳しい業界向けに、保存期間を 7 年間に延長できます。

保存期間を過ぎると、行全体が完全に削除されます。「論理削除」や、イベントをユーザーに関連付けたままにする集計アーカイブは存在しません。