表单分析开发人员常见问题解答

本页是开发人员常见问题解答形式分析．你可能还会对表单分析用户常见问题解答．

我有一个单页网站或web应用程序，我如何重新扫描DOM，以找到在初始页面加载后添加的新表单或表单字段，例如通过Ajax / XHR?

你可以像这样重新扫描整个文档寻找新的表单:

_paq.push ([' FormAnalytics:: scanForForms ']);

如果你只更新了网页的一部分，你可以通过传递一个DOM元素作为第二个参数来搜索新添加的表单和表单字段:

var updatedElement = document.getElementById('justUpdatedElement');_paq。推动([FormAnalytics:: scanForForms, updatedElement]);

如何强制表单或字段名?

当Matomo(以前是Piwik)在页面上发现一个表单时，它会读取的名字而且id属性。

…
 

对于表单，Matomo将阅读两个表单的名字和形式id以匹配您在Matomo中配置的任何表单。对于表单字段，Matomo将首先检查是否存在的名字属性，如果未设置值，则使用该字段id属性作为退路。

一些网站或应用程序使用随机名称，这些名称总是会变化，例如:

//第一个请求<表单名称="349391ac34f">…  // next request 
…
 

方法设置一个始终保持相同的固定名称data-matomo-name(推荐)或data-piwik-name属性:

…
 

请注意，如果名称总是相同，您不必设置自定义名称:在Matomo本身，您可以映射一个神秘的名称，如input_4到一个人类可读的名称，如“用户名”，而无需更改您的网站。

如何防止表单或表单字段被跟踪?

当不希望跟踪表单或表单字段时，只需添加data-matomo-ignore(推荐)或adata-piwik-ignore属性设置为要忽略的表单或字段。如果忽略整个表单，Matomo甚至不会为该表单发送任何跟踪请求。

<形式data-matomo-ignore >…  .

当我们的网站不使用表单元素时，我们如何用Matomo跟踪表单?

通常，表单被包装在形式元素。然而，情况并非总是如此。属性仍然可以自动跟踪此类表单data-matomo-form(推荐)或adata-piwik-form属性设置为包含所有表单字段的元素:

或者，也可以指示Matomo手动跟踪表单: