原文地址：https://developer.piwik.org/guides/data-model

此文中的内容和《Piwik数据库模式（一）》中相互参照

日志数据

HTTP跟踪API（即Piwik\Tracker组件）接收原始分析数据，我们称之为日志数据。

有四种类型的日志数据：

• 访问
• 动作类型
• 转换
• 电子商务项目

归档过程将日志数据聚合到归档数据中。

日志数据从不直接用于Piwik报告，而是使用归档数据。唯一的例外是使用日志数据生成实时报告的Live插件。

持久化

日志数据在PHP中表示为Piwik\Tracker\Visit对象，并存储到下表中：

log_visit 每次访问包含一个条目（返回访问者） log_action 包含网站上所有可能采取的行动（例如，唯一网址，网页标题，下载网址...） log_link_visit_action 每个行动的访客包含一个条目（页面浏览，...） log_conversion 包含访问期间发生的转化（与目标相符的操作） log_conversion_item 包含电子商务转换项目 这些表（及其相关的PHP实体）的内容将在“ 数据库架构”指南中进行更详细的介绍。

存档过程

日志数据不能直接用于最终用户报告，因为它需要在每次需要报告时处理大量的数据。

为了解决这个问题，归档过程将日志数据聚合到归档数据中。然后使用归档数据构建报告。

例

我们举一个例子，在一天内收到1000页浏览量的网站。该日志数据将与其他信息，例如，沿着这1000个的事件列表：

URL         Time     ...
/homepage   17:00:19 ...
/about      17:01:10 ...
/homepage   17:05:30 ...
/categories 17:06:14 ...
/homepage   17:10:03 ...
...

该归档过程汇总这些原始数据到归档数据。

例如，要构建每页视图数量的报告（查看最受欢迎的页面），归档将列出所有页面并总计每个页面的视图数量：

URL         Page views
/homepage   205
/categories 67
/about      5
...

该数据是归档数据。

虽然预计算档案数据对于1000页浏览量来说似乎是多余的，但是在处理较高数据量时并不是这样。

什么时候？

默认情况下，归档数据的计算和缓存点播。当请求具体报告时，Piwik将检查所需的存档数据是否存在，如果不存在则生成。

预归档 当跟踪网站流量很大时，按需归档可能需要太多时间。在这种情况下，必须禁用存档归档，并且预先归档需要在预定时间内在后台运行。

可以使用core:archiveconsole命令为每个站点和期间（自定义日期范围除外）运行预归档：

$ ./console core:archive

通常的设置是使用固定间隔运行该命令cron。

该命令将记住上次执行时，只有存在新的访问时才会存档网站。

怎么样？

日志数据被汇总到每个的归档数据中：

• 现场
• 期间：日，周，月，年或自定义日期范围（自定义日期范围不能预先归档）
• 分割 存档逻辑（即聚合日志数据的方式）由插件定义。由插件定义的所有报告都将归档而不是单独存档。

如果查询中没有分段，找不到数据，则每个插件的每个报告将一次生成并缓存。如果提供了一个段，则将生成和缓存属于与请求的数据相同的插件的报告。

期间聚合 归档数据的计算方式根据期间类型不同：

• “日”期是日志数据的聚合
• “周”，“月”，“年”和自定义日期范围是“日”报告的汇总 例如，通过聚合一周中的7天的归档数据创建一周的归档数据。这比聚合日志数据要快得多。

插件存档

要归档报表和指标的插件定义了一个Archiver扩展的类Piwik\Plugin\Archiver。此类将在归档过程中自动检测并调用。

日志数据聚合由LogAggregator类处理。归档数据聚合由ArchiveProcessor::aggregateDataTableRecords()and ArchiveProcessor::aggregateNumericMetrics()方法处理。

插件可以访问LogAggregator和ArchiveProcessor实例Piwik\Plugin\Archiver。

要了解有关Piwik的MySQL后端如何实现聚合的更多信息，请阅读数据库模式。

持久存档数据

存档数据使用ArchiveProcessor。

使用度量标准插入insertNumericRecord()。

报告首先使用序列化DataTable::getSerialized()，然后插入ArchiveProcessor::insertBlobRecord()：

// insert a numeric metric
$myFancyMetric = // ... calculate the metric value ...
$archiveProcessor->insertNumericRecord('MyPlugin_myFancyMetric', $myFancyMetric);

// insert a record (with all of its subtables)
$maxRowsInTable = Config::getInstance()->General['datatable_archiving_maximum_rows_standard'];j

$dataTable = // ... build by aggregating visits ...
$serializedData = $dataTable->getSerialized(
    $maxRowsInTable,
    $maxRowsInSubtable = $maxRowsInTable,
    $columnToSortBy = Metrics::INDEX_NB_VISITS
);

$archiveProcessor->insertBlobRecords('MyPlugin_myFancyReport', $serializedData);

持续的报告和指标由网站ID，期间和分段索引。归档的日期和时间也附在数据上。要了解MySQL如何完成此细节，请参阅数据库架构。

报告与记录

当报告被归档时，它被称为不是报告的记录。我们有区别，因为有时可以从一个记录生成多个报告。

例如，UserSettings插件使用一个记录来保存访问者的浏览器详细信息。此记录用于生成UserSettings.getBrowserVersion和UserSettings.getBrowser报告。第二份报告只是处理第一份报告。该插件可以归档这两个报告，但是这将大大浪费空间，考虑到新的报告将被缓存为每个网站/期间/段组合。

记录存储准则

必须注意尽可能少的存放记录。在将记录作为归档数据插入之前，请务必遵循以下准则： 记录不应与字符串列名一起存储。相反，它们应该被替换为整数列ID（有关现有列表的列表，请参阅Metrics）。 可以使用现有数据添加的元数据不应与报告一起存储。相反，当将记录转换为报告时，应将其添加到API方法中。

归档数据

归档数据是在创建归档过程中通过汇总日志数据。

Piwik聚合并持续存在两种类型的存档数据：

度量，它们是单个数值
报告，是二维数组的值

报告通常包含指标值，但它们也可以包含其他数据（额外地或代替度量值）。

报告和指标由插件定义，允许任何插件扩展Piwik分析的数据。然而，有几个称为核心指标的指标，由Piwik Core定义。

子集参数

报告和指标提供关于一组事物的分析数据。该集合由三个约束定义：

一个网站ID
一段时间
一段

该网站的ID选择被跟踪特定网站的访问。该ID在具有idSitequery参数的所有HTTP请求中指定。

的期间，选择被跟踪的特定日期范围内的访问。所有HTTP请求中指定的时间段date与period查询参数。

该段根据使用访问属性的布尔表达式选择访问。它在所有HTTP请求中由segmentquery参数指定，可用于选择几乎任何可能的访问子集。

Analytics（分析）参数作为元数据存储在报表中，这意味着它们作为DataTable元数据存储。

度量

核心指标 核心指标是不是由插件定义的，而是Piwik Core。

分析访问次数，操作类型或转化次数的新报告应包含这些指标。

访问指标

一组访问的核心指标：

行动指标

单一动作类型的核心指标：

电子商务指标

针对一组访问记录的一组电子商务转换（所有订单或所有已放弃购物车）的核心指标：

目标指标

一组访问的核心指标和网站的一个目标：

注意：应替换为目标的ID。

目标具体指标存储在goals序列化报告列中的数据库中。该列包含一个PHP数组，将目标ID与目标特定度量值的数组进行映射。这些值被设置为具有上述由AddColumnsProcessedMetricsGoal DataTable过滤器描述的度量名称的普通列值。

已处理的指标

为了归档和数据库大小的效率，一些指标不存储在数据库中。而是在需要时使用其他指标来计算。这些指标称为处理指标。

以下是使用核心指标计算的已处理指标列表。分析访问次数，操作类型或转化次数的新报告应尽可能添加这些指标。

注意：以下列表中会显示多个已处理的指标。这些指标根据他们所在的报告有不同的含义。

一组访问的处理指标：

单个操作类型的已处理指标：

针对一组访问记录的电子商务订单集的处理指标：

一组订单或废弃购物车中电子商务集合的处理指标：

以下是一个特定于一个网站的一个目标的已处理指标列表：

命名约定

由插件计算和持久化的度量必须使用以下格式命名：PluginName_metricName。例如：MyPlugin_myFancyMetric。

核心指标具有特殊名称，不符合此惯例。

报告

报告使用DataTable类存储在内存中。A DataTable是由行和列组成的二维数组。

每行都包含与一组访问，操作，转换相关的度量...该集合由特殊标签列定义和描述。列描述的集合完全取决于具体的报告。例如，在UserSettings.getBrowser报告中，带有Firefox标签的行将包含使用Firefox浏览器的访问指标。

一些报告VisitsSummary.get就不会有一个标签列：它们只有一行引用整个实体集。

报告元数据

除了指标之外，每一行还可以包含元数据。这个元数据通常会帮助标签列描述行代表的事物集。

一些元数据在Piwik有特殊的含义，例如：

logo：该值可以是将在UI中的每一行旁边显示的图像的路径
url：该值可以是该行将在UI中链接到的URL

子表

报表可以是层次结构的：每行都可以附加到另一个DataTable。附加到行的表称为子表。

子表为行所代表的一组访问提供进一步的分析。例如，Referrers.getSearchEngines报告每个搜索引擎有一行。每行都有一个子表，描述与该搜索引擎一起使用的关键字。以下是一个示意图：

Search Engine  Keyword (subtable)  Visitors
--------------|-------------------|----------
Google                            | 207
--------------|------------------------------
              | piwik             | 11
              | libre analytics   | 6
              | ...
---------------------------------------------
Duck Duck Go                      | 121
--------------|------------------------------
              | ...

命名约定

必须将报告命名为指标如下：PluginName_reportName。例如：MyPlugin_myFancyReport。