原文地址：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个的事件列表： ```shell URL Time ... /homepage 17:00:19 ... /about 17:01:10 ... /homepage 17:05:30 ... /categories 17:06:14 ... /homepage 17:10:03 ... ... ``` 该归档过程汇总这些原始数据到归档数据。 例如，要构建每页视图数量的报告（查看最受欢迎的页面），归档将列出所有页面并总计每个页面的视图数量： ```shell URL Page views /homepage 205 /categories 67 /about 5 ... ``` 该数据是归档数据。 虽然预计算档案数据对于1000页浏览量来说似乎是多余的，但是在处理较高数据量时并不是这样。 ##### 什么时候？ 默认情况下，归档数据的计算和缓存点播。当请求具体报告时，Piwik将检查所需的存档数据是否存在，如果不存在则生成。 预归档 当跟踪网站流量很大时，按需归档可能需要太多时间。在这种情况下，必须禁用存档归档，并且预先归档需要在预定时间内在后台运行。 可以使用core:archiveconsole命令为每个站点和期间（自定义日期范围除外）运行预归档： ```shell $ ./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()： ```php // 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聚合并持续存在两种类型的存档数据： ```shell 度量，它们是单个数值 报告，是二维数组的值 ``` 报告通常包含指标值，但它们也可以包含其他数据（额外地或代替度量值）。 报告和指标由插件定义，允许任何插件扩展Piwik分析的数据。然而，有几个称为核心指标的指标，由Piwik Core定义。 ##### 子集参数 报告和指标提供关于一组事物的分析数据。该集合由三个约束定义： ```shell 一个网站ID 一段时间 一段 ``` 该网站的ID选择被跟踪特定网站的访问。该ID在具有idSitequery参数的所有HTTP请求中指定。 的期间，选择被跟踪的特定日期范围内的访问。所有HTTP请求中指定的时间段date与period查询参数。 该段根据使用访问属性的布尔表达式选择访问。它在所有HTTP请求中由segmentquery参数指定，可用于选择几乎任何可能的访问子集。 Analytics（分析）参数作为元数据存储在报表中，这意味着它们作为DataTable元数据存储。 ##### 度量 核心指标 核心指标是不是由插件定义的，而是Piwik Core。 分析访问次数，操作类型或转化次数的新报告应包含这些指标。 ##### 访问指标 一组访问的核心指标： |名称 | 公制编号 | 描述 | |:------------ :| :------------ :| |访问 | nb_visits | 跟踪访问次数 一次访问是一系列事件，每次事件发生不超过30分钟。 | |独特的访客 | nb_uniq_visitors | 唯一访问来源的数量。访问来源是一个导致访问的实体。 | |操作 | nb_actions | 跟踪的动作数量。一个行动是Piwik跟踪的一个事件。 | |最大行动 | max_actions | 一次访问中发生的最大操作次数。 | |总访问长度 | sum_visit_length | 每次访问的总和时间。 | |反弹计数 | bounce_count | 仅由一个动作组成的访问次数。 | |转换访问 | nb_visits_converted | 导致至少一次转化的访问次数。包含网站每个目标的转化。 | |转换 | nb_conversions | 此次访问跟踪的转化次数。包含网站每个目标的转化。 | |收入 | revenue | 这些访问产生的总收入。 包括网站的每个目标的收入以及电子商务收入。 | ##### 行动指标 单一动作类型的核心指标： |名称|公制编号|描述| | :------------ | :------------ | |点击|nb_hits|这个动作曾经完成的次数。| |总和花费时间|sum_time_spent|用户花费这个操作的总时间。| |总和页面生成时间|sum_time_generation|服务器花费这项操作的总时间。| |点击与生成时间|nb_hits_with_time_generation|包含生成时间信息的命中数。| |最小页面生成时间|min_time_generation|服务器为此操作服务的最短时间。| |最大页面生成时间|max_time_generation|服务器花费此操作的最长时间。| |独特出境游客|exit_nb_uniq_visitors|在此行动之后退出网站的唯一身份访问者人数。| |退出访问|exit_nb_visits|通过此操作结束的总访问次数。| |独特的入场访客|entry_nb_uniq_visitors|通过此操作开始访问的唯一身份访问者总数。| |入场访问|entry_nb_visits|以此操作开始的总访问次数。| |进入动作|entry_nb_actions|| |入场和访问长度|entry_sum_visit_length|每次入场访问的总和经过时间。| |入场反弹计数|entry_bounce_count|由这个动作组成的访问次数，没有其他。| |点击搜索|nb_hits_following_search|在网站搜索后执行此操作的次数。| ##### 电子商务指标 针对一组访问记录的一组电子商务转换（所有订单或所有已放弃购物车）的核心指标： |名称|公制编号|描述| | :------------ | :------------ | |收入小计|revenue_subtotal|作为这些订单或弃车的一部分的每个项目的总成本。| |税收收入|revenue_tax|适用于这些订单/弃车的总税额。| |收入运费|revenue_shipping|运送到这些订单/废弃车的运输总量。| |收入折扣|revenue_discount|这些订单/弃车的折扣总额。| |电子商务计数|items|这些订单/弃车的物品总数。 ##### 目标指标 一组访问的核心指标和网站的一个目标： |名称|公制编号|描述| | :------------ | :------------ | |目标转换|goal_<idGoal>_nb_conversions|针对特定目标跟踪此次访问的转化。| |目标收入|goal_<idGoal>_revenue|特定目标的转化所产生的总收入。| 注意：<idGoal>应替换为目标的ID。 目标具体指标存储在goals序列化报告列中的数据库中。该列包含一个PHP数组，将目标ID与目标特定度量值的数组进行映射。这些值被设置为具有上述由AddColumnsProcessedMetricsGoal DataTable过滤器描述的度量名称的普通列值。 ##### 已处理的指标 为了归档和数据库大小的效率，一些指标不存储在数据库中。而是在需要时使用其他指标来计算。这些指标称为处理指标。 以下是使用核心指标计算的已处理指标列表。分析访问次数，操作类型或转化次数的新报告应尽可能添加这些指标。 注意：以下列表中会显示多个已处理的指标。这些指标根据他们所在的报告有不同的含义。 一组访问的处理指标： |名称|公制编号|描述| | :------------ | :------------ | |兑换率|conversion_rate|至少有一次转化的访问百分比。| |每次访问行动|nb_actions_per_visit|单次访问的平均动作次数。| |平均停机时间|avg_time_on_site|平均每次访问所花费的时间（秒）。| |跳出率|bounce_rate|导致反弹的访问百分比。| 单个操作类型的已处理指标： |名称|公制编号|描述| | :------------ | :------------ | |平均生成时间|avg_time_generation|服务器提供此操作所需的平均时间。| |浏览的平均搜索结果页数|nb_pages_per_search|在网站搜索后查看的搜索结果页的平均数量。仅适用于网站搜索关键字和网站搜索类别。| |平均时间页|avg_time_on_page|用户花费这个时间的平均时间。| |入场跳出率|bounce_rate|所有访问的百分比组成的这个动作，没有其他。| |退出率|exit_rate|以此动作结束的所有访问的百分比。| 针对一组访问记录的电子商务订单集的处理指标： |名称|公制编号|描述| | :------------ | :------------ |平均订单收入|avg_order_revenue|每个订单的平均收入。| 一组订单或废弃购物车中电子商务集合的处理指标： |名称|公制编号|描述| | :------------ | :------------ |平均价格|avg_price|每个项目的平均价格。| |平均数量|avg_quantity|订单/已放弃购物车中每个商品的平均数量。| |产品转化率|conversion_rate|包含此项目的订单/弃车的百分比。| 以下是一个特定于一个网站的一个目标的已处理指标列表： |名称|公制编号|描述| | :------------ | :------------ |每次访问平均收入|goal_<idGoal>_revenue_per_visit|为此目标每次访问所产生的平均收入金额。| ##### 命名约定 由插件计算和持久化的度量必须使用以下格式命名：PluginName_metricName。例如：MyPlugin_myFancyMetric。 核心指标具有特殊名称，不符合此惯例。 #### 报告 报告使用DataTable类存储在内存中。A DataTable是由行和列组成的二维数组。 每行都包含与一组访问，操作，转换相关的度量...该集合由特殊标签列定义和描述。列描述的集合完全取决于具体的报告。例如，在UserSettings.getBrowser报告中，带有Firefox标签的行将包含使用Firefox浏览器的访问指标。 一些报告VisitsSummary.get就不会有一个标签列：它们只有一行引用整个实体集。 ##### 报告元数据 除了指标之外，每一行还可以包含元数据。这个元数据通常会帮助标签列描述行代表的事物集。 一些元数据在Piwik有特殊的含义，例如： ```shell logo：该值可以是将在UI中的每一行旁边显示的图像的路径 url：该值可以是该行将在UI中链接到的URL ``` ##### 子表 报表可以是层次结构的：每行都可以附加到另一个DataTable。附加到行的表称为子表。 子表为行所代表的一组访问提供进一步的分析。例如，Referrers.getSearchEngines报告每个搜索引擎有一行。每行都有一个子表，描述与该搜索引擎一起使用的关键字。以下是一个示意图： ```shell Search Engine Keyword (subtable) Visitors --------------|-------------------|---------- Google | 207 --------------|------------------------------ | piwik | 11 | libre analytics | 6 | ... --------------------------------------------- Duck Duck Go | 121 --------------|------------------------------ | ... ``` ##### 命名约定 必须将报告命名为指标如下：PluginName_reportName。例如：MyPlugin_myFancyReport。