MatomoからZenovayへ移行する場合、Matomoインポーターは過去の日次集計をZenovayに取り込み、移行当日もコンテキストを失わずに使い続けられるようにします。Zenovayはインスタンスのベースリンク、token_auth、サイトIDを使用してMatomo Reporting APIに接続し、履歴を直接取得します。MatomoインスタンスはPublicアクセス可能である必要があります（セルフホスト環境のPublicホストまたはMatomo Cloud）。
インポートされるもの
- 日次のページビュー、訪問数、ユニーク訪問者数（要求された日付範囲）
- 上位ページ、上位参照元、上位国
- ブラウザ、デバイスタイプ、オペレーティングシステムの内訳
インポートされないもの
- 個々の訪問者セッションや生のイベントログ
- カスタムディメンションやカスタムレポート
- Eコマース／収益イベント
- リアルタイムデータ（完了済みの日のみ。当日は常に除外されます）
- 目標とコンバージョン（日次集計の合計のみ）
必要なもの
- Matomoインスタンスのベースリンク（例：
https://analytics.example.com） token_auth— Matomoの管理 → 個人 → セキュリティ → 認証トークンで確認できます- MatomoのサイトID — 管理 → ウェブサイト → 管理に表示されています
個人トークンを使用したくない場合は、インポートするサイトに閲覧アクセス権限を持つ専用トークンを作成し、インポート完了後に削除してください。
インポート方法
- ドメイン詳細ページを開く → Import タブ。
- Matomo を選択し、APIで接続 モードに切り替えます。
- MatomoのベースURL、
token_auth、サイトIDを入力します。 - 接続してインポート をクリックし、進捗バーが完了するまで待ちます。
デフォルトでは、Zenovayはおよそ過去90日をインポートします。インポートはバックグラウンドで実行されるため、ページを離れて戻ってきても構いません。ステータスはImportタブに表示されます。
内部的には、ZenovayがMatomo Reporting API（日次総計にはVisitsSummary.getとActions.get、内訳にはActions.getPageUrls、Referrers.getReferrers、UserCountry.getCountry、DevicesDetection.*）を認証情報を使って呼び出します。token_authはこのインポートにのみ使用され、Matomoからいつでも失効させることができます。
インポート成功後、Matomoでtoken_authを失効または更新してください — インポート専用の短寿命な読み取り専用トークンを作成し、使用後に削除するのが最も安全です。
インポートの検証
インポート完了後、データが正しく入ったことを確認するため、この短いチェックリストを実行してください。これはZenovayチームが内部で使用しているのと同じ手順です。
- ダッシュボードで任意の分析ビューを開きます。インポートされたデータは即座に表示され、すでにネイティブで収集しているデータと結合されます。
- 無作為に3日を選び、Matomoダッシュボードと突き合わせます。ページビューは±5%、訪問数は±3%程度の差を見込んでください — MatomoとZenovayは訪問者の重複排除方法が異なるため、小さな差は正常です。
- インポート行には
imported_from='matomo'タグがデータベースに付与されているため、いつでもZenovayがネイティブに収集したデータと区別できます。（注：Stats APIはimported_fromをクエリ可能なフィルターキーとして公開しません — 利用可能なフィルターはcountry、browser、device、os、source、utm_*ディメンション、およびpageをカバーしています。詳細な構文はStats APIを参照してください。） - 同じ期間を再インポート して冪等性を確認します。行数は変わらないはずです — データベースレベルの一意性制約により、重複は不可能です。
- 満足したら、このインポートのために作成した
token_authを削除または失効させます。
いずれかのチェックに違和感があれば、インポート日と問題のある日付を添えて[email protected]までご連絡ください。個別の日付の修正が可能です。
トラブルシューティング
「Proで利用可能」と表示される
MatomoインポーターはProプラン以上が必要です。プランをアップグレード →
「認証に失敗しました」
token_authは大文字小文字を区別します。ベースURLに末尾スラッシュがないことと、Publicアクセス可能であること（http://192.168.1.xなどのプライベートアドレスには到達できません）を確認してください。Matomoの管理 → 個人 → セキュリティ → 認証トークンで対象サイトに少なくとも閲覧権限を持つ新しいトークンを作成してください。
「サイトIDが見つかりません」
Matomoの管理 → ウェブサイト → 管理でサイトIDを確認してください。サイト名の横に表示される番号です。複数のサイトをお持ちの場合は、Zenovayにインポートするドメインに対応するIDを使用していることを確認してください。
「データが返されませんでした」
Matomoが日付範囲に対して空のレポートを返す場合は、その期間にトラッキングがアクティブだったこと、およびMatomo サイトIDがドメインと一致していることを確認してください。また、token_authが管理エリアのスーパーユーザーアクセスだけでなく、サイトへの閲覧アクセス権限を持っていることを確認してください。
「インポートがタイムアウトしました」
非常に大きな日付範囲（数年）はアルゴリズムに時間がかかります。Zenovayは自動的に再試行します。問題が継続する場合は、日付範囲を小さな期間に分割してください（例：1年ずつインポート）— 冪等性の制約により、重複する範囲の再インポートは安全です。
FAQ
Zenovayのネイティブデータを上書きしますか？
いいえ。インポート行はimported_from='matomo'でタグ付けされ、ネイティブに収集するデータの横に格納されるため、データベース内で常に区別可能です。
再インポートできますか？ はい、いつでも可能です。再インポートは同じ日付範囲をきれいに上書きします — 重複なし、孤立した行なし。
Matomoインポートは無料ですか？ いいえ。MatomoインポーターはProプラン以上が必要です（他のアナリティクスインポーターと同様）。
インポートされた日次総計のタイムゾーンは？ インポートされた行は、日付ディメンション用にMatomoサイトに設定されたタイムゾーンを使用します。MatomoサイトがEurope/Londonに設定されている場合、インポート内の「2026-05-16」はロンドン時間の通日を意味します。
Zenovayは私のtoken_authを保持しますか？
いいえ。token_authはインポートリクエストと一緒に送信され、このインポート用のMatomo Reporting APIの呼び出しにのみ使用された後、破棄されます。Zenovayデータベースには保存されず、再利用もされません。それでも、インポート完了後には念のためMatomoでトークンを失効または削除する必要があります。
Zenovayは訪問者の個人データを見ますか？ いいえ。Matomo Reporting APIは集計統計のみを返します（合計、Top-Nリスト）。個々の訪問者レコード、IP、ユーザーIDはZenovayに転送されません。
Matomoのデータに影響しますか？ いいえ。インポーターは読み取り専用です。ZenovayはMatomoインスタンスに決して書き込みません。