MatomoでユーザーIDトラッキングを設定する

2025年01月21日ユーザーID レポート追跡する

ユーザ ID 機能を有効にするには、Matomo にユーザ ID を送信する必要があります。まず、ユーザ ID として使用できる各ユーザのデータを特定する必要があります。ログインを許可するすべての Web サイトシステムは、ユーザを区別するために使用する一意の識別子を少なくとも 1 つ持つ必要があります。これは、一意の番号、ユーザー名、または単にユーザーの電子メールアドレスかもしれません。

可能であれば、ユーザーのメールアドレスをユーザーIDとして設定することをお勧めします。これは、同じユーザーがコンタクトフォームや購読フォームに入力した際、ログアウトしていても追跡できるようにするためです。

次のステップは、この一意の識別子を Matomo Analytics に送信することです。正確な方法は、サイトの構築方法によって異なります。以下に、さまざまな方法のステップバイステップの手順を示します。

WordPressでユーザーIDトラッキングを設定する方法

WordPressを使用している場合、Matomoと統合するには主に2つの方法があります。ひとつめはMatomo for WordPress公式プラグインを使用する方法で、Matomoは、WordPressのインストール内に存在します。この場合、以下の Matomo for WordPress ガイドに従ってください。

あるいはMatomoクラウドまたはMatomo オンプレミスを使用している場合、WordPressを統合するために、WP-Matomoプラグインを使用することになるでしょう。この場合、必要な手順は以下の2番目のガイドに記載されています。

注：WordPressユーザーは通常、メールアドレスを変更できますが、ユーザー名は変更できません。以下のガイドで一意な識別子を選択する際にユーザー名を使用してください。しかし、ログアウトしたユーザーのフォーム送信からもユーザーIDを取得したい場合は、代わりにメールアドレスを使用してください。

WordPress用Matomo：ユーザーIDトラッキングを有効にする方法

WordPressのダッシュボードに管理者アカウントでログインします。
メニューの「Matomo Analytics」にカーソルを合わせ、サブメニューの「設定」をクリックします。
ユーザーIDドロップダウンメニューまでスクロールダウンし、メールアドレスまたはユーザー名を選択します。
下の青い「変更を保存」ボタンをクリックすると、ユーザーIDトラッキングが有効になります。

Connect Matomo (WP-Matomo, WP-Piwik)：ユーザーIDトラッキングを有効にする方法

WordPressのダッシュボードに管理者アカウントでログインします。
メニューの「Settings」にカーソルを合わせ、「Connect Matomo」をクリックします。
Enable Trackingタブをクリックします。
トラッキングコードを追加する設定で、手動ではないトラッキング方法を有効にします。
ユーザーIDトラッキング設定までスクロールダウンし、ドロップダウンでメールアドレスまたはユーザー名を選択します。
青い「変更を保存」ボタンをクリックすると、すぐにユーザーIDのトラッキングが開始されます。

MatomoタグマネージャでユーザーIDトラッキングを設定する方法

Matomo Tag ManagerでユーザIDトラッキングを設定する方法は、ウェブサイトの構築方法によって異なります。ウェブサイトのコードにユーザIDを含める標準的な方法はありませんので、ご自身で設定するか、開発者のサポートを受ける必要があります。

Matomo Tag Managerをインストールし、設定します。
詳細はこちらMatomo Tag Managerの使い方についてはこちらをご覧ください。
各訪問者の固有のユーザー識別子を取得するUserIDという変数を作成します。
サイトのフロントエンドにユーザー名を表示する場合は、ユーザーがログインしている間にHTML DOMセレクタから変数を作成したいと思うかもしれません。あるいは、より柔軟な方法として、電子メールアドレスのようなユーザー固有の識別子をデータ層を少しカスタムコードで追加することができます。ユーザの電子メールアドレスが一貫して読み取られ、Matomoに追跡されるようにするための最も簡単な方法は、まずファーストパーティークッキーに訪問者の電子メールアドレスの値を含むクッキーを持つようにウェブサイトを構築することです。その後、Matomo で、Matomo タグマネージャ変数をファーストパーティークッキーから直接読み取るように設定します。あるいは、ブラウザのローカルストレージにメールアドレスを保存する方法もあります。この場合、カスタム Javascript 変数を使用して、ローカルストレージから値を取得し、タグマネージャの変数として使用する必要があります。
UserIDを収集するためにMatomo Configuration変数を作成または更新します。
最後のステップでUser ID変数にUserIDという名前を付けたと仮定すると、User IDテキストフィールドまでスクロールダウンし、{{UserID}}と入力することで、その変数で取得した値をMatomoのトラッキング設定に取り込むことができます。
更新した Matomo コンテナをプレビューして公開します。
プレビュー中にウェブサイトにアクセスすると、画面の下半分に Matomo Tag Manager のデバッグ画面が表示されます。この中で Variables タブをクリックし、UserID 変数が Matomo Tag Manager に正しく拾われていることを確認できます。確認できたら、コンテナを公開してユーザIDのトラッキングを開始します。

JavaScriptクライアントでユーザーIDを送信する方法

完全にカスタム化されたウェブサイトをお持ちの場合、JavascriptトラッキングAPI.を介してユーザ ID を Matomo に送信する JavaScript スニペットをウェブサイトに追加することができます。これを行うには、以下のコードにユーザの一意な識別子を追加します：

_paq.push(['setUserId', 'USER_ID_HERE']);

上の例では、_paq.push([ ]);でMatomoにデータを送信しています。setUserId’ は、送信されるデータを定義し、第2引数 ‘USER_ID_HERE’ に、現在ページを見ている訪問者の一意なユーザ ID を動的に含めるように設定します。このコードは、Matomo トラッキングコードの中で、トラッキングするアクションの上に記述します。

例えば、標準的なMatomoのページビュートラッキングコード内の上記のコードは、次のようになります：

<!-- Matomo -->
<script type="text/javascript">
  var _paq = window._paq = window._paq || [];
  _paq.push(['setUserId', 'USER_ID_HERE']);
  _paq.push(['trackPageView']);
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="//{$MATOMO_URL}/";
    _paq.push(['setTrackerUrl', u+'matomo.php']);
    _paq.push(['setSiteId', {$IDSITE}]);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.type='text/javascript'; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
  })();
</script>
<!-- End Matomo Code -->

この方法の詳細についてはユーザIDに関する開発者向けドキュメントを参照してください。.

Matomo SDKでユーザーIDを送信する方法

アプリで使用できる Matomo Software Development Kits (SDK) がいくつかあります。例えばiOS SDKやAndroid SDKのようなものを使用している場合、通常、ユーザIDをパラメータとしてAPI関数setUserIdを呼び出す必要があります。また、Tracking HTTP APIを利用することもできます。

技術情報