WordPress Integration

Add Zenovay analytics to your WordPress site with a simple script tag.

Installation

Option 1: Add to Theme Header (Recommended)

Add to your theme's header.php before </head>:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Option 2: Add via functions.php

Add to your theme's functions.php:

function zenovay_tracking_script() {
    ?>
    <script
      defer
      data-tracking-code="YOUR_TRACKING_CODE"
      src="https://api.zenovay.com/z.js">
    </script>
    <?php
}
add_action('wp_head', 'zenovay_tracking_script');

WooCommerce Integration

Automatic E-commerce Tracking

With plugin + WooCommerce:

• Product views tracked automatically
• Add to cart events
• Checkout steps
• Purchase completion
• Revenue attribution

Manual WooCommerce Setup

Add to your theme's functions.php:

// Track product views
add_action('woocommerce_after_single_product', 'zenovay_track_product_view');
function zenovay_track_product_view() {
    global $product;
    ?>
    <script>
    if (window.zenovay) {
        zenovay('track', 'view_product', {
            product_id: '<?php echo esc_js($product->get_id()); ?>',
            product_name: '<?php echo esc_js($product->get_name()); ?>',
            price: <?php echo $product->get_price(); ?>,
            category: '<?php echo esc_js(wp_get_post_terms($product->get_id(), 'product_cat')[0]->name ?? ''); ?>'
        });
    }
    </script>
    <?php
}

// Track add to cart
add_action('woocommerce_add_to_cart', 'zenovay_track_add_to_cart', 10, 6);
function zenovay_track_add_to_cart($cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data) {
    $product = wc_get_product($product_id);
    ?>
    <script>
    if (window.zenovay) {
        zenovay('track', 'add_to_cart', {
            product_id: '<?php echo esc_js($product_id); ?>',
            product_name: '<?php echo esc_js($product->get_name()); ?>',
            price: <?php echo $product->get_price(); ?>,
            quantity: <?php echo $quantity; ?>
        });
    }
    </script>
    <?php
}

// Track purchase
add_action('woocommerce_thankyou', 'zenovay_track_purchase');
function zenovay_track_purchase($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);

    // Check if already tracked
    if ($order->get_meta('_zenovay_tracked')) return;

    $items = array();
    foreach ($order->get_items() as $item) {
        $product = $item->get_product();
        $items[] = array(
            'id' => $product->get_id(),
            'name' => $item->get_name(),
            'price' => $product->get_price(),
            'quantity' => $item->get_quantity()
        );
    }
    ?>
    <script>
    if (window.zenovay) {
        zenovay('revenue', <?php echo $order->get_total(); ?>, '<?php echo esc_js($order->get_currency()); ?>', {
            order_id: '<?php echo esc_js($order_id); ?>',
            items: <?php echo json_encode($items); ?>
        });
    }
    </script>
    <?php

    $order->update_meta_data('_zenovay_tracked', true);
    $order->save();
}

Goal Tracking

Form Submission Goals

Track Contact Form 7:

add_action('wp_footer', 'zenovay_cf7_tracking');
function zenovay_cf7_tracking() {
    ?>
    <script>
    document.addEventListener('wpcf7mailsent', function(event) {
        if (window.zenovay) {
            zenovay('goal', 'contact_form', {
                form_id: event.detail.contactFormId
            });
        }
    });
    </script>
    <?php
}

Track Gravity Forms:

add_action('gform_after_submission', 'zenovay_gf_tracking', 10, 2);
function zenovay_gf_tracking($entry, $form) {
    ?>
    <script>
    if (window.zenovay) {
        zenovay('goal', 'form_submission', {
            form_id: '<?php echo $form['id']; ?>',
            form_name: '<?php echo esc_js($form['title']); ?>'
        });
    }
    </script>
    <?php
}

Newsletter Signups

Track MailChimp for WordPress:

add_action('mc4wp_form_success', 'zenovay_mc4wp_tracking');
function zenovay_mc4wp_tracking() {
    ?>
    <script>
    if (window.zenovay) {
        zenovay('goal', 'newsletter_signup');
    }
    </script>
    <?php
}

User Identification

Track Logged-In Users

add_action('wp_footer', 'zenovay_identify_user');
function zenovay_identify_user() {
    if (!is_user_logged_in()) return;

    $user = wp_get_current_user();
    ?>
    <script>
    if (window.zenovay) {
        zenovay('identify', '<?php echo esc_js($user->ID); ?>', {
            email: '<?php echo esc_js($user->user_email); ?>',
            name: '<?php echo esc_js($user->display_name); ?>',
            role: '<?php echo esc_js($user->roles[0]); ?>'
        });
    }
    </script>
    <?php
}

Exclude Admin Users

Via Plugin

In plugin settings, exclude roles:

• Administrator
• Editor

Via Code

add_action('wp_head', 'zenovay_conditional_tracking');
function zenovay_conditional_tracking() {
    // Don't track admins
    if (current_user_can('manage_options')) {
        return;
    }
    ?>
    <script
      defer
      data-tracking-code="YOUR_TRACKING_CODE"
      src="https://api.zenovay.com/z.js">
    </script>
    <?php
}

Multisite Support

Network Activation

1. Network Activate the plugin
2. Each site configures own Website ID
3. Or set network-wide default

Per-Site Configuration

// In site's functions.php or plugin
add_filter('zenovay_website_id', function($id) {
    return 'SITE_SPECIFIC_ID';
});

Custom Events

Button Click Tracking

<button onclick="zenovay('track', 'cta_click', {button: 'hero'})">
  Get Started
</button>

Scroll Depth

add_action('wp_footer', 'zenovay_scroll_tracking');
function zenovay_scroll_tracking() {
    ?>
    <script>
    let maxScroll = 0;
    window.addEventListener('scroll', function() {
        const scrollPercent = Math.round(
            (window.scrollY / (document.body.scrollHeight - window.innerHeight)) * 100
        );
        if (scrollPercent > maxScroll && scrollPercent % 25 === 0) {
            maxScroll = scrollPercent;
            if (window.zenovay) {
                zenovay('track', 'scroll_depth', { depth: scrollPercent });
            }
        }
    });
    </script>
    <?php
}

Caching Compatibility

Popular Cache Plugins

Works with:

• WP Super Cache
• W3 Total Cache
• WP Rocket
• LiteSpeed Cache
• Cloudflare

Cache Exclusions

If tracking doesn't work:

1. Exclude Zenovay script from optimization
2. Don't combine/defer if issues occur

For WP Rocket:

add_filter('rocket_exclude_js', function($excluded) {
    $excluded[] = 'api.zenovay.com';
    return $excluded;
});

Troubleshooting

Tracking Not Working

Check:

• Plugin activated
• Website ID entered
• Not excluded by role
• Check browser console

WooCommerce Not Tracking

Verify:

• WooCommerce integration enabled
• Thank you page loads properly
• Not blocked by cache

Conflicts with Other Plugins

If conflicts occur:

• Disable other analytics plugins
• Check for JavaScript errors
• Test with default theme

Page Builder Compatibility

Works with:

• Elementor
• Divi
• Beaver Builder
• Gutenberg
• WPBakery

Performance

Script Loading

The Zenovay script:

• Loads asynchronously (defer)
• Under 5KB
• No render blocking
• CDN delivered

Optimization Tips

• Use plugin over manual code
• Don't duplicate script
• Enable caching

Next Steps

• WooCommerce Revenue Tracking
• Shopify Integration
• Goal Setup