技術情報

Google Analyticsインポートの設定（GA3 / GA4）

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

Matomo インスタンスが Google Analytics データをインポートするには、Google API にアクセスする必要があります。この API は Google Analytics Reporting API で、Matomo のアクセス設定にはいくつかの方法があります。

Matomo にデータへのアクセスを許可する一つの方法は、Google アプリを設定することです。この設定を作成する際に、Google API Console で外部アプリと内部アプリの二種類から選ぶことができます。

外部アプリ

外部アプリは誰でも作成できます。ほとんどの場合、インポートがシームレスに機能するように、公開済みの外部アプリを作成することをお勧めします。アプリを公開したくない、または公開できない場合でも、アプリの公開を進めることができます。ただし、公開されていないアプリの場合、Googleは承認から7日間という制限を設けており、それを過ぎると承認は失効します。その場合、以下の手続きが必要になります。インポートが完了するまで、7日ごとに手動でMatomoを再認証してください。

社内アプリ

内部アプリには 7 日間の有効期限はありません。内部アプリはGoogle Workspaceを購入したユーザーのみが利用できます。Google Workspaceを契約している場合は、内部アプリを使用してGoogle Analyticsからのインポートを実行できます。

Google OAuthクライアント設定の作成

重要事項:このステップでは、Googleにアプリを提出する必要はありません。アプリを送信するよう促され、いいえまたはキャンセルをクリックする選択肢がない場合は、このガイドの手順をもう一度確認し、重要なステップを見落としたり、必要のない情報を追加したりしていないか確認してください。

OAuthクライアント設定を取得するには、以下の手順に従ってください：

  1. Google API コンソールにサインインする。

  2. メニューのプロジェクトを選択するをクリックします。

  3. 新規プロジェクトを作成するには、オーバーレイの “新規プロジェクト “ボタンをクリックします：

  4. 新しいプロジェクトに便利な名前を付けます。(例：Matomo GA Import)

  5. プロジェクトが作成されたら、プロジェクトリストから手動で選択してください。

  6. 左のメニューからLibraryをクリックし、Google Analytics APIを検索して、Google Analytics APIという項目をクリックします。次に、このAPIの説明ページで有効化ボタンをクリックします。

  7. Google Analytics Reporting APIについても同様にしてください。

  8. Google Analytics 4のデータを移行する場合のみ、Google Analytics Data APIも同様に操作してください。

  9. Google Analytics 4のデータを移行する場合のみ、Google Analytics Admin APIも同様に操作してください。

  10. 次にOAuth同意画面を設定します。上部のGoogleロゴの横にあるメニューアイコンをクリックし、左メニューのAPIとサービス>OAuth同意画面に移動します。Google Workspaceアカウントをお持ちの場合は、Internalを選択します。それ以外の場合はExternal.を選択します。次に、作成をクリックします。

  11. アプリの名前を決めてドメインの追加をクリックし、matomoインスタンスのトップレベルドメインを追加します。例：Matomo.Cloud

  12. ユーザーサポートメールのドロップダウンメニューからメールアドレスを選択し、開発者の連絡先を入力してください。
    重要な注意事項：アプリロゴをここにアップロードしないでください。そうすることで、Googleに「アプリ」を提出し、検証を受ける必要があります。

  13. スコープとテストユーザーの両方のステップで「保存して続行する」をクリックします。

  14. サマリーステップで「ダッシュボードに戻る」をクリックします。

  15. 以前にアプリの種類を「Internal」に設定した場合は、ここでアプリのステータスを「Published」に設定する必要はなく、ステップ15と16をスキップすることができます。
    ダッシュボードでPublishing Status(ステータスの公開)の下にあるPublish App(アプリの公開)をクリックします。

  16. ポップアップに「検証のためにアプリを提出する必要はありません」と表示されていることを確認し、確認をクリックします。

  17. 左メニューのCredentialsタブに移動します。

  18. Create Credentialsをクリックします。

  19. OAuthクライアントIDを選択します。

  20. アプリケーションの種類としてウェブアプリケーションを選択します。

  21. アプリケーションの名前を設定します。例：Matomo at https://matomo.my-website.example

  22. Authorized JavaScript originsの下にあるURIの追加をクリックして、MatomoのURLドメインに設定します(例：https://matomo.my-website.example)
    注：これはドメインである必要があります。Matomo をサブディレクトリにインストールした場合は、パスなしでドメインを入力する必要があります。(https://my-website.example/matomo/の場合はhttps://my-website.example)

  23. Authorized redirect URIsの下にあるURIの追加をクリックします。この特別な URL/query/index.php?module=GoogleAnalyticsImporter&action=processAuthCodeを最後に追加して、MatomoのURLに設定する必要があります。例：https://matomo.my-website.com/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注：上記のURLはHTTPSです：SSLでMatomoインスタンスを実行することを強くお勧めします。Matomoがまだhttpsをサポートしていない場合は、URLをhttpに置き換えてください。
    Matomo for WordPressを使用している場合：URLはMatomoの管理ページへのパス全体、例えばhttp://mysite.com/wp-content/plugins/matomo/app/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注：MatomoのURLはサブドメインを持つ必要はありません。

  24. 2つのURIを入力したらCreateをOAuthクライアント認証情報の作成を完了します。

  25. 先ほど作成したOAuth認証情報が表示されます。OAuth認証情報をダウンロードするには、DOWNLOAD JSONをクリックします。
    (注意: 値のタイプミスを修正するなど、後で上記の設定を変更する場合は、OAuth認証情報を再度ダウンロードし、Matomoに再アップロードする必要があります)

これでOAuthクライアント設定の作成手順は完了です。
これらのステップのどの時点でも、確認のためにGoogleにアプリを提出する必要はありません。「アプリ」を送信するよう促され、「いいえ」や「キャンセル」をクリックする選択肢がなかった場合は、このガイドの手順をもう一度見直し、重要なステップを見落としたり、必要のない情報を追加したりしていないか確認してください。

OAuthプロセスを完了する際に、Googleから「Googleはこのアプリを検証していません」という警告が表示される場合があります。
この場合、”Advanced” をクリックし、”Go to matomo.cloud (unsafe)” または “Go to yourdomain.com (unsafe)” をクリックすると安全に続行できます。

Matomoの承認

OAuth クライアントの認証情報をダウンロードしたら、Matomo が Google Analytics のデータにアクセスできるように認証します：

  1. Matomoのスーパーユーザーとしてログインし、管理画面に移動します。

  2. 左メニューの「システム」→「Google Analyticsインポート」をクリックします。このメニューが表示されない場合はGoogleAnalyticsImporterプラグインがインストールされていることを確認してください。

  3. アップロードをクリックしてファイルを選択し、Google OAuthクライアントの設定方法でダウンロードしたOAuthクライアント認証情報をアップロードします。

  4. ここでAuthorizeをクリックし、プロンプトに従ってMatomoにGoogle Analyticsデータへのアクセス権を与えます。

  5. Continueをクリックし、Googleからプロンプトが表示された場合は、アプリを承認します。

重要な注意事項：Googleプロジェクトを設定する際にExternalを選択し、アプリを公開していない場合、Matomoの認証を定期的にやり直す必要があるかもしれません。Googleは外部プロジェクトのテストユーザーに対する有効期限は7日間で、その時点でインポートに失敗し、Matomoを再認証する必要があります。残念ながら、これを回避するには、一時的に Google Workspace アカウントを購入し、プロジェクトをInternalにすることです。

Matomo インスタンスが Google Analytics データをインポートするには、Google API にアクセスする必要があります。この API は Google Analytics Reporting API で、Matomo のアクセス設定にはいくつかの方法があります。

Matomo にデータへのアクセスを許可する一つの方法は、Google アプリを設定することです。この設定を作成する際に、Google API Console で外部アプリと内部アプリの二種類から選ぶことができます。

外部アプリ

外部アプリは誰でも作成できます。ほとんどの場合、インポートがシームレスに機能するように、公開済みの外部アプリを作成することをお勧めします。アプリを公開したくない、または公開できない場合でも、アプリの公開を進めることができます。ただし、公開されていないアプリの場合、Googleは承認から7日間という制限を設けており、それを過ぎると承認は失効します。その場合、以下の手続きが必要になります。インポートが完了するまで、7日ごとに手動でMatomoを再認証してください。

社内アプリ

内部アプリには 7 日間の有効期限はありません。内部アプリはGoogle Workspaceを購入したユーザーのみが利用できます。Google Workspaceを契約している場合は、内部アプリを使用してGoogle Analyticsからのインポートを実行できます。

Google OAuthクライアント設定の作成

重要事項:このステップでは、Googleにアプリを提出する必要はありません。アプリを送信するよう促され、いいえまたはキャンセルをクリックする選択肢がない場合は、このガイドの手順をもう一度確認し、重要なステップを見落としたり、必要のない情報を追加したりしていないか確認してください。

OAuthクライアント設定を取得するには、以下の手順に従ってください：

  1. Google API コンソールにサインインする。

  2. メニューのプロジェクトを選択するをクリックします。

  3. 新規プロジェクトを作成するには、オーバーレイの “新規プロジェクト “ボタンをクリックします：

  4. 新しいプロジェクトに便利な名前を付けます。(例：Matomo GA Import)

  5. プロジェクトが作成されたら、プロジェクトリストから手動で選択してください。

  6. 左のメニューからLibraryをクリックし、Google Analytics APIを検索して、Google Analytics APIという項目をクリックします。次に、このAPIの説明ページで有効化ボタンをクリックします。

  7. Google Analytics Reporting APIについても同様にしてください。

  8. Google Analytics 4のデータを移行する場合のみ、Google Analytics Data APIも同様に操作してください。

  9. Google Analytics 4のデータを移行する場合のみ、Google Analytics Admin APIも同様に操作してください。

  10. 次にOAuth同意画面を設定します。上部のGoogleロゴの横にあるメニューアイコンをクリックし、左メニューのAPIとサービス>OAuth同意画面に移動します。Google Workspaceアカウントをお持ちの場合は、Internalを選択します。それ以外の場合はExternal.を選択します。次に、作成をクリックします。

  11. アプリの名前を決めてドメインの追加をクリックし、matomoインスタンスのトップレベルドメインを追加します。例：Matomo.Cloud

  12. ユーザーサポートメールのドロップダウンメニューからメールアドレスを選択し、開発者の連絡先を入力してください。
    重要な注意事項：アプリロゴをここにアップロードしないでください。そうすることで、Googleに「アプリ」を提出し、検証を受ける必要があります。

  13. スコープとテストユーザーの両方のステップで「保存して続行する」をクリックします。

  14. サマリーステップで「ダッシュボードに戻る」をクリックします。

  15. 以前にアプリの種類を「Internal」に設定した場合は、ここでアプリのステータスを「Published」に設定する必要はなく、ステップ15と16をスキップすることができます。
    ダッシュボードでPublishing Status(ステータスの公開)の下にあるPublish App(アプリの公開)をクリックします。

  16. ポップアップに「検証のためにアプリを提出する必要はありません」と表示されていることを確認し、確認をクリックします。

  17. 左メニューのCredentialsタブに移動します。

  18. Create Credentialsをクリックします。

  19. OAuthクライアントIDを選択します。

  20. アプリケーションの種類としてウェブアプリケーションを選択します。

  21. アプリケーションの名前を設定します。例：Matomo at https://matomo.my-website.example

  22. Authorized JavaScript originsの下にあるURIの追加をクリックして、MatomoのURLドメインに設定します(例：https://matomo.my-website.example)
    注：これはドメインである必要があります。Matomo をサブディレクトリにインストールした場合は、パスなしでドメインを入力する必要があります。(https://my-website.example/matomo/の場合はhttps://my-website.example)

  23. Authorized redirect URIsの下にあるURIの追加をクリックします。この特別な URL/query/index.php?module=GoogleAnalyticsImporter&action=processAuthCodeを最後に追加して、MatomoのURLに設定する必要があります。例：https://matomo.my-website.com/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注：上記のURLはHTTPSです：SSLでMatomoインスタンスを実行することを強くお勧めします。Matomoがまだhttpsをサポートしていない場合は、URLをhttpに置き換えてください。
    Matomo for WordPressを使用している場合：URLはMatomoの管理ページへのパス全体、例えばhttp://mysite.com/wp-content/plugins/matomo/app/index.php?module=GoogleAnalyticsImporter&action=processAuthCode
    注：MatomoのURLはサブドメインを持つ必要はありません。

  24. 2つのURIを入力したらCreateをOAuthクライアント認証情報の作成を完了します。

  25. 先ほど作成したOAuth認証情報が表示されます。OAuth認証情報をダウンロードするには、DOWNLOAD JSONをクリックします。
    (注意: 値のタイプミスを修正するなど、後で上記の設定を変更する場合は、OAuth認証情報を再度ダウンロードし、Matomoに再アップロードする必要があります)

これでOAuthクライアント設定の作成手順は完了です。
これらのステップのどの時点でも、確認のためにGoogleにアプリを提出する必要はありません。「アプリ」を送信するよう促され、「いいえ」や「キャンセル」をクリックする選択肢がなかった場合は、このガイドの手順をもう一度見直し、重要なステップを見落としたり、必要のない情報を追加したりしていないか確認してください。

OAuthプロセスを完了する際に、Googleから「Googleはこのアプリを検証していません」という警告が表示される場合があります。
この場合、”Advanced” をクリックし、”Go to matomo.cloud (unsafe)” または “Go to yourdomain.com (unsafe)” をクリックすると安全に続行できます。

Matomoの承認

OAuth クライアントの認証情報をダウンロードしたら、Matomo が Google Analytics のデータにアクセスできるように認証します：

  1. Matomoのスーパーユーザーとしてログインし、管理画面に移動します。

  2. 左メニューの「システム」→「Google Analyticsインポート」をクリックします。このメニューが表示されない場合はGoogleAnalyticsImporterプラグインがインストールされていることを確認してください。

  3. アップロードをクリックしてファイルを選択し、Google OAuthクライアントの設定方法でダウンロードしたOAuthクライアント認証情報をアップロードします。

  4. ここでAuthorizeをクリックし、プロンプトに従ってMatomoにGoogle Analyticsデータへのアクセス権を与えます。

  5. Continueをクリックし、Googleからプロンプトが表示された場合は、アプリを承認します。

重要な注意事項：Googleプロジェクトを設定する際にExternalを選択し、アプリを公開していない場合、Matomoの認証を定期的にやり直す必要があるかもしれません。Googleは外部プロジェクトのテストユーザーに対する有効期限は7日間で、その時点でインポートに失敗し、Matomoを再認証する必要があります。残念ながら、これを回避するには、一時的に Google Workspace アカウントを購入し、プロジェクトをInternalにすることです。