REAL-TIME TELEMETRY ENGINE 1.8KB Script • Instant GeoIP Resolution • Conversion Tracking • Stateless REST API
Live Demo API Docs FAQ
Start Free
Platform Capabilities Deep-Dive

Built for High-Precision Web, Geo & Conversion Telemetry.

Explore the four architectural pillars powering Teeya Analytics — from our 1.8KB browser collector to our stateless SHA-256 secret-key REST API.

Pillar 01 • Real-Time Traffic Engine

Sub-Second Ingestion With Smart 30-Minute Session Grouping

Every pageview is dispatched asynchronously via navigator.sendBeacon to our /api/v1/collect/ collector endpoint, returning 204 No Content in milliseconds so your site speed is never impacted.

  • SPA & History API Ready: Automatically intercepts history.pushState and popstate events in React, Vue, Next.js, and HTMX apps.
  • Accurate Bounce Rate: Sessions start as single-page bounces and automatically transition to engaged sessions on the second interaction.
  • UTM & Referrer Attribution: Parses external referrer hostnames and utm_source, utm_medium, and utm_campaign tags automatically.
Live Collector Beacon Payload (POST /api/v1/collect/)
{
  "tracking_id": "tya_site_acmecommerce01",
  "session_id": "d8f29a1b-4c3e-4a91-812f-99a8b7c6d5e4",
  "visitor_id": "7a1c9e3f-2b4d-4f88-901a-33c4d5e6f7a8",
  "event_type": "pageview",
  "event_name": "pageview",
  "url": "https://acme-commerce.com/pricing?utm_source=newsletter",
  "pathname": "/pricing",
  "page_title": "VIP Membership & Wholesale Pricing",
  "referrer": "https://www.google.com/",
  "language": "en-US",
  "utm_source": "newsletter"
}
Automatic Server-Side GeoIP & User-Agent Enrichment
Country & ISO Code Nigeria (NG) • United Kingdom (GB)
Region & City Lagos • London • San Francisco
Device, Browser & OS Desktop / Mobile • Chrome / Safari
Pillar 02 • GeoIP & Device Intelligence

Know Exactly Where Your Visitors Are & What Devices They Use

Without intrusive browser location permission popups, our backend resolves incoming request IPs into Country, ISO Country Code, Region, and City, while parsing the User-Agent header into clean device categories.

  • City & Country Breakdown: Discover your top geographic markets and regional campaigns.
  • Device Form Factors: Compare Mobile, Desktop, and Tablet traffic shares at a glance.
  • OS & Browser Families: Track Windows 10/11, macOS, iOS, Android, Linux, Chrome, Safari, Edge, and Firefox.
Pillar 03 • Conversions & Custom Events

Track Signups, Checkouts & Custom Actions With Zero Friction

Pageviews only tell half the story. Teeya Analytics lets you track custom events and high-value conversions using either declarative HTML attributes or a 1-line JavaScript SDK call.

  • Declarative HTML Attributes: Add data-teeya-conversion="signup" to any button — no JavaScript code required.
  • Custom JSON Metadata: Attach order values, plan tiers, or SKU identifiers to any conversion event.
  • Automatic Conversion Rate: Real-time calculation of total conversions divided by unique visitors.
Declarative HTML & JS Conversion Tracking
<!-- 1. Zero-Code HTML Attribute -->
<button
  data-teeya-conversion="checkout_completed"
  data-teeya-meta='{"plan": "growth", "amount": 99}'>
  Complete Purchase
</button>

<!-- 2. Programmatic JavaScript Trigger -->
<script>
  window.teeya.conversion('trial_started', {
    source: 'pricing_page'
  });
</script>
Stateless API Workflow
# 1. Create website & get tracker script in JSON
POST /api/v1/websites/
Authorization: Bearer tya_live_demo_secret_key...

# 2. Retrieve all website analytics by Website UUID
GET /api/v1/websites/b3d9182e-.../analytics/?days=30
Authorization: Bearer tya_live_demo_secret_key...
Pillar 04 • Stateless Secret-Key REST API

100% Stateless API Parity With the Web Dashboard

Everything you can do in the Teeya Analytics web dashboard can be executed through stateless HTTP requests using your secret API key (Authorization: Bearer tya_... or X-API-Key).

  • SHA-256 Hashed Keys: Raw keys are shown once on creation and verified statelessly on every request.
  • Instant Tracker Provisioning: Adding a site via API immediately returns the <script> tag in JSON.
  • Comprehensive JSON Metrics: Pull summary KPIs, top pages, referrers, UTM campaigns, geo, and devices by Website ID.