SitePulse

SitePulse Direct Edition instantly routes visitor activity from your website directly to a physical ESP32-based hardware monitor sitting on your desk. By utilizing a lightweight JavaScript beacon that communicates directly with your own PHP backend, your data never touches Google or any other intermediary server. This zero-latency architecture allows you to monitor live traffic flow, track specific page visits, and receive physical audio-visual notifications the exact millisecond a user interacts with your site—all while maintaining 100% ownership of your data.

Key Features

• Zero-Latency Architecture: Triggers hardware alerts the moment a user lands on your site, bypassing the typical delays of cloud-based analytics.
• 100% Data Ownership: Self-hosted infrastructure ensures your visitor data remains strictly on your own server.
• Smart Bot Filtering: Automatically ignores crawlers like Googlebot, Bing, and PageSpeed Insights, preventing fake "spam beeps."
• Intelligent Session Control: Limits alerts to one per active user session, keeping your workspace quiet when the same user refreshes or navigates across multiple pages.
• Exact Page Tracking: Logs not just the visit, but the specific URL path (e.g., /subscription) the user is currently viewing.
• Dynamic Timezone Sync: Adjusts server timestamps automatically based on the GMT offset sent remotely from the hardware unit.

Version History

• v3.0 (Current): Introduced smart bot filtering, exact page path tracking, and remote GMT timezone synchronization.
• v2.0: Added session-based rate limiting and remote tracking mode configuration (e.g., page_view, new_session).
• v1.0: Initial prototype featuring basic ESP32-to-PHP communication and core buzzer alert mechanics.

Configuration & Requirements

To deploy the Direct Edition, you will need:

• An ESP32 microcontroller board.
• A web hosting environment with PHP support.
• Your local Wi-Fi network credentials.

How to Configure and Use

• Server Setup: Upload the tracker.php file to your web server's public directory (e.g., public_html/). This file acts as the brain, processing hits and filtering bots.
• Website Setup: Insert the lightweight JavaScript tracking snippet into your website's global header file (e.g., header.php) or deploy it via Google Tag Manager. Make sure to point the API_BASE variable to your tracker.php URL.
• Hardware Configuration: Open the settings.py file on your ESP32 and update the following variables: WIFI_SSID = "Your local Wi-Fi network name"
WIFI_PASS = "Your local Wi-Fi password"
SERVER_URL = "https://yourwebsite.com/tracker.php"
TIMEZONE_OFFSET = 3
• Launch: Save the files and run main.py via Thonny or your preferred IDE. The device will connect to your network, configure the server remotely, and begin monitoring.

• Read Privacy Policy