Metrics Management

The Metrics Management page provides comprehensive analytics and tracking capabilities for website visitor behavior, search patterns, and page performance. This powerful tool allows administrators to monitor user interactions, analyze traffic sources, track advertising effectiveness, and gain insights into visitor engagement across all pages.

Quick Start

To begin analyzing metrics: 1) Use the filter dropdowns to narrow down data by Vendor, Search Term, Page, GCLID, or AdClick status, 2) Enter search terms in the search box to find specific records, 3) Click column headers to sort data, 4) Use the checkbox system to select multiple records for bulk operations.

Toolbar Functions

Button Function Requirements
Add Creates a new layout page entry Layout_Add permission required
Back Returns to the previous page in browser history None
Search Searches across search terms, pages, product names, IP addresses, and vendors None
Show All Clears all search filters and displays all records None
Hide/Un-Hide Toggles visibility of hidden/inactive records None
UnDelete Switches to deleted records view for restoration None
X (Delete Selected) Soft-deletes all selected records (sets active = 17) Records must be selected via checkboxes
+ (Restore Selected) Restores soft-deleted records (sets active = 1) Only visible in deleted records view
Permanently Delete Permanently removes selected records and associated widgets from database Only available for already-deleted records

Filter Controls

The metrics page provides five powerful filter dropdowns to help you analyze specific subsets of your data:

Vendor Filter

Filters records by traffic source vendor (Google, Bing, Facebook, etc.). The dropdown populates dynamically with all vendors found in your data. Select "All" to view records from all vendors.

Search Term Filter

Filters by the search terms visitors used to find your site. Shows up to 30 characters of each search term. Longer terms display with "..." truncation. Click any search term link to view the Google search results page.

Page Filter

Filters by specific pages on your website. Shows all pages that have recorded visitor activity. Use this to analyze performance of individual pages or sections.

GCLID Filter

Filters by Google Click ID presence:

  • Any: Shows all records regardless of GCLID status
  • Yes: Shows only visits that came from Google Ads (have GCLID)
  • No: Shows only organic visits (no GCLID)

AdClick Filter

Filters by advertisement click status:

  • Any: Shows all records regardless of ad click status
  • Yes: Shows only visits that resulted from advertisement clicks
  • No: Shows only non-advertisement visits

Data Table Columns

Column Description Features
â?쳌 (Checkbox) Selection checkbox for bulk operations Header checkbox selects/deselects all visible records
Date Timestamp of the visitor interaction Format: MM-DD-YYYY HH:MM AM/PM, sortable by clicking header
IP Visitor's IP address Clickable link opens detailed IP analysis in new tab
Search Terms Keywords the visitor used to find your site Truncated to 25 chars with "..." for longer terms, links to Google search
Page Page visited or product viewed Pages shown in red, products in blue, links open actual page
Vendor Traffic source (Google, Bing, etc.) Green background indicates Google Ads traffic (GCLID present)

Sorting Functionality

All table columns support sorting to help you analyze data trends:

  1. Click any column header to sort by that field in ascending order
  2. Click the same header again to reverse to descending order
  3. Visual indicators: Small arrow icons show current sort direction
  4. Persistent sorting: Your sort preferences are remembered across sessions

Available Sort Options

  • Date: Sort by visit timestamp (newest/oldest first)
  • IP: Sort by IP address (numerical order)
  • Search Terms: Alphabetical order of search keywords
  • Page: Alphabetical order of page names
  • Product Name: Alphabetical order of product names
  • Vendor: Alphabetical order of traffic sources

Search Functionality

The search feature provides comprehensive text-based filtering across multiple data fields:

Search Scope

When you enter search terms, the system searches across:

  • Search Terms: Keywords visitors used
  • Page Names: Names of pages visited
  • Product Names: Names of products viewed
  • IP Addresses: Visitor IP addresses
  • Vendors: Traffic source names

Search Behavior

  • Partial matching: Searches use "contains" logic (LIKE %term%)
  • Case insensitive: Search terms match regardless of capitalization
  • Multiple fields: Records match if ANY searched field contains your term
  • Persistent results: Search terms are remembered and can be combined with filters

Search Tips

Use specific terms for precise results. For example, search "google" to find all Google traffic, or search an IP address to find all activity from that visitor. Combine searches with filters for powerful data analysis.

Bulk Operations

The metrics system supports efficient bulk operations for managing large datasets:

Selection Process

  1. Individual selection: Check boxes next to specific records
  2. Select all visible: Use the header checkbox to select all records on current page
  3. Visual feedback: Selected rows remain highlighted
  4. Cross-page selection: Selections persist when navigating between pages

Bulk Delete Workflow

  1. Select records using checkboxes
  2. Click the red "X" button in the toolbar
  3. Confirm deletion in the popup dialog
  4. Records are soft-deleted (marked as inactive, not permanently removed)
  5. System redirects to show updated results

Bulk Restore Workflow

  1. Click "UnDelete" to view deleted records
  2. Select records to restore using checkboxes
  3. Click the green "+" button
  4. Confirm restoration in the popup dialog
  5. Records are reactivated and returned to normal view

Permanent Deletion

  1. Navigate to deleted records view (UnDelete button)
  2. Select previously deleted records
  3. Click "Permanently Delete"
  4. Confirm permanent removal - this action cannot be undone
  5. Associated widgets are also removed from the database

Pagination System

The metrics page uses an intelligent pagination system to handle large datasets efficiently:

Pagination Controls

  • Records per page: Configurable through application settings
  • Page navigation: First, Previous, numbered pages, Next, Last buttons
  • Current page indicator: Highlighted current page number
  • Total record count: Displayed in search results summary

Advanced Features

  • URL persistence: Page numbers and filters maintained in browser URL
  • Search integration: Pagination works with active searches and filters
  • Performance optimization: Only requested page data is loaded
  • Cross-page selections: Bulk operation selections persist across pages

Permissions & Security

The metrics system implements comprehensive security controls:

Required Permissions

  • Layout_Review: Required to access the metrics page
  • Layout_Add: Required to create new layout pages
  • Layout_Edit: Required to modify existing records
  • Layout_Delete: Required to delete records

Security Features

  • SQL injection prevention: All queries use parameterized statements
  • Input validation: Sort directions and parameters are whitelisted
  • Session management: User authentication required for all operations
  • Permission checking: Each action validates user permissions
  • Audit trail: All deletions and modifications are logged

Access Control

  • User ID 1 (Super Admin): Bypasses all permission checks
  • Workgroup restrictions: Users can only see data for their assigned workgroup
  • Automatic lockout: Users without Layout_Review permission are redirected to denial page

Data Analysis Features

Traffic Source Analysis

The vendor column provides insights into where your traffic originates:

  • Google Ads traffic: Highlighted with green background when GCLID is present
  • Organic search: Regular background for non-paid search traffic
  • Referral sources: Shows external websites driving traffic
  • Direct traffic: Visitors who typed your URL directly

Keyword Performance

Search term analysis helps optimize your content strategy:

  • Popular keywords: Most frequently searched terms
  • Long-tail keywords: Specific, detailed search phrases
  • Conversion potential: Terms that lead to product page views
  • Google integration: Click any search term to see actual search results

Page Performance

Understanding which pages attract visitors:

  • Landing pages: Pages where visitors first arrive
  • Popular content: Most frequently accessed pages
  • Product interest: Which products generate the most views
  • Content effectiveness: Pages that successfully engage visitors

Visitor Behavior

IP address tracking reveals visitor patterns:

  • Return visitors: Same IP addresses appearing multiple times
  • Geographic distribution: Where your visitors are located
  • Session analysis: Multiple page views from same visitor
  • Detailed IP reports: Click IP addresses for comprehensive analysis

Troubleshooting Guide

Common Issues

No records showing:

  • Check if filters are too restrictive
  • Verify you have Layout_Review permission
  • Ensure data is being collected properly
  • Check if you're viewing deleted records only

Search not working:

  • Try broader search terms
  • Check spelling and capitalization
  • Clear filters that might conflict with search
  • Verify database connectivity

Bulk operations failing:

  • Ensure records are properly selected
  • Check you have appropriate delete permissions
  • Verify no records are locked
  • Try smaller batches if processing large numbers

Sorting not working:

  • Clear browser cache
  • Check for JavaScript errors
  • Verify column headers are clickable
  • Try refreshing the page

Performance Optimization

  • Use filters: Narrow down large datasets before analysis
  • Limit date ranges: Focus on specific time periods
  • Regular maintenance: Archive old data periodically
  • Efficient searches: Use specific terms rather than broad queries

Summary

The Metrics Management page is a comprehensive analytics tool that provides deep insights into visitor behavior, traffic sources, and content performance. Use the powerful filtering and search capabilities to analyze specific data subsets, leverage the bulk operations for efficient data management, and utilize the sorting and pagination features to handle large datasets effectively. The detailed permission system ensures secure access while the extensive analysis features help optimize your website's performance and content strategy.