piwik_analytics は Rails 3.x における Ruby の Gem です。サーバーに Matomo(Piwik) をインストールしてウェブサイトを作成した後、ウェブサイトに埋め込む JavaScript のトラッキングタグを取得します。多くの場合 Rails では、トラッキングタグは application.html.erb ビューに埋めこまれます。ビューにトラッキングタグを含めるのはそんなに簡単ではありません。

piwik_analytics の gem は、ビューテンプレートをめちゃくちゃにしなくても、アプリケーションに Matomo(Piwik) を含めるための簡単​​な方法を提供します。

インストール

Gemfile に piwik_analytics の Gem を追加します。:
[info_box]
gem 'piwik_analytics', '~> 1.0.1'
[/info_box]
以下を実行することを忘れないでください。
[info_box]bundle install
[/info_box]
! 次にジェネレータを実行します。:
[info_box]
rails g piwik_analytics:install[/info_box]
これにより、アプリケーションの config ディレクトリにpiwik.yml設定ファイルをインストールします。

設定

config/piwik.yml を開いて、設定を編集します。各設定は、設定ファイル自体に記述されています。

見て分かるように、Matomo(Piwik) のデフォルトでは本番モードで有効になっています。 disabled: false と設定することにより、開発環境やテスト環境で Matomo(Piwik) を有効にすることもできます。次に、Matomo(Piwik) から追跡したいWebサイトのサイトIDを取得する必要があるでしょう。Matomo(Piwik) のインストールにログインし、”設定”に移動して、 “Webサイト”タブをクリックします。

Matomo(Piwik) のサイトID

この場合、サイトIDは “1”です。最後のステップとして、Matomo(Piwik) のインストールの URL を設定する必要があります。 Matomo(Piwik) が http://example.com/piwik/ でホストされている場合は、 example.com/piwik （最後のスラッシュなし）に URL を設定する必要があります。

Matomo(Piwik) はバージョン1.1から 非同期トラッキング スクリプトをサポートしています。 アプリケーションで非同期トラッキングを使用したい場合には、単に use_async: true と設定します。

用法

Gem は、トラッキングタグを出力するシンプルなヘルパーを提供しています。 application.html.erb (or haml, slim) 内で、シンプルに body 閉じタグの前に次のコードを追加できます。
[info_box]<%= piwik_tracking_tag %>[/info_box]
Gem をテストするときには disabled: false となっていることを確認します。

piwik_analytics のサポートを受ける

サポート、追加情報は？:

• プロジェクトページ (GitHubの登録が必要、英語)をご覧ください
• イシュートラッカー (GitHubの登録が必要、英語)をご覧ください
• また、私の個人的なブログ geekmonkey.org, と ソースをチェック

この記事は日本Matomo(Piwik)ユーザー会によって翻訳されました。