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

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

インストール

Gemfile に piwik_analytics の Gem を追加します。:

以下を実行することを忘れないでください。

! 次にジェネレータを実行します。:

これにより、アプリケーションの config ディレクトリにpiwik.yml設定ファイルをインストールします。

設定

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

# Configuration:
#
# disabled
#   false if tracking tag should be shown
# use_async
#   Set to true if you want to use asynchronous tracking
# url
#   The url of your piwik instance (e.g. localhost/piwik/
# id_site
#   The id of your website inside Matomo(Piwik)
#
production:
  piwik:
    id_site: 1
    url: piwik-production.example.com
    use_async: false
    disabled: false

development:
  piwik:
    id_site: 1
    url: piwik-development.example.com
    disabled: true
    use_async: false

test:
  piwik:
    id_site: 1
    url: localhost
    disabled: true
    use_async: false

見て分かるように、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 閉じタグの前に次のコードを追加できます。

Gem をテストするときには disabled: false となっていることを確認します。

piwik_analytics のサポートを受ける

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

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

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