Page views

Use the exact event name PageView.

Let Bily record the first page

The Bily browser script records the first page view when the document loads. This works the same whether you use the raw script or initialize Bily through @bilyai/js.

Do not call track("PageView") during the initial page or component mount. It would duplicate the automatic event.

Traditional multi-page sites need no manual page-view code. Each full navigation loads a new document and records one initial event.

Record each later SPA route

Single-page applications do not load a new document for each route. After the router commits a later URL, send:

import { track } from "@bilyai/js";

track("PageView", {
  sourceUrl: window.location.href,
  pageTitle: document.title,
});

Set sourceUrl to the complete current URL. Send the event after the page title and route state are current.

Skip the first route and repeated URLs

Save the current URL before you listen for later navigation.

route-tracking.ts

import { track } from "@bilyai/js";

let previousUrl = window.location.href;

export function onRouteCommitted() {
  const currentUrl = window.location.href;
  if (currentUrl === previousUrl) return;

  previousUrl = currentUrl;
  track("PageView", {
    sourceUrl: currentUrl,
    pageTitle: document.title,
  });
}

Connect onRouteCommitted() to your router’s after-navigation callback. Do not call it to initialize the listener.

Use your framework’s router

React Router

Track pathname, search, and hash changes from one component.

Next.js

Track App Router and Pages Router navigation from one shared component.

Confirm every page appears once

The event name is exactly PageView.
The initial document relies on the automatic event.
Later browser routes call track() after the route commits.
sourceUrl contains window.location.href.
pageTitle contains the final document.title.
A rerender at the same URL does not emit another event.

Verify page views

Test direct loads, reloads, route transitions, and browser history.

Getting started

Plan and launch

Install Bily

Track events

Operate safely

Let Bily record the first page

Record each later SPA route

Skip the first route and repeated URLs

Use your framework’s router

React Router

Next.js

Confirm every page appears once

Verify page views

​Let Bily record the first page

​Record each later SPA route

​Skip the first route and repeated URLs

​Use your framework’s router

React Router

Next.js

​Confirm every page appears once

Verify page views

Let Bily record the first page

Record each later SPA route

Skip the first route and repeated URLs

Use your framework’s router

Confirm every page appears once