Lyra — Link Intelligence Tool

Summary

Lyra is the team's custom URL shortener and link intelligence platform. It creates trackable short links that fire ad pixels on click and log click analytics (device type, referrer, timestamp). Built on Netlify + Netlify Blobs, deployed at lyra.stoicagent.com and l.connectbyreal.com. Admin dashboard at lyra-admin.netlify.app. Local folder: Tools/Lyra/site/.

What It Does

  • Shortens URLs to branded short links (l.connectbyreal.com/abc12 or lyra.stoicagent.com/abc12)
  • Fires ad pixels on every click — Meta, Google, TikTok, or custom snippets injected into a 350ms redirect page
  • Tracks click analytics — click count, device type (iOS/Android/Mac/Windows), referrer source, hashed IP (privacy-preserving), timestamp
  • Admin dashboard (lyra-admin.netlify.app) to create, manage, and analyze links

Architecture

  • Platform: Netlify (serverless ESM v2 functions, Netlify Blobs storage, Sentry error tracking)
  • Data stores (Blobs):
    • links — link records (slug, destination, pixels, click count, timestamps, notes)
    • clicks — daily click event logs keyed by slug:YYYY-MM-DD
    • config — global defaults (default Meta pixel ID, slug length, default UTM params)
  • Functions:
    • redirect.js — core redirect + pixel injection + click tracking (fire-and-forget via context.waitUntil)
    • links-create.js — create new link (auto-slug or custom slug)
    • links-list.js, links-update.js, links-delete.js, links-stats.js — CRUD + analytics
    • config-get.js, config-update.js — global settings management
    • health.js — health check endpoint

Default Configuration

  • Default Meta pixel: 139286293549346 (team pixel)
  • Slug length: 5 characters (auto-generated from [a-z0-9])
  • Reserved slugs that cannot be used: _health, api, admin, favicon.ico

Use Cases

  • Listing marketing — Short links in social posts, ads, and emails with pixel firing for retargeting
  • Showcase/CMA links — Track who clicked seller reports
  • Ad campaigns — All Meta/Google ads route through Lyra to capture pixel events even on external destinations
  • QR codes — Branded short URLs for print materials (business cards, sign riders)
  • Performance tracking — Know which channels (direct, Instagram, Facebook, email) are actually driving clicks

Privacy

IP addresses are one-way hashed before storage (non-reversible djb2 hash → base36). Raw IPs are never stored.

Related