Documentation

TrackSure User Guide

Everything you need to set up analytics, connect ad platforms, and start tracking conversions — step by step.

Installation & Activation

Install from WordPress.org

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for "TrackSure"
  3. Click Install Now, then Activate

Upload Manually

  1. Download the .zip file from wordpress.org/plugins/tracksure
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose the zip file and click Install Now
  4. Click Activate Plugin
Requirements: WordPress 6.0+, PHP 7.4+. Works with any WordPress hosting. No external accounts needed for core analytics.

First-Time Setup

After activation, you'll see a new TrackSure menu item in your WordPress sidebar (with a chart icon). Click it to open the settings dashboard.

Step 1 — Enable Tracking

The master tracking switch is off by default. Go to TrackSure → Settings → Tracking and turn on:

  • Enable Tracking — Turns on all event collection across your site
Tip: Enable Track Administrators during setup so you can verify tracking works by browsing your own site. Disable it once you're done testing.

Step 2 — Configure Session Timeout

The Session Timeout controls how long a visitor can be inactive before their session expires and a new one starts.

  • Default: 30 minutes (matches Google Analytics)
  • Range: 5 to 120 minutes
  • Shorter timeouts = more sessions counted; longer = fewer sessions

Step 3 — Set Data Retention

Under Privacy & Compliance, set how long raw event data is kept:

  • Default: 90 days
  • Range: 7 to 730 days
  • Aggregated reports are preserved forever — only raw events are deleted

Dashboard Overview

The TrackSure dashboard (TrackSure → Overview) shows you key metrics at a glance:

Visitors

Total unique visitors with 30-day trend and comparison to the prior period.

Sessions

Total sessions with engagement metrics. One visitor can have multiple sessions.

Conversions

Total goal completions and overall conversion rate from your defined goals.

Devices

Visual breakdown by desktop, mobile, and tablet with browser and OS data.

The dashboard also includes top pages, traffic source breakdown (organic, paid, social, direct, referral), and geographic data.

All data is stored on your own server — no data is sent to external analytics services unless you explicitly connect a destination (Meta, GA4).

Tracking Controls

Fine-tune how TrackSure collects data. Go to TrackSure → Settings.

Setting Default What It Does
Enable Tracking Off Master switch. Nothing is tracked until you turn this on.
Track Administrators Off Include admin users in tracking. Enable for testing, disable for production data accuracy.
Session Timeout 30 min Idle time before a new session starts. Range: 5-120 minutes.
Batch Size 10 Events grouped per network request. Higher = fewer requests. Range: 1-50.
Batch Timeout 2000 ms Max wait before sending queued events. Range: 500-10000 ms.

Events TrackSure Captures Automatically

Once tracking is enabled, these events are collected without any setup:

Page Views
Scroll Depth (25%, 50%, 75%, 100%)
Time on Page
Form Views & Starts
UTM Parameters (from URLs)
Click IDs (gclid, fbclid, etc.)

Meta Pixel & Conversions API (CAPI)

Send events to Facebook & Instagram Ads using both browser pixel and server-side Conversions API for maximum signal accuracy.

Where to Find Your Credentials

  1. Go to Meta Events Manager
  2. Select your Pixel (or create one)
  3. Click Settings
  4. Copy your Pixel ID (numeric, e.g. 1234567890)
  5. Scroll to Conversions API section
  6. Click Generate Access Token and copy the token

Configure in TrackSure

  1. Go to TrackSure → Settings → Destinations → Meta
  2. Toggle Enable Meta CAPI on
  3. Paste your Pixel ID
  4. Paste your Access Token
  5. Save settings
Field Required Description
Pixel ID Required Your Meta Pixel ID (numeric). Found in Events Manager → Settings.
Access Token Required Conversions API access token. Generated in Events Manager → Settings → Conversions API.
Test Event Code Optional Used to test events without affecting production data. Found in Events Manager → Test Events tab.
How it works: TrackSure sends events via both the browser pixel (visible to the visitor) and the server-side Conversions API (invisible, bypasses ad blockers). Events are automatically deduplicated so Meta doesn't double-count.

Google Analytics 4

Send events to GA4 using the Measurement Protocol — browser tracking plus server-side events for complete data.

Where to Find Your Credentials

  1. Go to Google Analytics
  2. Open Admin → Data Streams
  3. Click your web stream
  4. Copy the Measurement ID (starts with G-)
  5. Scroll to Measurement Protocol API secrets
  6. Click Create, name it "TrackSure", and copy the secret

Configure in TrackSure

  1. Go to TrackSure → Settings → Destinations → GA4
  2. Toggle Enable GA4 on
  3. Paste your Measurement ID (e.g. G-XXXXXXXXXX)
  4. Paste your API Secret
  5. Save settings
Field Required Description
Measurement ID Required Your GA4 Measurement ID. Starts with G-. Found in Admin → Data Streams.
API Secret Required Measurement Protocol API secret. Created in Admin → Data Streams → Measurement Protocol API secrets.
Debug Mode Optional Sends events to the GA4 debug endpoint. Visible in DebugView but not in reports. Use for testing.
Consent Mode V2 Optional Enables Google Consent Mode V2 integration. Works with Complianz, CookieYes, and other CMPs.

WooCommerce Integration

If WooCommerce is installed, TrackSure automatically detects it and starts tracking e-commerce events — no extra setup required.

Auto-Tracked E-Commerce Events

view_item — Product page viewed
add_to_cart — Product added to cart
begin_checkout — Checkout started
purchase — Order completed

Each event includes product details: name, ID, SKU, category, price, quantity, and transaction ID.

These events are automatically sent to any connected destination (Meta, GA4) with full product data.

FluentCart Integration

TrackSure integrates natively with FluentCart (both Free and Pro). Once FluentCart is active, tracking starts automatically.

Auto-Tracked Events

view_item — Product viewed
add_to_cart — Added to cart
view_cart — Cart viewed
begin_checkout — Checkout started
add_payment_info — Payment info submitted
purchase — Purchase completed
refund — Refund processed

Goals & Conversions

Goals let you define what counts as a conversion on your site. Every time a visitor completes a goal, TrackSure records it as a conversion with full attribution data.

Creating a Goal

  1. Go to TrackSure → Goals
  2. Click Create Goal
  3. Choose a trigger type:
    • Page View — Goal completes when a specific page is viewed (e.g., /thank-you/)
    • Click — Goal completes when an element is clicked (e.g., a CTA button)
    • Form Submit — Goal completes when a specific form is submitted
    • Scroll Depth — Goal completes when a visitor scrolls to a certain % of the page
    • Time on Page — Goal completes after a visitor spends X seconds on a page
    • Engagement — Goal completes on any engagement event
  4. Set a conversion value (fixed amount or dynamic from event data)
  5. Choose frequency: once per session, once per day, or unlimited
  6. Save your goal

Goal Performance

Each goal has its own performance dashboard showing:

  • Conversion count — How many times the goal was completed
  • Conversion rate — Percentage of sessions that converted
  • Conversion timeline — When conversions happened over time
  • Source attribution — Which traffic sources drove the most conversions
  • Device breakdown — Desktop vs. mobile vs. tablet conversion rates
Example goals:
• "Newsletter Signup" — Form submit trigger on your subscribe form
• "Purchase Complete" — Page view trigger on /checkout/order-received/
• "CTA Clicked" — Click trigger on .btn-primary elements

Attribution

Attribution answers the question: "Which marketing channel drove this conversion?" TrackSure tracks every touchpoint — UTM parameters, referrers, ad click IDs — and attributes conversions to the right source.

Attribution Models

Model How It Works Best For
Last Touch Default Credit goes to the last traffic source before conversion Understanding which channel closes the sale
First Touch Credit goes to the first traffic source that brought the visitor Understanding which channel discovers new customers

Attribution Window

The attribution window defines how far back TrackSure looks when crediting a conversion to a traffic source.

  • Default: 30 days
  • Range: 1 to 90 days
  • Configurable at TrackSure → Settings → Attribution

Example: With a 30-day window, if a visitor first arrives from a Facebook ad on Jan 1 and purchases on Jan 20, the Facebook ad gets credit.

Tracked Click IDs

TrackSure automatically captures ad platform click identifiers from URLs:

gclid — Google Ads
fbclid — Meta/Facebook
msclkid — Microsoft Ads
ttclid — TikTok Ads
twclid — Twitter/X Ads
li_fat_id — LinkedIn Ads
ScCid — Snapchat Ads

User Journey

The User Journey view (TrackSure → User Journey) shows the complete path each visitor takes through your site — every page visited, every event triggered, with timestamps.

What You Can See

  • Complete event timeline — Every page view, click, form submit in chronological order
  • Time between events — How long visitors spend between each action
  • Entry source — Where the visitor came from (Google, Facebook, direct, etc.)
  • Conversion events — Which actions triggered goal completions (highlighted)
  • Device & location data — Browser, OS, country, region, city for each session

How to Use User Journeys

  • Debug drop-offs — Find the exact page where visitors leave before converting
  • Understand buying behavior — See what pages customers visit before purchasing
  • Compare sources — Do Facebook visitors browse differently than Google visitors?
  • Identify content gaps — Are visitors searching for something you don't have?

Sessions

The Sessions view (TrackSure → Sessions) gives you a detailed list of every visitor session with filtering and drill-down.

Session Data

Each session record includes:

  • Session duration — How long the visitor was active
  • Pages viewed — Number of pages visited in the session
  • Entry page — Where the visitor landed
  • Exit page — Last page before leaving
  • Traffic source — UTM parameters, referrer, click IDs
  • Device info — Desktop/mobile/tablet, browser, OS
  • Location — Country, region, city
  • Conversions — Which goals were completed during the session
Click any session to expand its full event timeline — see the complete user journey inside that session.

Product Funnels

Funnels show you the step-by-step conversion path and exactly where visitors drop off. Define a sequence of events or pages, and TrackSure calculates the completion rate at each step.

How Funnels Work

  1. Define a funnel with multiple steps (e.g., Product Page → Cart → Checkout → Purchase)
  2. Each step can be an event (like add_to_cart) or a page URL
  3. TrackSure tracks how many visitors reach each step
  4. Drop-off percentages are calculated between each step

Funnel Metrics

  • Step-by-step conversion rate — What % made it from step A to step B
  • Overall completion rate — What % completed the entire funnel
  • Biggest drop-off — Automatically highlights the worst-performing step
  • Filter by source — Compare funnel performance across traffic sources, devices, or geography
Example funnel: "Checkout Funnel" — view_item → add_to_cart → begin_checkout → purchase. If 1000 people view a product but only 50 purchase, TrackSure shows you exactly where the other 950 dropped off.

Real-Time View

The Real-Time view (TrackSure → Real-Time) shows events as they happen on your site — live.

What It Shows

  • Live event stream — Page views, clicks, form submits, conversions as they happen
  • Active visitors — How many people are on your site right now
  • Current pages — Which pages are being viewed this moment
  • Event details — Full parameters for each event (page title, URL, product data)
Real-Time is the best way to verify your tracking is working after setup. Browse your site in another tab and watch events appear instantly.

Traffic Sources

The Traffic Sources view (TrackSure → Traffic Sources) breaks down your visitors by how they found your site.

Source Categories

  • Organic Search — Visitors from Google, Bing, DuckDuckGo, etc.
  • Paid Search — Google Ads, Bing Ads (detected via gclid, msclkid)
  • Social — Facebook, Twitter/X, LinkedIn, Instagram, etc.
  • Referral — Links from other websites
  • Direct — Visitors who typed your URL directly or used bookmarks

Each source shows visitor count, session count, conversion count, and conversion rate — so you can see which channels actually drive results.

Test Your Setup

Step-by-Step Verification

  1. Enable Track Administrators in TrackSure Settings
  2. Open your site in a new browser tab
  3. Go to TrackSure → Real-Time in a second tab
  4. Browse your site — you should see page_view events appearing in real-time
  5. If events appear, tracking is working

Test Meta CAPI

  1. In TrackSure Meta settings, enter a Test Event Code
  2. Go to Meta Events Manager → Test Events
  3. Browse your site to trigger events
  4. Events should appear in the Test Events tab with the test code
  5. Remove the test code when done

Test GA4

  1. Enable Debug Mode in TrackSure GA4 settings
  2. Go to Google Analytics → Admin → DebugView
  3. Browse your site to trigger events
  4. Events should appear in DebugView
  5. Disable Debug Mode when done (debug events don't appear in regular reports)

Common Questions

Does TrackSure slow down my site?

No. The tracking script is under 5KB gzipped, loads asynchronously, and events are batched to minimize network requests. There's zero impact on page rendering speed.

Does TrackSure work with ad blockers?

Partially. Browser-side events may be blocked, but server-side tracking (CAPI) is invisible to ad blockers. This is why TrackSure uses both methods — server-side captures what browser-side misses.

Can I use TrackSure alongside Google Analytics or Meta Pixel?

Yes. TrackSure can run alongside existing analytics scripts, or it can replace them entirely. If you connect GA4 or Meta through TrackSure, it handles all the tracking for you (no need for separate GA4 or Meta Pixel scripts).

Where is my data stored?

All analytics data is stored in your WordPress database on your own server. Nothing is sent to external servers unless you explicitly enable a destination (Meta CAPI, GA4). You own 100% of your data.

What happens to my data if I uninstall TrackSure?

By default, all data is deleted on uninstall. If you want to keep your data, enable "Preserve data on uninstall" in Settings → Privacy & Compliance before deactivating.

Does TrackSure comply with GDPR?

Yes. TrackSure includes built-in consent management with Opt-In, Opt-Out, and Auto modes. It integrates with Complianz, CookieYes, and other consent management plugins. In Auto mode, it automatically applies GDPR rules for EU/UK visitors and CCPA rules for California visitors.

What's the difference between TrackSure and Google Analytics?

GA4 sends your data to Google's servers. TrackSure keeps your data on your server. TrackSure also adds features GA4 doesn't have: visual user journeys, conversion attribution with ad click ID tracking, product funnels, and server-side CAPI for Meta.

See the full comparison →

Do I need the Pro version?

The free version includes: full analytics dashboard, real-time view, traffic sources, user journeys, sessions, goals, Meta CAPI, GA4, WooCommerce + FluentCart tracking, and privacy controls. Pro adds advanced funnels, additional destinations (TikTok, Google Ads), and priority support.

Need More Help?

Can't find what you're looking for? Reach out to our support team.

Support Forum View All Features