php - Piwik中特定事件 Action 的查询计数

Question

我需要使用 Piwik 为我的组织制作一个小部件/插件，但我有点迷路了。我们向 Piwik 发送自定义事件，例如:

Category: Staff 
Action: Login 

我如何从小部件/插件中查询 piwik 以获取与特定类别/操作匹配的事件数？

Answer 1

这是关于 Events API 的文档.

您可能会对以下两种方法感兴趣:

• Events.getCategory
• Events.getAction

它们将返回映射到 nb_uniq_visitors、nb_visits 和 nb_events 的操作/类别列表。

nb_events 可能是您应该用来获取每个类别或操作的事件数的那个。以下是事件类别列表的查询示例:

http://demo.piwik.org/?module=API&method=Events.getCategory&idSite=7&period=day&date=today&format=xml&token_auth=anonymous

请注意，您并不特别需要为此编写 Piwik 插件，您只需要查询 Reporting API .但是，如果您想在 Piwik 中显示这些数字，那么您确实需要编写一个插件。

---

编辑:您想知道如何从自定义 Piwik 插件中获取该列表。

看看 Calling APIs of other plugins文档。在您的情况下，您必须像这样调用 Events API:

$table = \Piwik\API\Request::processRequest('Events.getCategory', array(
    'idSite' => $idSite,
    'period' => $period,
    'date'   => $date,
));

获得表格后，您可以找到您感兴趣的行:

$row = $table->getRowFromLabel('Staff');

然后获取该期间的事件数:

$numberOfEvents = $row->getColumn('nb_events');

请注意，您还可以优化对 API 的调用以过滤并仅获取您正在搜索的标签和您正在使用的列:

$table = \Piwik\API\Request::processRequest('Events.getCategory', array(
    'idSite'      => $idSite,
    'period'      => $period,
    'date'        => $date,
    'label'       => 'Staff',
    'showColumns' => 'nb_events',
));