技術情報

MatomoにGoogle検索キーワードをインポートする

2025年01月21日 インストール＆メンテナンス 検索エンジンから検索キーワードをインポートする 設定

Matomo On-Premiseを使用している場合は、まずSearch Engine Keywords Performance プラグインがあることを確認してください。

  1. Google Search Consoleの設定方法の手順に従って、Webサイトを確認してください。

  2. Google OAuthクライアントの設定方法の手順に従って、OAuth設定を取得してください。

  3. Matomoにスーパーユーザーでログインし、右上の「管理（歯車アイコン）」をクリックし、「システム」の「検索パフォーマンス」をクリックします。Matomo for WordPressを使用している場合は、まず「WP Admin Dashboard -> Matomo Analytics -> Reporting」に移動してから、この手順を完了してください。

  4. Google Search Consoleの下にあるセットアップ設定をクリックします。

  5. OAuth認証情報をアップロードします。

  6. Connect Google Account(s)の下にあるoAuthプロセスの開始をクリックします。

  7. キーワードをインポートするウェブサイトを設定できます。ウェブサイトの設定の下にある設定の追加をクリックします。

おめでとうございます！あなたのGoogleキーワードは、新しいMatomo（Piwik）検索キーワードレポートにインポートされます。

Google Search Consoleの設定とウェブサイトの確認方法

MatomoでGoogle検索キーワードをインポートするには、Google Search Consoleにログインし、ウェブサイトが認証されていることを確認する必要があります。以下の手順に従ってください：

  1. Google Search Consoleにログインします(アカウントを作成する必要があります）Google Search Consoleは、Googleが提供する無料のサービスで、Google検索結果におけるサイトの存在を監視し、維持するのに役立ちます。

  2. サインイン後、左上のオプションからプロパティを追加することができます。
    upload property GA
    すると、2つのオプションが表示されます：「ドメイン」または「URLプレフィックス」
    (新規アカウントを作成した場合は、すぐに以下のオプションが表示されます。)

–ドメイン:このオプションには、すべてのサブドメイン（例：m.、www.）と複数のプロトコル（例：http、https、ftp）が含まれます。あなたのウェブサイトのより広い範囲をカバーします。
–URLプレフィックス:このオプションは、プロトコル（http/httpsなど）を含め、指定した接頭辞を持つURLのみを含めます。ウェブサイトのURLの特定のサブセットに焦点を当てます。


Ga property

ドメインまたはURLのいずれかを入力して、ウェブサイトを正確に反映するオプションを選択します。選択すると、選択したドメインの検証方法に関する具体的な説明が表示されます。検証方法は、選択したオプションによって異なります。

検証プロセスでは、ドメイン名にDNSレコードを追加したり、ウェブホスティングにHTMLファイルをアップロードしたりする場合があります。提供される指示に従ってください。

ウェブサイトが認証されたら：おめでとう！
MatomoでGoogle検索キーワードのインポートを設定に進むことができます。

Google OAuthクライアントの設定方法

開始前の重要な注意事項:このステップでは、Googleにアプリを提出する必要はありません。アプリを送信するよう促され、「アプリを送信する」をクリックするオプションがない場合は、「アプリを送信する」をクリックしてください。いいえまたはキャンセルその際、重要なステップを見落としたり、必要のない情報を追加していないか、本ガイドのステップを再度ご確認ください。

OAuth 設定を変更する必要がある場合は、新しいOAuthクライアント認証情報をダウンロードし、Matomo にアップロードする必要があります。

以下の手順に従って、OAuth クライアント設定を取得し、Matomo Google Search Integration を使用してください：

  1. Google API コンソールにログインする

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

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

  4. 新しいプロジェクトに便利な名前を付けます。Matomo Search Integration).

  5. プロジェクトが作成されたら、プロジェクトリストから手動で選択し、「開く」をクリックします。

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

  7. 次にOAuth同意画面を設定します。上部のGoogleロゴの横にあるメニューアイコンをクリックし、左メニューのAPIとサービス > OAuth同意画面に移動します。External をクリックして作成をクリックします。

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

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

  10. ScopesとTest Usersの両方のステップで保存して続行するをクリックします

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

  12. ダッシュボードでPublishing Statusの下にあるPublish Appをクリックします

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

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

  15. Credentialsの作成をクリックします

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

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

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

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

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

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

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

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

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

おめでとうございます！これでMatomoのGoogle検索キーワードのインポートを設定に進むことができます。（このページのトップに戻って手順をご覧ください）