Skip to content

Latest commit

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

📡 Tracking Awareness Demo – Blog + Pixel Tracking System

A full-featured tracking awareness demonstration platform that shows users how websites silently collect:

  • Behavioral signals (clicks, scroll depth, time spent)
  • Cross-domain tracking using tracking pixels
  • Fingerprint IDs (via FingerprintJS)
  • Location details (Country, State, City)
  • Interest profiling from visited pages

🚀 Features

  • Pixel tracking endpoint (/track.gif) that receives data from any domain.
  • Blog-style landing page with thumbnails and auto-generated interest categories.
  • Cross-domain mini site that sends tracking pixels to your main server.
  • Admin dashboard with real-time charts & live event feed.
  • Visitor profiling (interests, device, browser, location, engagement score).
  • Country + State + City detection via ip-api.com.

📂 Project Structure

app.py → Main Flask tracking + blog + admin system
cross_domain_site.py → Optional second-site that loads tracker JS
static/cross_tracker.js → Cross-domain pixel tracker script
profiles.json → Auto-generated visitor database
README.html → This file

📰 Blog Homepage

The homepage shows a real blog layout with:

  • Thumbnail images
  • Blog category tags
  • Short excerpt
  • Clickable blog URLs like: /blog/tech/top-5-tech-trends-2025

Interest Collection

When a visitor opens a blog page, the category (Tech, Cybersecurity, News, Stock, Instagram) is added to their interest profile automatically.


🎯 Tracking Pixel (Zero CORS, Zero Errors)

The system uses a bulletproof tracking pixel:

No CORS, no OPTIONS, no sendBeacon issues — works on:

  • Android Chrome
  • Firefox
  • Safari iOS
  • All cross-domain environments

📊 Admin Dashboard

The admin panel includes:

  • Total visitors
  • Total visits
  • Page-view graph
  • Interest chart
  • Cross-domain site chart
  • Live tracking feed (WebSocket real-time)

Visitor Detail Page

Shows full analytics per profile:

  • Country, State, City, IP
  • Device, OS, Browser
  • Engagement graph
  • Visit timeline
  • Interest categories

📡 Cross-Domain Tracking Setup

Your second site simply loads:

<script src="http://YOUR-IP:5000/static/cross_tracker.js"></script>

This automatically sends:

  • Clicks
  • Scroll depth
  • Time spent
  • Fingerprint ID
  • Current page URL

⚙️ Installation

1. Install dependencies

pip install flask flask-cors flask-socketio requests

2. Run main server

python app.py

3. Run optional cross-domain site

python cross_domain_site.py

🔑 Admin Login

Visit: /admin/login

Default password:

admin123

You SHOULD change it inside app.py.


🧠 How It Works (Simple Explanation)

  1. User opens your blog → Tracker JS loads silently
  2. Every few seconds + on page exit → sends pixel request
  3. Server decodes engagement + device + location + interests
  4. Admin panel displays analytics in real-time

📸 Screenshot Suggestions for GitHub

You may add:

  • Homepage screenshot
  • Admin dashboard screenshot
  • Visitor detail page screenshot

Watch Video For More Information.

YouTube Video

Available Our Hacking Course


📄 License

This project is for educational & cyber-awareness purposes only.


❤️ Author

Created by Nitish (Linuxndroid) for cybersecurity education and awareness.

About

📡 Tracking Awareness Demo – Blog + Pixel Tracking System

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages