Web SDK

Page views, sign-ins, purchases, and conversions that happen in a browser.

Package@aether/web

Statusalpha

TransportPOST /v1/batch

Install

● bash

npm install @aether/web

Initialize

● typescript

import { AetherSDK } from '@aether/web';

const aether = AetherSDK.init({ tenantId: 'your-tenant-id', appId: 'your-app-id' });
aether.consent.grant(['analytics']);
aether.track('page_view', { path: location.pathname });

What it collects

Data	Events	Consent purpose
Page and screen views	`page` / `screen`	analytics
Custom events	`track`	analytics
Sessions	start, heartbeat, end	analytics
Identity hints	`identify` · userId, hashed email, wallet	personalization
Commerce	product, cart, checkout, order, payment	analytics
Journeys	start, checkpoint, pause, resume, complete, abandon	analytics
Device context	OS, app version, locale, timezone	analytics
Marketing context	UTM parameters, referrer, campaign	marketing

How it collects

01Wait for consentNothing is captured until the purpose for an event is granted.
02Queue locallyEvents buffer in memory and localStorage for offline spooling.
03Batch and sendFlushes on size, interval, or page hide.
04Retry safelyIdempotent retries dedupe on tenant_id:event_id:schema_version for 24 h.

+Does it work with SPAs?

Yes. Route changes become page views, and checkpoints during an active journey.

+Does it set cookies?

It stores an anonymous id in first-party storage only after the analytics purpose is granted.