やること
- 分析タブからリンクまたは期間を指定して、クリックイベントのCSVを直接ダウンロードする。
- Pro+プランで定期エクスポート（日次 / 週次 / 月次）をメールまたはS3互換バケットへスケジュールする。
- Businessプランで独自のClickHouseクラスターにクリックイベントをリアルタイムストリーミングする。または、ウェアハウス同期向けにページネーション対応のAPIで取得する。
お客様のデータはお客様のものです。Elidoでは、データの量や必要となる頻度に応じて、システムからデータを取り出す3つの方法を提供しています。
クイックCSVエクスポート#
単一のリンク、または最大90日間の期間指定の場合：
- リンクの Analytics タブ（または複数リンクのエクスポートの場合はワークスペースレベルの分析ページ）を開きます。
- Export → CSV をクリックします。
- ジョブはバックグラウンドで実行されます。10万イベント未満であれば30秒以内、より大規模な範囲であれば数分以内に通知インボックスに届きます。
CSVのカラムは クリックイベントのスキーマ と一致します。ファイルはBOM付きのUTF-8形式であるため、Excelで国名やUTM値に含まれる非ASCII文字が文字化けすることはありません。
定期的なエクスポート#
Pro+プランでは、ご自身のメールアドレスやS3互換バケットへの定期的なエクスポートをスケジュールできます。このcronは notification 内で動作し、日次・週次・月次の頻度に対応しています。タイムゾーンを考慮したスケジューリングをサポートしているため（例：「Europe/Berlin の毎週月曜 09:00」）、DSTをまたいでも正確に実行されます。
Settings → Reports → Scheduled exports から設定してください。各スケジュールは、選択した頻度で前の期間のイベントを出力します。
ClickHouseエクスポート (Business)#
クリックイベントを直接独自のClickHouseクラスターに保存したい場合、analytics-exportワーカーがイベントの到着に合わせて clickhouse:// DSNにストリーミングできます。セットアップ手順：
- Settings → Integrations → ClickHouse export を開きます。
- DSNを貼り付けます。保存前に接続テストが行われます。
- データを入力するテーブル（
clicks_raw、clicks_hourly、またはその両方）を選択します。
有効にすると、クラスターは約5秒以内にすべてのクリックイベントのコピーを受信します。Elidoがお客様のクラスターからデータを削除することはありません。そこでのデータ保持期間（レテンション）の管理はお客様の責任となります。
プログラムによるエクスポート (API)#
より軽量な統合には、 /v1/clicks エンドポイントをご利用ください。クリックイベントをJSON形式で返し、カーソルベースのパジネーションに対応しています。 SDKs では、これらを client.clicks.recent() や client.clicks.range(from, to) といったヘルパーでラップしています。
これは、顧客データウェアハウス（Fivetran、Airbyte、カスタムのPythonスクリプトなど）へ日次バッチで同期するのに最適なツールです。より大量のリアルタイムなユースケースには、前述のClickHouseエクスポートの方が適しています。
GDPR準拠のエクスポート#
エクスポートの際、 保持期間コントロール を通じてお客様が除外設定したフィールドは編集（伏せ字化）されます。保持期間が短縮された後に古い条件でエクスポートを再実行しても安全です。欠落した行は単にファイルに含まれません。