Romiltec Analytics Tracking

Апісанне

Romiltec Analytics Tracking provides seamless Matomo analytics integration for WordPress sites. The plugin automatically tracks Post IDs as Custom Dimension 1 on single post pages, allowing you to analyze individual content performance in your Matomo dashboard.

Perfect for publishers, bloggers, and content marketers who want detailed insights into their content performance using self-hosted Matomo analytics.

Features

  • Automatic Post ID Tracking – Post IDs are automatically tracked as Custom Dimension 1 on single post pages
  • Matomo Integration – Full Matomo analytics integration with customizable URL and Site ID
  • Scroll Depth Tracking – Automatically tracks user scroll depth at 25%, 50%, 75%, and 100% milestones
  • Time on Page Tracking – Accurate time measurement with heartbeat timer (tracks active viewing time)
  • Performance Optimized – Lightweight and cache-safe implementation
  • Easy Configuration – Simple admin interface with validation
  • Translation Ready – Full internationalization support
  • Security First – Input sanitization and capability checks
  • No External Dependencies – Works with your self-hosted Matomo installation

How It Works

  1. Install and activate the plugin
  2. Configure your Matomo URL and Site ID in Settings > Romiltec Analytics
  3. Set up Custom Dimension 1 in your Matomo dashboard
  4. The plugin automatically tracks all pageviews and sends Post IDs for single posts

Requirements

  • Active Matomo analytics installation (self-hosted or cloud)
  • HTTPS recommended for security

Screenshots

  • Admin settings page with configuration options
  • Plugin status showing tracking configuration
  • Developer information and support links

Ўсталёўка

Automatic Installation

  1. Log in to your WordPress admin panel
  2. Go to Plugins > Add New
  3. Search for “Romiltec Analytics Tracking”
  4. Click Install Now and then Activate

Manual Installation

  1. Download the plugin zip file
  2. Go to Plugins > Add New > Upload Plugin
  3. Choose the zip file and click Install Now
  4. Activate the plugin

Configuration

  1. Go to Settings > Romiltec Analytics
  2. Enter your Matomo Analytics URL (e.g., https://analytics.yoursite.com/)
  3. Enter your Site ID from your Matomo dashboard
  4. Check Enable Tracking to activate
  5. Click Save Changes

Setting up Custom Dimension in Matomo

To track Post IDs, configure Custom Dimension 1 in your Matomo installation:

  1. Log in to your Matomo dashboard
  2. Go to Administration > Custom Dimensions
  3. Click Add Custom Dimension
  4. Set Scope to “Visit” or “Action”
  5. Set Name to “Post ID” (or your preferred name)
  6. Save the custom dimension

The plugin will automatically send Post IDs to Custom Dimension 1 on all single post pages.

Viewing Tracked Data in Matomo

The plugin automatically tracks multiple data points:

  • Page Views – Standard page visit tracking
  • Post IDs – Available in Custom Dimension 1 reports for single posts
  • Scroll Depth Events – Go to Behavior > Events and look for the “Scroll_depth” category with actions: 25%, 50%, 75%, 100%
  • Time on Page – Accurate time tracking visible in standard time metrics (uses 15-second heartbeat timer)

Часта задаваныя пытанні

Does this work with Matomo Cloud?

Yes! This plugin works with both self-hosted Matomo and Matomo Cloud installations. Just enter your Matomo URL in the settings.

Where do I find my Site ID?

Log in to your Matomo dashboard, go to Administration > Websites > Manage, and you’ll see the Site ID next to your website name.

What events does the plugin track?

The plugin automatically tracks:
* Page views with Post ID custom dimensions
* Scroll depth events (25%, 50%, 75%, 100%)
* Time spent on page using heartbeat timer

All events are sent to Matomo and visible in the Events reports under the “Scroll_depth” category.

Is this compatible with caching plugins?

Yes! The tracking code is injected client-side and is fully compatible with all major caching plugins.

Do I need to have Matomo installed?

Yes, you need an active Matomo analytics installation (either self-hosted or Matomo Cloud) to use this plugin.

Will this slow down my website?

No. The tracking code is lightweight, loads asynchronously, and has no impact on your site’s performance.

Водгукі

На гэты плагін няма водгукаў.

Удзельнікі і распрацоўшчыкі

“Romiltec Analytics Tracking” is open source software. The following people have contributed to this plugin.

Удзельнікі

Журнал змяненняў

1.0.0

  • Initial release
  • Matomo analytics integration
  • Automatic Post ID tracking as Custom Dimension 1
  • Scroll depth tracking (25%, 50%, 75%, 100%)
  • Heartbeat timer for accurate time on page measurement
  • Admin settings page with validation
  • Translation support
  • Security hardening and sanitization