技術情報

Google Analyticsインポートの実行（GA3 / GA4）

2025年01月21日 Google Analyticsのデータをインポートする Google Analyticsデータのインポート インストール＆メンテナンス

注：このガイドは、MatomoがあなたのGoogle Analyticsデータにアクセスすることを許可していることを前提としています。最初に手順を踏んでいることを確認してください。

Matomoを認証したら、データのインポートを開始できます。インポートは管理画面またはコマンドラインから行うことができます。コマンドラインでインポートを実行すると、インポートの進行状況についてより詳細な情報を確認することができます。インポートするデータの量によっては、インポートの完了までに長い時間がかかることがあります。

Googleは、1日に行えるAPIリクエスト数（最大50,000）および各サイト（最大10,000）に制限を課しています。インポートは、毎日データがある場合、約4ヶ月分のデータをインポートすると、この上限に達します。これには数時間しかかからない。つまり、インポートは、データセット全体がインポートされるまで、数日間にわたって実行されなければなりません。

管理画面を使ってインポートを設定する

  1. Google Analyticsのインポート管理ページにアクセスします。

  2. インポートの種類を選択します。

    Schedule An Import Form

  3. インポートスケジュールに必要事項を入力し「スタート」をクリックします：

    Schedule An Import Form for Universal Analytics (GA3)

    Schedule An Import Form for GA4

  4. インポートが継続されると、以下のインポートジョブ表で進捗状況を確認することができます：

    Import Jobs List

    Import Jobs List

    ページを更新すれば、いつでも最新のステータスが表示されます。

  5. インポートが完了したら、ステータスを削除してください。インポートに失敗した場合は、/path/to/your/matomo/tmp/logs/.にあるログを見ることができます。各ジョブに１ずつあるはずです。

ユニバーサルアナリティクス（GA3）のコマンドラインを使用してインポートを設定する

  1. まず、いくつかの情報が必要です。Googleアナリティクスのダッシュボードで、プロパティセレクタを開きます。
  2. インポートしたいプロパティ/ビューのプロパティIDとビューIDをメモします。
  3. sshをMatomoインスタンスに追加します。
  4. 以下のコマンドを実行して、サイトをインポートしてください：
    $ cd /path/to/my/matomo
    $ php ./console googleanalyticsimporter:import-reports --property=<property-id> --view=<view-id> --dates=<dates>
    property-idとview-idには、前述のGAプロパティIDとビューIDを代入します。datesにはインポートしたい日付の範囲を指定します(例：2017-01-01,2022-04-31)

その後、インポートが終わるまで待ちます。

既存のインポートを再開したい場合は--idsite=<idSite>パラメータに、このインポートのために作成されたサイトを指定してください（これは管理ページのインポートステータス表に記載されます）

インポートが完了したら、先ほど付与した権限を削除することができます。Matomo が Google Analytics にアクセスする必要があるのはデータをインポートしている間だけです。

GA4のコマンドラインを使ってインポートをセットアップする

  1. まず、いくつかの情報が必要です。Googleアナリティクスのダッシュボードで、プロパティセレクタを開きます。
  2. に注意してください。物件IDインポートしたいプロパティの
  3. sshをMatomoインスタンスに追加します。
  4. 以下のコマンドを実行して、サイトをインポートする：
    $ cd /path/to/my/matomo
    $ php ./console googleanalyticsimporter:import-ga4-reports --property="properties/<property-id>" --dates=<dates>
    についてproperty-idには、前述の GA4 プロパティ ID を代入する。以下の場合datesインポートしたい日付の範囲を指定する、2017-01-01,2022-04-31.

その後、インポートが終わるまで待つ。

既存のインポートを再開したい場合は--idsite=<idSite>パラメータに、このインポートのために作成されたサイトを指定します（これは管理ページのインポートステータス表に記載されます）。

インポートが完了したら、先ほど付与した権限を削除することができます。Matomo が Google Analytics にアクセスする必要があるのはデータをインポートしている間だけです。

インポーターオプション

モバイルアプリのプロパティをインポートする

GAプロパティがモバイルアプリのためのものであるならば、インポート開始する前にMobile Appにチェックを入れてからインポートを開始してください：

Import Mobile App

これにより、Matomoが正しいデータをインポートするようになります。Googleアナリティクスのスクリーンビューの指標はインポートされ、マトモのページビューの指標として使用されます。スクリーンレポートは Matomo のページタイトルレポートにインポートされます。

このボックスにチェックを入れず、プロパティがモバイルアプリの場合、インポータはこのデータを無視します。

サポートされていないGA寸法のインポート

人口統計ディメンジョンなど、Matomo に存在しない GA ディメンジョンもあります。インポート時にこの情報を保持したい場合は、データをカスタムディメンジョンにインポートすることで可能です。

インポートフォームで、”Extra Custom Dimension Mappings “フィールドにインポートしたいGAディメンションを入力します：

Extra Custom Dimension Mappings

このリストを使用して、ユニバーサルアナリティクス（GA3）ディメンションの適切なIDを検索します。
このリストを使用し、GA4ディメンションの適切なIDを検索してください。

インポートすると、余分なマッピング1つにつき、インポートされたサイトでカスタム・ディメンション・スロットが1つ使用されます。(注意：Matomoに十分なカスタムディメンジョンスロットがない場合はエラーになります)。

インポート後

Matomoへのデータインポートが終わったら、Matomoのデータベースをバックアップすることをお勧めします。インポートしたレポートデータが削除されたりした場合、GAからデータを再度インポートする必要があります。また、GAのプロパティが削除された場合、データは永遠に消えてしまいます。

データベースを定期的にバックアップしている（あるいはホストがバックアップしてくれている）のであれば、特に心配する必要はありません。