d3e940208e
* Build experimental package CSS with webpack. * Move style-only webpack config to reusable private package. * Update other packages to use webpack for style builds. * Add tsbuildinfo to clean scripts. * Fix main start script. * Remove defunct package build scripts. * Move client/ dependencies for style builds. * DRY. * Remove defunct IE stylesheet definitions. * Add missing RTL setup for onboarding styles. * No need to export a function. * Add changelog. * Fix README. * Revert concurrently script path change. |
||
|---|---|---|
| .. | ||
| src | ||
| .npmrc | ||
| CHANGELOG.md | ||
| README.md | ||
| package.json | ||
| tsconfig-cjs.json | ||
| tsconfig.json | ||
README.md
Tracks
WooCommerce user event tracking utilities for Automattic based projects.
Installation
Install the module
npm install @woocommerce/tracks --save
Usage
The store must opt-in to allow tracking via the woocommerce_allow_tracking setting.
If the store is not opted-in no events be recorded when using the following functions.
recordEvent( eventName, eventProperties )
Record a user event to Tracks.
import { recordEvent } from '@woocommerce/tracks';
recordEvent( 'page_view', { path } )
| Param | Type | Description |
|---|---|---|
| eventName | String |
The name of the event to record, don't include the wcadmin_ prefix |
| eventProperties | Object |
Event properties to include in the event |
queueRecordEvent( eventName, eventProperties )
Queue a tracks event.
This allows you to delay tracks events that would otherwise cause a race condition.
For example, when we trigger wcadmin_tasklist_appearance_continue_setup we're simultaneously moving the user to a new page via
window.location. This is an example of a race condition that should be avoided by enqueueing the event,
and therefore running it on the next pageview.
| Param | Type | Description |
|---|---|---|
| eventName | String |
The name of the event to record, don't include the wcadmin_ prefix |
| eventProperties | Object |
Event properties to include in the event |
recordPageView( eventName, eventProperties )
Record a page view to Tracks.
| Param | Type | Description |
|---|---|---|
| path | String |
Path the page/path to record a page view for |
| extraProperties | Object |
Extra event properties to include in the event |
Debugging
When debugging is activated info for each recorded Tracks event is logged to the browser console.
To activate, open up your browser console and add this:
localStorage.setItem( 'debug', 'wc-admin:*' );