2分で読めます

Fathom インポーター

Pro 以上で利用可能。 Fathom インポーターは、Fathom Analytics の直近 90 日間の日次集計を Zenovay に取り込むワンショットツールです。移行時に過去の文脈を失わずに済みます。

このツールができること

Fathom Analytics から 90 日分 の日次集計を取得します。訪問数、ページビュー、上位参照元、上位ページ、上位国、デバイス、OS、ブラウザです。
Zenovay の analytics_daily テーブルに imported_from='fathom' 付きで書き込みます。ネイティブの Zenovay データと明確に区別できます。
冪等です。同じ期間を再インポートしても重複は発生せず、日付ごとに UPSERT されます。

このツールができないこと

個別の訪問者セッションは インポートしません。
カスタムイベント、目標、リアルタイムデータは インポートしません。
継続的な同期は 行いません。V1 はワンショットのみで、定期同期はロードマップ上にあります。

前提条件

Pro 以上 の Zenovay アカウント。
少なくとも 1 つのサイトがある Fathom Analytics アカウント。
Fathom の読み取り専用 API キー（以下を参照）。

セキュリティに関する注意。 Fathom の API キーは Bearer トークンとしてアカウントデータへのアクセスを許可します。Zenovay はインポートリクエスト中にのみキーを使用し、永続的には保存しません。このインポート専用の API キーを作成し、インポート完了後すぐに Fathom でキーを失効させる ことをお勧めします。

手順

1. Fathom で読み取り専用 API キーを作成する

Fathom で 設定 → API に移動し、新しい API キーを作成します。わかりやすい名前を付けてください（例：zenovay-import-2026-05）。キーをコピーします — Fathom は一度しか表示しません。

特別なスコープを割り当てる必要はありません。Fathom の API キーはデフォルトでサイトの統計への読み取りアクセス権を持ちます。

2. Fathom でサイト ID を確認する

Fathom でインポートしたいサイトを開き、URL を確認します — エンティティ ID は /sites/ 以降の英数字のセグメントです（例：https://app.usefathom.com/#/sites/ABCDE/ の ABCDE）。または 設定 → サイト に移動して、サイトの横に表示されている ID をコピーします。

3. Zenovay でインポートタブを開く

ドメインの詳細ページに移動し、インポート タブを選択します。Plausible（既存）と Fathom（新規）のソースタイルが表示されます。

4. API キーとサイト ID を入力する

Fathom のタイル → API で接続 をクリックし、次の情報を入力します：

API キー — 手順 1 の Bearer トークン。
サイト ID — 手順 2 の英数字のエンティティ ID。

5. インポートを開始する

直近 90 日をインポート をクリックします。インポートはバックグラウンドで実行され、UI は 2 秒ごとにステータスをポーリングして進捗バーを表示します。90 日のインポートは通常 30〜60 秒で完了します。

6. 結果を確認する

完了すると、インポートされた行数、期間、見つかったディメンションが表示されます。インポートされたデータは、Fathom 起源マーカー付きで即座にダッシュボードに表示されます。

7. Fathom で API キーを失効させる

インポートが確認されたら、Fathom の 設定 → API に戻り、手順 1 で作成したキーを削除または失効させてください。Zenovay はその後のネイティブトラッキングにこのキーを必要としません。

トラブルシューティング

「API キーが無効です」

先頭や末尾にスペースなくキー全体をコピーしたことを確認してください。Fathom の 設定 → API でキーを再生成して再度貼り付けてください。

「サイトが見つかりません」

サイト ID は Fathom の URL や設定に表示される英数字のエンティティ ID である必要があります。表示名やドメインではありません。設定 → サイト で確認してください。

「レート制限に達しました」

Fathom はキーごとに 1 分あたりの API リクエスト数を制限しています。このエラーが表示されたら、60 秒待ってから再試行してください。Zenovay は事前にバックオフ付きで自動的に 3 回再試行してからこのエラーを表示します。

「部分的なインポート」

これは Fathom が 90 日未満のデータしか返さなかった場合に表示されます。多くの場合、サイトが 90 日より新しいか、一部の日に流入がなかったためです。ダッシュボードでインポート範囲を抜き取りで確認してください。

データが Fathom ダッシュボードと若干異なる

Fathom と Zenovay は訪問数のカウントとボットフィルタリングが若干異なります。小さな差異は想定内です。imported_from='fathom' マーカーを使えば、同条件で比較できます。

インポートデータを区別する

インポートされた行はすべて analytics_daily 上で imported_from='fathom' を持ちます。Zenovay の Public Stats API（Pro+）では同じフィールドでフィルタできます。ネイティブの Zenovay データは imported_from=NULL です。

再インポートと削除

同じ期間を再インポートすると日付ごとに UPSERT されるため、繰り返しても安全です（有効な API キーが必要）。インポートした Fathom データを削除するには、Fathom タイルを開いて インポート済みデータを削除 を使用してください。ネイティブの Zenovay 行は変更されません。