Browser API

Track an event

// Run after your application has confirmed success.
window.dynamite = window.dynamite || [];
window.dynamite.push(['track', 'order_completed', { value: 79 }]);

Configure an event goal with the same name. value is optional and numeric. Choose a consistent unit for your reporting. Use push whether the script has loaded or is still loading.

Read the visitor ID

const api = window.dynamite;
const visitor = api && !Array.isArray(api) ? api.visitor() : null;
if (visitor) {
  console.log(visitor.id, visitor.sessionId, visitor.group);
}

Returns null before the runtime is ready. The ID represents an anonymous browser profile. Optional groups are personalized, holdout, or off.

window.dynamite = window.dynamite || [];
window.dynamite.push(['consent', true]);
// Later, if the visitor withdraws:
window.dynamite.push(['consent', false]);

See Consent for startup and withdrawal behavior.

TypeScript contract

interface DynamiteApi {
  track(name: string, properties?: { value?: number }): void;
  visitor(): { id: string; sessionId?: string; group?: string } | null;
  consent(granted: boolean): void;
  push(command: [name: string, ...args: unknown[]]): void;
}

Only track and consent can be queued. Call visitor() directly after initialization.

Internal debugging API

window.IONVisitor exposes inspect(), refresh(), reset(), expire(), and destroy(). It is an internal controller for debugging and custom integrations.

const snapshot = window.IONVisitor?.inspect();
console.log(snapshot?.status, snapshot?.experiment);

refresh() uses current bindings; it does not discover missing DOM or fetch a new release. The public API has no identify(), setTraits(), setVariant(), quiz(), or onReady() method.

A purchase-named tracking event is browser measurement, not verified payment history. For application context, use connected data.

Start here

Install & integrate

Build experiences

Work with agents

Measure & operate

Track an event

Read the visitor ID

​Track an event

​Read the visitor ID

​Set consent

Track an event

Read the visitor ID

Set consent