Browser source
Captures user interactions directly from the DOM using data-elb-* attributes. Extracts tracking data from markup, tracks pageviews automatically or manually, exposes an enhanced elb function with walker init support, and provides a trigger system covering click, submit, load, hover, scroll, and visible.
The browser source is a source in the walkerOS flow:
It reads `data-elb-*` attributes from your HTML and generates events. The Collector routes these to your configured destinations.
Installation
- Integrated
- Bundled
Install the packages:
Configure in your code:
Configuration
This source uses the standard source config wrapper (consent, data, env, id, ...). For the shared fields see source configuration. Package-specific fields live under config.settings and are listed below.
Settings
| Property | Type | Description | More |
|---|---|---|---|
prefix | string | Prefix for data attributes (default: data-elb) | |
scope | string | DOM scope for event tracking (default: document) | |
pageview | boolean | Enable automatic pageview tracking | |
elb | string | Name for global elb function | |
name | string | Custom name for source instance | |
elbLayer | boolean | string | any | Enable elbLayer for async command queuing (boolean, string, or Elb.Layer) |
Mapping
This package does not define custom rule-level settings. For the standard rule fields (consent, condition, data, batch, name, policy) see mapping.
Examples
Click event
A button click with walker data attributes is captured as an entity action event with the mapped label data.
Context and globals
Walker context and globals attributes attach ambient metadata to events emitted by the browser source.
Data attribute types
Walker data attributes parse scalar, boolean, and array values into typed fields on the emitted event.
Impression event
An intersection observer impression on a div with walker attributes emits a banner view event.
Nested entities
A page load produces a page view plus a product view whose nested size entity is captured on the product event.
Page view
A page load trigger captures the current URL, title, and referrer as a walker page view event.
Submit event
A form submit with walker data attributes produces a signup complete event carrying the selected plan.
Enhanced elb
The browser source returns an enhanced elb function with additional features:
Browser source elb adds:
- DOM commands:
walker initfor asynchronous DOM element loading - Flexible arguments: support for multiple argument patterns
- elbLayer integration: automatic processing of queued commands
- Element parameters: support for element parameters in commands
See Commands for complete API documentation.
Next steps
- Session source - session and device tracking
- Tagging guide - learn about data attributes
- Commands reference - full API documentation
- Tagger tool - visual tagging tool