How imnotbond/bb-tracker-template works
bb-tracker is a browser and server-side conversion-tracking product for quiz, VSL, advertorial, landing-page, and Shopify funnels. The main path captures browser behavior and attribution in bb-tracker.js, sends events to the generic CAPI endpoint, resolves product/market pixels, and forwards events to TikTok and Meta. Shopify orders have a separate HMAC-verified Purchase path; a Meta relay supports Shopify Custom Pixels. The README also documents GTM/GA4 and browser-to-server deduplication. Source excerpts show the main calls; Shopify Custom Pixel and GTM/GA4 wiring is documented, not sampled.
Main entry points: event.js Browser event API · shopify-purchase.js Purchase webhook · bb-tracker.js Browser tracker · meta-event.js Meta event relay
Components 14
Browser tracking
- Browser tracker
bb-tracker.js - GTM / GA4
- PostHog bridge
Event routing
- Browser event API
api/capi/event.js - Meta event relay
api/capi/meta-event.js - Pixel configuration
api/capi/_lib.js - Event mapping
api/capi/_lib.js - Payload helpers
api/capi/_lib.js
Shopify purchases
- Purchase webhook
api/capi/shopify-purchase.js
CAPI delivery
- TikTok CAPI
- Meta CAPI
Other components
- Funnel visitor
- Shopify Custom Pixel
- Shopify store
Connections 18
- Funnel visitor → Browser tracker: uses
README.md - Browser tracker → Browser event API: posts events
bb-tracker.js - Browser tracker → GTM / GA4: pushes events
README.md - Browser tracker → PostHog bridge: bridges events
bb-tracker.js - Shopify store → Purchase webhook: posts orders
README.md - Shopify Custom Pixel → Meta event relay: relays events
README.md - Browser event API → Event mapping: maps events
api/capi/event.js - Browser event API → Pixel configuration: resolves pixels
api/capi/event.js - Browser event API → Payload helpers: builds payloads
api/capi/event.js - Browser event API → TikTok CAPI: sends events
api/capi/event.js - Browser event API → Meta CAPI: sends events
api/capi/event.js - Meta event relay → Pixel configuration: resolves pixel
api/capi/meta-event.js - Meta event relay → Payload helpers: builds payload
api/capi/meta-event.js - Meta event relay → Meta CAPI: sends event
api/capi/meta-event.js - Purchase webhook → Pixel configuration: resolves pixels
api/capi/shopify-purchase.js - Purchase webhook → Payload helpers: builds payloads
api/capi/shopify-purchase.js - Purchase webhook → TikTok CAPI: sends purchase
api/capi/shopify-purchase.js - Purchase webhook → Meta CAPI: sends purchase
api/capi/shopify-purchase.js