Skip to main content

WordPress Integration

Track your WordPress site with Ovyxa using our official plugin or manual integration.

The easiest way to add Ovyxa to WordPress.

Installation​

  1. Log in to your WordPress admin panel
  2. Go to Plugins → Add New
  3. Search for "Ovyxa Analytics"
  4. Click Install Now
  5. Click Activate

Configuration​

After activation:

  1. Go to Settings → Ovyxa
  2. Enter your Site ID from your Ovyxa dashboard
  3. Configure tracking options (see below)
  4. Click Save Changes

Finding Your Site ID​

  1. Log in to Ovyxa
  2. Select your site
  3. Go to Settings → General
  4. Copy your Site ID (format: nm_xxxxxxxxxx)

Tracking Options​

Pageview Tracking

  • Enabled by default
  • Tracks all page loads automatically
  • Works with standard posts and pages

Outbound Links

  • Enable to track external link clicks
  • Tracks links to other domains
  • Useful for affiliate sites

File Downloads

  • Enable to track PDF, ZIP, and other file downloads
  • Automatically detects download links
  • Configure file extensions to track

404 Errors

  • Track 404 page not found errors
  • Helps identify broken links
  • Configure custom 404 tracking

Advanced Settings​

Exclude Pages

Exclude specific pages or post types:

/wp-admin*
/checkout/*
/account/*

Exclude User Roles

Don't track specific WordPress roles:

  • Administrator
  • Editor
  • Author
  • Contributor
  • Subscriber

Useful for excluding internal team traffic.

Custom Domain (Optional)

Use your own tracking domain for better ad-blocker resistance:

analytics.yourdomain.com

See proxy setup for configuration.

Manual Integration​

If you prefer not to use the plugin:

Method 1: Theme Functions​

Add to your theme's functions.php:

function ovyxa_tracking() {
    ?>
    <script async src="https://ingest.ovyxa.com/js/script.js" data-domain="YOUR_DOMAIN"></script>
    <?php
}
add_action('wp_head', 'ovyxa_tracking');

Method 2: Header/Footer Scripts Plugin​

  1. Install "Insert Headers and Footers" or similar plugin
  2. Add script to header section:
<script async src="https://ingest.ovyxa.com/js/script.js" data-domain="YOUR_DOMAIN"></script>

Method 3: Theme Customizer​

Some themes support custom code in the customizer:

  1. Go to Appearance → Customize
  2. Look for "Additional CSS" or "Custom Code"
  3. Add the tracking script
  4. Publish changes

WooCommerce Integration​

Track e-commerce events on your WooCommerce store.

Purchase Tracking​

Track completed purchases:

// Add to functions.php
add_action('woocommerce_thankyou', 'ovyxa_track_purchase');

function ovyxa_track_purchase($order_id) {
    $order = wc_get_order($order_id);
    $total = $order->get_total();
    ?>
    <script>
    window.ovyxa = window.ovyxa || function() {
        (ovyxa.q = ovyxa.q || []).push(arguments);
    };
    ovyxa('event', 'Purchase', {
        revenue: <?php echo $total; ?>,
        currency: '<?php echo $order->get_currency(); ?>'
    });
    </script>
    <?php
}

Add to Cart Tracking​

add_action('woocommerce_add_to_cart', 'ovyxa_track_add_to_cart');

function ovyxa_track_add_to_cart() {
    ?>
    <script>
    ovyxa('event', 'AddToCart');
    </script>
    <?php
}

Page Builders​

Ovyxa works with popular WordPress page builders.

Elementor​

  1. Install Ovyxa plugin (recommended)
  2. Or add script to Elementor → Settings → Custom Code
  3. Script automatically tracks page builder pages

Gutenberg​

Ovyxa tracking works automatically with the Gutenberg editor. No special configuration needed.

Divi​

  1. Go to Divi → Theme Options
  2. Find "Add code to <head>" section
  3. Paste Ovyxa script
  4. Save changes

Multisite Support​

For WordPress multisite installations:

Network-Wide Activation​

  1. Network activate the Ovyxa plugin
  2. Each site can configure its own Site ID
  3. Or use the same Site ID for network-wide stats

Separate Sites​

Track each subsite independently:

  • Activate plugin per site
  • Use different Site ID for each
  • View stats separately in Ovyxa dashboard

Troubleshooting​

Plugin Not Tracking​

Check script is loading:

  1. View page source (Ctrl+U or Cmd+U)
  2. Search for "ovyxa.com"
  3. Verify script tag is present

Common issues:

  • Site ID not entered in settings
  • Caching plugin blocking script
  • Theme conflicts

Solutions:

  • Clear cache (WP Super Cache, W3 Total Cache, etc.)
  • Deactivate other plugins temporarily
  • Check browser console for errors

Duplicate Tracking​

If events are being tracked twice:

  • Check you don't have both plugin AND manual code
  • Remove manual script if using plugin
  • Check theme isn't adding duplicate scripts

Not Tracking Logged-In Users​

By default, the plugin tracks everyone. To exclude:

  1. Go to plugin settings
  2. Enable "Exclude user roles"
  3. Select roles to exclude

Caching Conflicts​

Ovyxa works with caching plugins, but:

  • Clear cache after changing settings
  • Exclude tracking script from JavaScript minification
  • Use "async" attribute (default in plugin)

Performance​

The Ovyxa plugin is lightweight:

  • No impact on page load time
  • Script loads asynchronously
  • Less than 2KB file size
  • No database queries on frontend

Privacy & GDPR​

Ovyxa is GDPR-compliant by default:

  • Privacy-first — cookieless mode available
  • No personal data collected
  • No consent banner required
  • EU data hosting

See our privacy documentation for details.

Best Practices​

  1. Use the official plugin - Easiest setup and updates
  2. Enable relevant tracking - Only track what you need
  3. Exclude internal traffic - Filter admin and editor roles
  4. Test after setup - Verify tracking with verification guide
  5. Keep plugin updated - Get latest features and fixes

Need Help?​

WordPress-specific questions:

Download plugin: WordPress.org/plugins/ovyxa