编辑“Open Web Analytics/Metrics创建”

{{Open Web Analytics top}}
'''Metrics,'''指标，是OWA框架中一个专用的对象，主要用来封装一个逻辑来产生分析指标，比如[[页面访问量]]、独立用户数等等。开发人员可以利用指标来产生将在统计报告中生成的数据，或者是可以通过数据导出[[API]]来访问的数据.
==新建一个Metric==
新建一个指标，我们需要新建一个owa_metric类；

下面的例子就基于OWA主要的请求实体（表）新建了pageView这个指标：
 <pre>class owa_pageViews extends owa_metric {
                function __construct() {
	        $this->setName('pageViews');
		$this->setLabel('Page Views');
		$this->setEntity('base.request');
		$this->setColumn('id');
		$this->setSelect(sprintf("count(distinct %s)", $this->getColumn()));
		$this->setDataType('integer');
		return parent::__construct();
	  }
}</pre>

==指标与实体的关系==
指标在OWA中是与一个单个的实体（或者称为数据库表）联系在一起的，这样指标计算就不会在不经意间加入到OWA的事实表中。因此，如果你想OWA可以从不同的数据库表中计算这些指标，那么实现和注册一个指标的多个实现就非常重要。

这通常用于实现指标的不同组合以及建立专门的汇总表的结果集。
==指标类的所在位置==
指标的类必须包含在它们自己的文件中，也就是在你为它们注册的module（模块）下的metrics子目录中，例如：
  /path/to/owa/modules/yourmodule/metrics/yourmetric.php
==注册一个新的指标==
指标实现是被注册在模块类构造函数中的，使用 registerMetric 模块方法，例如：
  $this->registerMetric('pageViews', 'base.pageViews');
这个例子将会为pageViews指标注册一个实现，而第二个函数参数是OWA中的一个简化的写法，代表的是使用在base模块下metric子目录下的一个叫做pageViews.php的文件。

==参考来源==
*http://wiki.openwebanalytics.com/index.php?title=Metrics

{{Open Web Analytics}}

[[category:Open Web Analytics]]