Skip to main content

Sources

Sources are the entry points for event data in walkerOS. They capture events from different environments and formats, then transform them into standardized events that the collector can process.

How sources work​

Sources capture events in their native format and send them to the collector:

Source
Collector
Destination
123
1Capture: Listen for events (DOM clicks, API calls, player actions)2Transform: Convert to walkerOS event format (entity action, data)3Send: Forward to collector for processing and routing

Available sources​

Web​

Browser​

Captures events from web pages using DOM attributes:

  • DOM interactions (clicks, form submissions, visibility)
  • Automatic session and pageview tracking
  • Custom data attributes (data-elb-*)

Learn more →

dataLayer​

Integrates with existing analytics implementations:

  • Works with GA4 and GTM dataLayer
  • Event transformation and filtering
  • Gradual migration support

Learn more →

Server​

Server sources accept HTTP requests containing walkerOS events and forward them to the collector.

Express​

Turn-key HTTP event collection server with Express.js:

  • Standalone or embedded: Start server automatically or integrate with existing Express app
  • CORS support and health checks
  • Pixel tracking with 1x1 transparent GIF

Learn more →

Fetch​

Web Standard Fetch API source for edge and serverless platforms:

  • Platform agnostic: Cloudflare Workers, Vercel Edge, Deno, Bun, Node.js 18+
  • Web Standard (Request) => Response signature
  • Batch processing and CORS support

Learn more →

AWS Lambda​

AWS Lambda HTTP handler for event collection:

  • Multi-platform: API Gateway REST (v1), HTTP API (v2), Function URLs
  • Auto-detection of API Gateway version
  • Pixel tracking and health checks

Learn more →

GCP Cloud Functions​

Google Cloud Functions HTTP handler for event collection:

  • Plug-and-play: Direct assignment to Cloud Functions handler
  • Batch processing support
  • Configurable CORS

Learn more →

Basic setup​

Sources are configured in startFlow:

Loading...

Primary source​

startFlow returns an elb function based on your sources:

  • With sources: Returns first source's push method (enhanced features)
  • Multiple sources: First source is primary by default
  • No sources: Returns collector.push (basic functionality)

Override primary source​

Loading...

Reactive event handling​

Sources can react to collector events via the optional on method:

Loading...

Available Events:

  • consent - Consent state changes
  • session - Session lifecycle events
  • ready - Collector ready state
  • run - Collector run events

Creating custom sources​

See Create Your Own Source for a complete guide to building custom sources.

Next steps​

💡 Need Professional Support?
Need professional support with your walkerOS implementation? Check out our services.