OneLence can automatically capture page navigation events to help reconstruct user journeys across websites and web applications.
Correct configuration ensures that page views are recorded consistently without creating duplicate or missing signals.
Automatic Page View Capture
When automatic page view tracking is enabled, the SDK emits a canonical page_view event during key navigation moments.
Typical behaviour includes:
- emitting a page view when the SDK initializes
- emitting additional page views when users navigate between routes
- attaching attribution context and visitor identifiers to each event
Automatic capture reduces the need for manual tracking in standard marketing websites and SaaS applications.
Single-Page Application Routing
Modern web applications often use client-side routing frameworks. In these environments, navigation does not trigger full page reloads.
When route tracking is enabled:
- navigation changes triggered by history state updates are detected
- page view events are emitted on route transitions
- funnel steps remain visible in user journey analysis
This helps maintain accurate behavioural timelines in applications built with frameworks such as React, Vue, or Angular.
Manual Page Tracking Scenarios
In some cases, developers may need to trigger page view events manually.
This may be required when:
- navigation occurs inside embedded widgets or modal flows
- route changes are abstracted by custom state management logic
- tracking should only occur after specific user interactions
Manual tracking ensures that key journey steps are not lost in complex UI flows.
Avoiding Duplicate Navigation Signals
Improper configuration can lead to multiple page view events being recorded for the same navigation step.
To prevent this:
- initialize the SDK once per application lifecycle
- verify that automatic route tracking is not duplicated by manual tracking logic
- test navigation behaviour in development environments
Consistent page view tracking supports accurate funnel reconstruction and reliable attribution analysis.