AutoROICalc Event Tracking

AutoROICalc Event Tracking helps you measure the WordPress interactions that matter: link clicks, button clicks, form submissions, engagement, custom page elements, and WooCommerce conversion events. Add click tracking directly from the WordPress block editor, without adding JavaScript snippets to individual pages. Choose what each interaction means, how it should be valued, which tags and attribution sources it should use, and whether repeated activity should count as one event. The browser sends events to your own WordPress site first. WordPress validates the signed event configuration and relays the record to AutoROICalc with a server-side service token. Your service token is never exposed to visitors. An AutoROICalc account and service token are required to send records. WordPress click tracking Track clicks on:

• Button blocks
• Navigation Link blocks
• Linked Image blocks
• Links inside Paragraph blocks
• Links inside Heading blocks
• Links inside List Item blocks

For text blocks containing multiple links, one editor configuration applies to the block while every rendered link receives its own event identity and target position. Link records can distinguish internal links, outbound links, and other URL schemes. Event tracking from the block editor The Event Tracking panel lets editors configure:

• Click, mouse hover, or viewport visibility triggers
• AutoROICalc record type and description
• Activity, numeric value, and tags
• Captured campaign sources or fixed source overrides
• Consent category
• Debounce behavior for repeated interactions
• Optional AutoROICalc breakdown data

Hover and visibility tracking support a configurable dwell time so brief or accidental interactions do not have to become records. Form and custom event tracking Optional form tracking supports validated native WordPress forms, Contact Form 7 success events, and Gravity Forms confirmations. Form field names and submitted values are never collected. Custom targets let administrators track page elements that are not supported blocks. Add up to 20 CSS selector profiles and choose click, hover, or visible-in-viewport triggers. WooCommerce conversion tracking The optional WooCommerce integration can track:

• Product views
• Add-to-cart actions
• Checkout starts
• Completed purchases

Commerce records may contain product or order identifiers, SKU, quantity, value, currency, and item count. Customer details and checkout form contents are not included. WordPress dashboard report widgets Add authenticated AutoROICalc report charts to the WordPress administration Dashboard. WordPress retrieves each chart server-to-server with the configured service token, then displays it only to authorized administrators through a protected iframe. Configure the report ID, chart type, dataset selection, title, and height without making the report publicly accessible. Marketing attribution and repeated clicks Events can use marketing sources captured by the bundled AutoROICalc runtime or a fixed source list configured by the editor. Captured attribution follows the familiar source / medium convention used by Google Analytics and other web analytics tools. The plugin derives attribution from UTM parameters and the referring URL. Examples include (direct) / (none), google / organic, google / cpc, and example.com / referral. Campaign values may also be captured, and recent unique sources can be attached to an event record. This is independent AutoROICalc attribution. The plugin does not connect to Google Analytics or read data from a Google Analytics account. Debouncing is enabled by default with a 10-second window. The first matching event is sent immediately and repeated activity on the same target is ignored until the window expires. Administrators can change the default, and editors can override or disable it for individual tracked blocks.

1. Upload the plugin ZIP through Plugins -> Add New Plugin, or upload the autoroicalc-event-tracking folder to /wp-content/plugins/.
2. Activate AutoROICalc Event Tracking.
3. Open Settings -> Events Tracking.
4. Enter your AutoROICalc service token, review the defaults and consent mode, and enable tracking.
5. Edit a supported block and open Event Tracking in the block sidebar.
6. Enable tracking, configure the event, and update the page.

The service token can instead be set in wp-config.php: define( 'AUTOROICALC_SERVICE_TOKEN', 'your-service-token' ); When this constant is set, the token field is disabled in WordPress settings and the token remains outside the WordPress database.

1.0.1

• Added WordPress.org screenshot captions for the Dashboard report, global settings, report widgets, and block editor tracking controls.

1.0.0

• First public release of AutoROICalc Event Tracking.
• Added block editor click, hover, visibility, form, custom selector, WooCommerce, source/medium attribution, consent, diagnostics, breakdown, and authenticated Dashboard report widget support.

0.4.2

• Added an animated loading indicator while Dashboard report widgets are being prepared or refreshed.

0.4.1

• Fixed Dashboard chart refresh while preserving the strict iframe sandbox and authenticated server-side access.

0.4.0

• Added authenticated AutoROICalc report chart widgets for the WordPress administration Dashboard.

0.3.1

• Added an editor warning when a tracked block is consent-gated and explicit browser consent is required.

0.3.0

• Added form events, custom CSS selector targets, WooCommerce lifecycle events, engagement triggers, dwell timing, diagnostics, and signed context metadata.