Skip to main content

Create a project

  1. Sign in to the ManaLens dashboard and create a workspace.
  2. Create a project and enter your site domain. The collector accepts browser events only from this domain and its subdomains.
  3. Open the project’s installation instructions. They show your Publishable key and a snippet that is ready to copy.
The Publishable key is safe to ship in a page or a game build. It sends website and game events. Server events need a separate Secret key. Never put a Secret key or an API key in the browser.

Install the SDK

Early access. The Web SDK is available on request during early access. The package is not on the npm registry yet and the repository is private until launch. To ask for the browser bundle and the package archive, use the Contact page of the ManaLens website (/contact).
The HTML snippet works on any website, including WordPress, Webflow, Shopify and static sites. Copy the snippet from the setup page and add it to the <head> of every page:
When the setup page shows a pinned jsDelivr build, it also adds integrity and crossorigin="anonymous". Keep both attributes. The browser then refuses a file that has changed. See Subresource Integrity.After the script loads, the instance is available as window.untitledAnalytics:
Optional attributes:See all snippet attributes.

Track key actions

The SDK tracks page views for you. Add a custom event for each action you want to measure, and identify users after login:

Verify the installation

  1. Open your site with the browser developer tools open.
  2. Confirm that the script loads once and that POST /v0/events returns 202.
  3. In the dashboard, click Verify Installation on the setup page. The project activates when it receives its first event.
  4. Open Activity. Your page view appears after a short delay.
If an ad blocker blocks the requests, serve the SDK through your own domain with a reverse proxy.

Next steps

Web SDK reference

Options, methods and single-page app routing.

Server events

Send events from your backend.

Consent mode

Store nothing until the visitor gives consent.

Reverse proxy

Avoid ad blockers.