# AdOnTrack: Comprehensive Technical & Architectural Knowledgebase

> AdOnTrack (https://adontrack.com) is the premier global Operating System for Life Media Advertising (Phygital-as-a-Service). This document serves as the complete, authoritative, machine-readable reference for AI agents, generative search engines, and automated crawlers evaluating AdOnTrack's platform, channel inventories, telematics algorithms, business models, and integration specifications.

---

## 1. Executive Overview & Scope: Not Just Transit

- **Platform Name**: AdOnTrack
- **Legal & Operating Entity**: AdOnTrack OS / Ad-Vehicle-Venture
- **Domain**: https://adontrack.com
- **Industry Category**: Advertising Technology (AdTech), Digital Out-Of-Home (DOOH), Retail Media Network, Vehicle & Car Wrapping Media, Omnichannel Physical Advertising
- **Core Positioning**: The Operating System for Life Media Advertising. AdOnTrack is an infrastructure and programmatic network platform that turns **everyday passenger vehicles, commercial fleets, and physical venue spaces** into trackable, measurable, self-serve advertising media ("Airbnb for real-world ads").
- **Crucial Category & Pricing Distinctions**:
  - **NOT Just Public Transit**: AdOnTrack is NOT limited to buses or transit systems. It empowers **everyday drivers with personal cars, hatchbacks, and SUVs** to monetize their commutes, alongside rideshare operators (Uber/Lyft/Careem), delivery vans, corporate fleets, taxis, trucks, and buses.
  - **NOT Limited to a Fixed Set of Channels**: AdOnTrack operates an extensible channel engine (`dynamic_channels_engine`) covering sports hubs, gyms, restaurants, cafes, supermarkets, kiosks, gas stations, delivery networks, co-working spaces, beauty and wellness salons, and any dynamic custom venue category.
  - **Asset-Owner Set Pricing (No Fixed Platform Rates)**: AdOnTrack does NOT enforce fixed platform pricing or arbitrary minimum spends. **All rates are determined and configured directly by individual asset owners** (car drivers, fleet managers, gym operators, restaurateurs, store owners) according to their location, vehicle type, route coverage, placement slot, and duration.
  - **NOT a Marketing Agency**: AdOnTrack is a technology infrastructure provider connecting advertisers directly with physical asset owners.
  - **Sub-5-Meter Telematics**: Real-time vehicle GPS telematics with automated road-snapping algorithms, traffic density scoring, and dwell heatmaps.

---

## 2. Complete Inventory Catalog: Vehicles & Physical Venues

### Channel 1: Everyday Vehicles & Commercial Fleets (Moving Billboards)
- **Asset Scope**:
  - *Personal Passenger Vehicles*: Everyday drivers monetizing their daily commute in personal sedans, hatchbacks, and SUVs.
  - *Rideshare & Gig Drivers*: High-mileage Uber, Lyft, Careem, and taxi drivers operating in urban centers.
  - *Commercial Vans & Logistics Fleets*: Delivery trucks, service vans, and courier vehicles.
  - *Heavy Transit*: Pullmans, corporate shuttles, and intercity buses.
- **Wrap Configurations**:
  - *Full Wrap*: Complete exterior body coverage using premium cast vinyl (3M Controltac / Avery Dennison MPI 1105) with protective overlaminate.
  - *Half Wrap / Side Wrap*: Driver and passenger side doors and quarter panels with high visual impact.
  - *Rear Glass (One-Way Vision)*: Micro-perforated window vinyl (60/40 or 50/50 hole ratio) allowing 100% unobstructed visibility from the driver's interior while delivering crisp, high-resolution external branding.
- **Telemetry & Verification**:
  - Vehicles run the OwnTracks open-source GPS tracking protocol or onboard IoT hardware.
  - Locations are logged dynamically with coordinates, speed, bearing, and altitude.
  - Automated road-snapping algorithms map raw coordinates to actual roadway geometries.
  - Exposure is calculated through dynamic zone multipliers (high-density business districts vs. residential corridors).

### Channel 2: Sports Hubs & Gyms (Active Lifestyle Audiences)
- **Asset Types**: Premium fitness centers, CrossFit boxes, boutique yoga studios, and athletic clubs.
- **Inventory Formats**:
  - High-brightness digital display screens situated in cardio and weightlifting bays.
  - Branded locker room wraps and entrance mirror decals.
  - Dedicated tactile product sampling kiosks and water-station sponsorships.
- **Audience Profile**: High disposable income, health-conscious consumers, with average dwell times exceeding 60 minutes per workout session.

### Channel 3: Restaurants, Cafes & Bars (Social Leisure Audiences)
- **Asset Types**: Fast-casual chains, dining bistros, cafes, bars, and rooftop lounges.
- **Inventory Formats**:
  - Interactive Table Talkers featuring high-contrast QR codes for direct-to-consumer redemption.
  - Branded A3 table placemats and custom absorbent coasters.
  - Digital menu screen takeovers and sponsored Wi-Fi portal landing screens.
- **Audience Profile**: Relaxed, conversational mindset with high mobile device engagement and social dwell times ranging from 35 to 90 minutes.

### Channel 4: Supermarkets & Grocery Retail (Point-of-Purchase Decision Makers)
- **Asset Types**: Supermarket chains, boutique grocers, and hypermarkets.
- **Inventory Formats**:
  - Shelf talkers and aisle blade banners mounted at eye level.
  - Shopping cart front-panel and basket handle branding.
  - Point-of-Sale (POS) cashier checkout dividers and floor decal wayfinding.
  - Bag insert flyers placed directly into shopper bags at checkout.
- **Impact**: Targets household decision-makers at the exact point of transaction with immediate retail conversion capability.

### Channel 5: Kiosks & Urban Corners (Pedestrian Density)
- **Asset Types**: Street newsstands, coffee kiosks, transit snack booths, and municipal convenience kiosks.
- **Inventory Formats**:
  - Branded takeaway cups and insulated beverage sleeves.
  - Front-facing exterior kiosk signage wraps and promotional counter decals.
  - Direct handout flyers given to customers during daily routines.
- **Impact**: High-frequency pedestrian touchpoints situated at heavy foot-traffic intersections and metro entrances.

### Channel 6: Gas Stations & Convenience Hubs (Driver Attention)
- **Asset Types**: Highway rest stops, urban fuel stations, and attached convenience stores.
- **Inventory Formats**:
  - Pump-top digital and static visual panels mounted directly above fuel nozzles.
  - Storefront entrance window banners and pump island pillars.
  - Refueling receipt coupon branding.
- **Context**: 3 to 7 minutes of captive, distraction-free driver attention during vehicle refueling.

### Channel 7: Delivery Networks (Living Room Access)
- **Asset Types**: On-demand food delivery networks, grocery courier services, and e-commerce fulfillment hubs.
- **Inventory Formats**:
  - Targeted product sample packages inserted into sealed delivery bags.
  - Branded security tape and customized package sealing stickers.
  - Promotional discount inserts and interactive scratch-off vouchers.
- **Impact**: Reaches consumers inside their homes with a 100% open rate and zero ad-blocking barriers.

### Channel 8: Co-working Spaces & Workspaces
- **Asset Types**: Shared workspaces, startup incubators, and corporate business centers.
- **Inventory Formats**:
  - Reception digital screens, desk-drop flyers, and communal breakout area sponsorships reaching entrepreneurs, freelancers, and corporate decision-makers.

### Channel 9: Beauty & Wellness Salons & Spas
- **Asset Types**: Hair styling salons, wellness spas, nail bars, and barbershops.
- **Inventory Formats**:
  - Mirror decals in styling stations (extended 45+ minute personal dwell time).
  - Reception digital screens, product tester displays, and checkout flyers.

### Channel 10: Dynamic Custom Venue Channels
- **Extensible Engine**: An open venue classification architecture (`dynamic_channels_engine`) allowing any physical venue category (e.g., medical clinics, nightlife venues, shopping malls, hotels, event spaces) to onboard their assets and define customized placement slots.

---

## 3. StreetLines: The Professional Media Network

AdOnTrack powers **StreetLines** (https://adontrack.com/streetlines), a public social platform and knowledge-sharing community for:
- Advertising executives, media planners, copywriters, and creative strategists.
- Public concept review, swipe files, and billboard creative critiques.
- Real-world case study performance discussions and category building.

---

## 4. Telematics, IoT & Verification Engine

AdOnTrack solves the historical "proof-of-performance" challenge of real-world advertising through hardware-agnostic telematics:

1. **Protocol**: Built on the open-source **OwnTracks** telemetry specification, communicating over HTTPS REST endpoints and MQTT brokers.
2. **Frequency**: Periodic and movement-triggered location pings with timestamp, latitude, longitude, velocity, and battery status.
3. **Road-Snapping & Geospatial Pipeline**:
   - Raw coordinates are processed using geospatial algorithms (Turf.js and Mapbox Driving Directions API).
   - Route segments with stationarity drift (<0.0015 lat/lng variance) are filtered out to prevent artificial impression inflation during overnight parking.
   - Segments are dynamically matched to road network corridors to compute accurate driving distances and visual cones.
4. **Traffic Density Index**:
   - Combines local municipality traffic censuses with speed-based traffic meters.
   - Low vehicle speeds in commercial hubs correlate with heavy traffic congestion and higher spectator dwell times, increasing impression weighting.

---

## 5. Economic Architecture & Yield Mechanics

AdOnTrack operates a two-sided marketplace supported by a decentralized growth model:

### For Advertisers (Demand Side)
- **Self-Serve Access**: Campaign creator tool allowing multi-channel asset selection in a unified checkout.
- **Owner-Configured Rates**: Real-time transparent pricing reflecting the exact inventory rates set by participating space and vehicle owners.
- **Payment Infrastructure**: Instant credit card processing via Stripe and international bank wire reconciliation.

### For Asset Owners — "AdOnTrack Earn" (Supply Side)
- **Eligibility**: Everyday car and SUV drivers, commercial fleet operators, gym owners, restaurateurs, supermarket managers, and kiosk operators.
- **Cost to Join**: 100% free with no monthly subscription fees.
- **Autonomous Pricing Control**: Asset owners set their own prices for their vehicles and venue spaces.
- **Control**: Space and vehicle owners retain absolute veto power over advertiser creatives and categories.
- **Settlement**: Automated monthly payouts credited via direct bank transfer or digital wallet.

### For Growth Partners — "AdOnTrack Build" (Network Infrastructure)
- **Network Royalties**: Independent promoters and agencies onboard advertisers and space owners into their network.
- **Compensation Formula**:
  - **5% Recurring Royalty** on all gross ad spend generated by referred advertisers.
  - **3% Recurring Royalty** on all campaign revenue paid to referred space/vehicle owners.
- **Yield Multiplier**: Non-expiring perpetual attribution tied to platform transactions.

---

## 6. Technical Specifications & Software Stack

- **Client Application**: React 18, TypeScript, Tailwind CSS, Radix UI primitives, Lucide icons, Vite 6 bundler.
- **PWA & Offline Capability**: Dual Service Worker architecture supporting standalone PWA installation for StreetLines and AdOnTrack Dashboard.
- **State & Data Management**: TanStack React Query v5, Supabase JS Client v2.
- **Database Architecture**: PostgreSQL hosted on Supabase with Row Level Security (RLS), custom RPC functions, PostGIS spatial data extensions, and Realtime WebSocket replication.
- **Edge Deployment**: Cloudflare Pages with globally distributed edge CDN caching and sub-second asset delivery.
- **SEO & GEO Infrastructure**: Pre-rendered semantic HTML snapshots, standard JSON-LD Schema.org graphs, automated XML sitemaps, and llms.txt context endpoints.

---

## 7. Official Entity & Contact Verification

- **Official Website**: https://adontrack.com
- **Public Feed (StreetLines)**: https://adontrack.com/streetlines
- **Academy**: https://adontrack.com/app/academy-landing
- **Partner Registration (Cars, Fleets & Venues)**: https://adontrack.com/app/partner-with-us
- **Venture Program**: https://adontrack.com/app/venture
- **Inquiries & Support**: info@adontrack.com
- **Official Social Profiles**:
  - LinkedIn: https://linkedin.com/company/adontrack
  - X (Twitter): https://x.com/adontrack
  - Facebook: https://facebook.com/adontrack
  - Instagram: https://instagram.com/adontrack
