表单分析JavaScript跟踪API参考

本指南是JavaScript跟踪API参考形式分析．

您可能还对表单分析感兴趣HTTP API报告参考．

调用Form Analytics跟踪器方法

在matomo.js跟踪器我们区分两种方法:

• 调用一个跟踪器实例方法只影响特定的Matomo(以前是Piwik)跟踪器实例。在文档中，当方法名包含单个点(．)，例如FormAnalytics.disable．
• 调用一个静态方法影响所有创建的跟踪器实例。在文档中，当方法名包含时，可以识别静态方法：：例如，FormAnalytics: scanForForms．

在大多数情况下，只有一个Matomo跟踪器将被使用，所以唯一的区别是你如何调用该方法:

• 跟踪器方法调用via_paq.push ([FormAnalytics。$ methodName ']);或者直接在跟踪器实例上。Matomo.getAsyncTracker () .FormAnalytics。$ methodName ()．
• 静态方法调用via_paq.push ([' FormAnalytics:: $ methodName ']);或者直接在Matomo。FormAnalytics对象,如。Matomo.FormAnalytics。$ methodName ()．

如果您不想使用_paq.push方法，您可以定义window.matomoFormAnalyticsAsyncInit方法，该方法在表单跟踪器初始化后立即调用:

window.matomoFormAnalyticsAsyncInit= function () { Matomo.FormAnalytics.disableFormAnalytics(); };

静态方法

scanForForms (documentOrHTMLElementToScanForForms)．

默认情况下，Matomo自动检测您网站上的所有表单。如果在页面加载后修改DOM(例如在单页web应用程序中)，您可能需要调用此方法以确保Matomo找到您的所有表单。当您调用此方法时，Form Analytics跟踪器将在DOM中搜索新表单并开始跟踪这些表单。作为参数，您可以选择传递HTMLElement如果只搜索DOM的一部分以寻找新表单。这对于单页web应用程序特别有用。如果没有给出这样的参数，整个DOM将搜索新的表单元素。

例子:

_paq.push ([' FormAnalytics:: scanForForms ']);_paq.push(['FormAnalytics::scanForForms', document.getElementById('test')]); // or Matomo.FormAnalytics.scanForForms(); Matomo.FormAnalytics.scanForForms(document.getElementById('test'));

trackForm (formElement)

这个方法几乎和scanForForms．然而,scanForForms将只检测窗体，要么是形式元素,data-matomo-form属性，或data-piwik-form属性。如果其中一个表单都不是这两种情况，则可以使用此方法确保Matomo将跟踪该元素中所有表单字段的数据。建议设置data-matomo-name或者一个data-piwik-name属性来让Matomo知道您的表单的名称。

trackFormSubmit (formElement)

默认情况下，Matomo将自动监听表单提交事件。如果你没有使用形式元素，你可能需要通过调用这个方法让Matomo知道何时提交了表单:

 提交< / >

  提交< / >

_paq.push ([' FormAnalytics.disable ']);//如果你正在使用多个Matomo跟踪器，并且只想为特定的跟踪器禁用它:var tracker = Matomo。getTracker (matomoUrl matomoSiteId);tracker.FormAnalytics.disable ();

你可能会感兴趣表单分析HTTP API参考．