それではブログシリーズの新しい記事、Piwik プラットフォームの機能を紹介します(以前の記事は コマンドを作成する方法)。今回はテスト データを生成する方法を学びます。

通常、開発者は実際のPiwikインストールと比較して役に立つデータを含まないローカルなPiwik上で、開発しています。（2、3のテスト訪問と数人のテスト・ユーザーとウェブサイトだけ）‘VisitorGenerator’プラグインは、訪問、ウェブサイト、ユーザー、目標および以上の任意の番号を生成することができます。何でも簡単にテストすることができるように、データがレポートごとにあることを、ジェネレーターは確認します。

はじめに

このシリーズでは既に Piwik がインストールされていることを想定しています。まだの場合は、Piwik の開発者サイトにアクセスし、セットアップチュートリアルを探してください。

VisitorGenerator プラグインをインストールします

プラグインをインストールする最も簡単な方法は、Piwik自体にマーケットプレースを使用することです。設定=> マーケットプレース => 新しい機能 にアクセスします。ここでインストールしてワンクリックで有効にできるプラグイン “VisitorGenerator” を見つけることができます。

Piwikのインスタンスがインターネットに接続されていない場合は、マーケットプレイスVisitorGeneratorページからプラグインをダウンロードすることができます。その後、プラグインの 設定 => マーケットプレース => アップロード に行くと、以前にダウンロードした ZIP ファイルをアップロードするプラグインをインストールすることができます。

プラグインの確認を既にインストールしている場合は 設定 => プラグイン に行くことによってアクティブになります。

Web サイトを生成する

プラグインをインストールした後、テストに必要なだけのウェブサイトを追加することができます。これは例えば ‘All Websites’ ダッシュ ボードまたは web サイト マネージャーなど多くのウェブサイトに影響を与える何かをテストするときに役立ちます。

任意の数のウェブサイトを生成するには次のコマンドを使用します：

./console visitorgenerator:generate-website --limit=10

これで10個のウェブサイトが生成されます。より多くのウェブサイトが必要な場合は、単純に上限を指定します。疑問に思っている場合に備えて、ウェブサイトの名前とURLはFaker PHPライブラリーによってランダムに発生します。

目標の生成

目標に関連して何かをテストする場合に、次のコマンドを実行する必要があります。

./console visitorgenerator:generate-goals --idsite=1

指定されたサイトのいくつかの目標が生成されます。生成された目標は、次の手順での訪問を生成するときに変換があるかどうかを確認する方法で定義されます。

ビジットの生成

訪問を生成するには2つの方法が考えられます。Piwik UI を通じて 設定 => ビジター に行くか、 コマンドラインを使用するかのいずれかです

The UI is a bit limited in generating visits so we recommend to use the command line.
UIは訪問を生成する際に少し制限されていますので、コマンドラインを使用することをお勧めします。

以下のように、訪問を生成することができます:

./console visitorgenerator:generate-visits --idsite=1

これで、現在の日付の多数の異なる訪問を生成します。デフォルトで相当な数の訪問を挿入しますので時間がかかる場合もありますが、心配しないでください。過去に同様に複数の日に訪問を引き起こしたい場合に備えて--daysオプションを指定することができます。

./console visitorgenerator:generate-visits --idsite=1 --days=5

独自のログを提供

発生する訪問の半分はランダムに発生し、後の半分はデータがレポートごとにあることを確認するために実際のログに基づきます。
現実的なテスト用ログに基づいての訪問を生成する場合だけ plugins/VisitorGenerator/data フォルダーに.log で終わるログファイルを置いてください。VisitorGenerator データ フォルダーのいくつかの例を検索できます。

実際のログファイルだけに基づいて訪問を生成するには、その後 --no-fake オプションを使用しています。

./console visitorgenerator:generate-visits --idsite=1 --no-fake

すべての生成された訪問は、ログとランダムではない訪問、あるいはランダムな偽のデータが使用されます。

高度な機能

我々は開発者としてのあなたの作業をより簡単にするために、新しいコマンド、ツールと実行時チェックを定期的に加えています。たとえばユーザーと注釈を生成できます。今後は、リアルタイムレポートで常に新しいアクションがあるだろうことを確認し、バックグラウンドでの訪問を作成するためのプラグインを拡張したいと思います。

開発者としてあなたの作業を容易にするジェネレーターの任意の種類や他の機能が不足しているでしょうか？メールで教えてください！

Piwik プラットフォームについてもっと知りたいですか？プラグインやテーマを開発する方法についてのガイドは Piwik 開発者ゾーンを参照してください。

Thomas Steur