3分で読めます

Matomo インポーター

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

このツールができること

Matomo から 90 日分 の日次集計を取得します。訪問、ページビュー、上位参照元、上位ページ、上位国、デバイス、OS、ブラウザです。
Zenovay の analytics_daily テーブルに imported_from='matomo' 付きで書き込みます。ネイティブの Zenovay データと明確に区別できます。
冪等です。同じ期間を再インポートすると日付ごとに UPSERT し、重複を発生させずに上書きします。
Matomo の分類を Zenovay の正規名へ自動的に正規化します。たとえば Matomo のデバイスクラス Smartphone は Zenovay の Mobile にマッピングされ、バージョン接尾辞付きの OS(Windows 11、Android 14)は正規のファミリーにまとめられます。

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

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

前提条件

Pro 以上 の Zenovay アカウント。
Matomo のレポートエクスポートファイル、または API 認証トークンを使って HTTPS で到達できる Matomo インスタンス。

方法 A — レポートのエクスポートをアップロードする

Matomo が閉じたネットワーク内にある場合、または API トークンを共有したくない場合はこちらを使用します。

1. Matomo からエクスポートする

Matomo で対象のレポート(例:訪問者 → 概要 または 行動 → ページ)を開き、期間を直近 90 日に設定し、エクスポート ウィジェットで CSV または JSON ファイルをダウンロードします。

2. インポートタブを開く

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

3. ファイルをアップロードする

Matomo のタイル → エクスポートをアップロード をクリックし、CSV または JSON ファイルを選択します。Zenovay はファイルを解析し、Matomo の列を自身のスキーマにマッピングし、デバイス／OS／ブラウザ名を正規化し、書き込み前にプレビューを表示します。

4. 確認する

プレビュー(検出された行数、期間、正規化されたディメンション)を確認し、インポート をクリックします。データは Matomo 起源マーカー付きでダッシュボードに表示されます。

方法 B — Matomo レポーティング API 経由で接続する

サポートされるすべてのディメンションを 1 回のパスで取得する、手作業不要のインポートにはこちらを使用します。

1. Matomo で認証トークンを作成する

Matomo で 個人 → セキュリティ → 認証トークン に移動し、新しいトークンを作成します。token_auth の値をコピーします — Matomo は一度しか表示しません。

2. 数値のサイト ID を確認する

Matomo では、サイト ID(idSite)はサイトのレポート表示時に URL に表示される数値、または 管理 → ウェブサイト → 管理 で確認できます。1 や 42 のような単純な整数です。

3. Zenovay で接続する

Matomo のタイル → API 経由で接続 を開き、以下を入力します。

Matomo ベース URL — Matomo インストールのルート。例:https://analytics.example.com(末尾のパスなし)。
token_auth — 手順 1 のトークン。
サイト ID — 手順 2 の数値の idSite。

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

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

5. 結果を確認する

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

正規化についての注記

Matomo と Zenovay では技術の分類が少し異なります。Zenovay は自動的にマッピングして、インポートデータとネイティブデータを揃えます。

Matomo のデバイスクラス Smartphone → Zenovay Mobile。Tablet は Tablet のまま、Desktop は Desktop のまま。
バージョン接尾辞付きの OS(Windows 11、macOS 15、Android 14、iOS 18)は正規のファミリー(Windows、macOS、Android、iOS)にまとめられます。
ブラウザ名は Zenovay の正規リストと照合されます。マイナー／ビルドのバージョンは除去されます。

確実にマッピングできない値は、破棄せずそのまま保持します。

トラブルシューティング

「Matomo に到達できませんでした」

ベース URL に末尾のパスがなく、公開インターネットから HTTPS で到達できることを確認してください。VPN や IP 許可リストの内側にある Matomo インスタンスにはインポーターが到達できません — 代わりに 方法 A(ファイルアップロード)を使用してください。

「token_auth が無効です」

個人 → セキュリティ → 認証トークン でトークンを再生成し、もう一度貼り付けてください。サイトへの閲覧アクセス権がない別の Matomo ユーザーのトークンも、ここで失敗します。

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

サイト ID はサイト名やドメインではなく、数値の idSite である必要があります。管理 → ウェブサイト → 管理 で確認してください。

「未対応のエクスポート形式」

方法 A は Matomo のネイティブな CSV および JSON エクスポートを受け付けます。再エクスポート、手動編集、表計算ソフトで再保存したファイルは、Zenovay が必要とするヘッダー行を失う場合があります — Matomo のエクスポートウィジェットから直接ダウンロードし直してください。

「部分的なインポート」

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

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

Matomo の重複排除と訪問のカウント方法は Zenovay のネイティブインジェストとは異なり、ボットフィルタリングも異なります。小さな差を見込んでください。imported_from='matomo' マーカーを使えば、同条件で比較できます。

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

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

再インポートと削除

同じ期間でインポートを再実行すると日付ごとに UPSERT するため、繰り返しても安全です。インポート済みの Matomo データを削除するには、Matomo タイルを開いて インポート済みデータを削除 を使用してください — ネイティブの Zenovay 行には影響しません。