Fathom AnalyticsからZenovayへ移行する場合、Fathomインポーターは過去の日次集計をZenovayに取り込み、移行当日もコンテキストを失わずに使い続けられるようにします。インポートは読み取り専用APIキーとFathomのサイトIDを使ったFathom APIで行います。
インポートされるもの
- 日次のページビューとユニーク訪問者数（過去90日間）
- 上位ページ、上位参照元、上位国（ウィンドウの内訳）
- ブラウザ、デバイスタイプ、OSの内訳
インポートされないもの
- 過去90日間より前の履歴
- 個々の訪問者セッションや生のイベントログ
- Fathomの目標／コンバージョン（集計の合計のみ）
- Eコマース／収益データ
- リアルタイムデータ（完了済みの日のみ。当日は常に除外されます）
インポート手順
ステップ1：FathomのAPIキーを取得
- usefathom.comのFathomアカウントにログインします。
- アカウント → API（左サイドバー）に移動します。
- APIキーを作成をクリックします。
- わかりやすい名前を付けます（例：「Zenovayインポート — 2026年6月」）。
- 権限を読み取り専用に設定します — Zenovayに書き込み権限は不要です。
- キーをコピーします。表示されるのは一度だけです。
ステップ2：FathomのサイトIDを取得
- Fathomでサイトに移動します。
- インポートしたいサイトを見つけます。サイトIDはサイト名の下に表示される短い英数字コードです（例：
ABCDE）。URLからも確認できます：app.usefathom.com/sites/ABCDE/...
ステップ3：Zenovayへインポート
- インポートしたいウェブサイトを開き、そのおよび設定を開いて、Importタブを選択します。
- ソースピッカーでFathom Analyticsタイルを選択します。
- APIキーとFathomのサイトIDを貼り付けます。
- 接続をクリックし、進捗が完了するまで待ちます。
インポートはバックグラウンドで実行されます。ページを離れて戻ってきても、Importタブにステータスが表示され、インポート履歴も確認できます。
ステップ4：インポート後にAPIキーを失効させる
インポートが正常に完了したら、Fathom → アカウント → APIに戻り、作成したキーを削除または失効させてください。インポート後はZenovayには不要で、キーを失効させることで、流出時のリスクを限定できます。
インポートの検証
インポート完了後、データが正しく入ったことを確認するため、この短いチェックリストを実行してください。
- ダッシュボードで任意の分析ビューを開きます（例：過去90日間のページビュー）。インポートされたデータは即座に表示され、既に収集されているネイティブデータとマージされます。
- 無作為に3日を選び、Fathomダッシュボードと突き合わせます。ページビューは±5%、ユニーク訪問者は±3%程度の差を見込んでください — FathomとZenovayは訪問者の重複排除方法が異なるため、小さな差は正常です。
- インポート行はデータベースで
imported_from='fathom'でタグ付けされているため、Zenovayのネイティブデータの横に（その上ではなく）格納されます。Importタブには、完了した各インポートと、そこでカバーされた日付範囲が表示されます。 - 同じ期間を再インポートして冪等性を確認します。行数は変わらないはずです — 各日がサイトごとにデータベースレベルで一意にキーされているため、重複は不可能です。
- 満足したら、FathomのAPIキーを失効させてください（上記ステップ4）。
違和感があれば[email protected]にインポート日と問題の日付を記載して送信してください。個別の日付を手動で修正できます。
トラブルシューティング
「Proで利用可能」と表示される
FathomインポーターはProプラン以上が必要です。プランをアップグレード →
「APIキーが無効」
Fathomからキーを完全にコピーしたことを確認してください — 作成時にのみ表示されます。確認できない場合は、古いキーを削除して読み取り専用以上の権限で新しいキーを作成してください。
「サイトIDが見つかりません」
Fathom → サイトでサイトIDを確認してください。大文字の短い英数字コードです。ダッシュボードURLから見つけている場合は、コード部分のみを抽出してください（例：app.usefathom.com/sites/ABCDE/からABCDE）。APIキーが特定のサイトにアクセス権を持っているか確認してください。
「データが返されませんでした」
以下を確認してください：
- 過去90日間がFathomサイトが実際に追跡していた期間と重なっているか。
- サイトIDが追跡していたサイトと一致しているか — アカウント内の別のFathomサイトではないか。
- Fathomアカウントのデータ保持が過去90日間を含んでいるか。
「認証エラー」
APIキーが削除または期限切れになっている可能性があります。Fathomで新しい読み取り専用APIキーを作成して再試行してください。
「インポートがタイムアウトしました」
非常に大きなウィンドウは時間がかかる場合があります。Zenovayは自動的に再試行します。繰り返しタイムアウトする場合は、インポートを再試行してください — 重複する範囲を再実行しても安全です。各日がサイトごとに一意にキーされているためです。
FAQ
Zenovayのネイティブデータを上書きしますか？
いいえ。インポート行はimported_from='fathom'でタグ付けされています。ネイティブデータの横に（その上ではなく）格納されるため、Zenovayで収集されたアナリティクスは損なわれません。
再インポートできますか？ はい、いつでも可能です。再インポートは同じ日付範囲をクリーンに上書きします — 重複やorphan行はなし。
なぜインポート後にAPIキーを失効させる必要がありますか？ FathomのAPIキーは永続的です。ZenovayはキーをインポートのみNeed必要とするため、完了後に失効させることがセキュリティのベストプラクティスです — キーが不要になったら、アクティブのままにしておくべきではありません。
Zenovayは私のFathom APIキーを保持しますか？ いいえ。Zenovayはインポートリクエスト中にのみキーを使用し、その後は保存しません。インポート後にFathomで失効させると、再度使用できなくなります。
日次データのタイムゾーンは？ FathomはデータをUTCで保存します。インポートされた行はUTCの日付を使用し、Fathomダッシュボードと一致します。
Zenovayは私の訪問者の個人データを見ますか？ いいえ。Fathom APIは集計統計のみを返します。個別の訪問者レコード、IP、ユーザーIDはZenovayに転送されません。
Fathomのデータに影響しますか？ いいえ。インポーターは読み取り専用です。ZenovayはFathomアカウントに決して書き込みません。
Fathomの目標をインポートできますか？ V1ではできません。ページビューと訪問者の日次集計合計をインポートします。目標／コンバージョンデータのインポートは将来のバージョンのロードマップに含まれています。