Skip to content
Bifröst OrbitDocs

Get started as a developer

What you can build with Insights Orbit, the addresses and keys involved, and the order to set things up in.

Tutorial3 min read

Insights Orbit counts visits and events on your organisation's websites and apps without cookies. As a developer you put the script on the website, send the events that matter, and read the numbers into your own tools. The examples use Northwilds, an outdoor travel brand at northwilds.com that sells guided trips such as a Lofoten ski touring week.

What you need

  • A site in Insights Orbit: An Admin adds it under Sites, with the addresses the website lives on. See Add your first site.
  • The site key: It is on the site's Install screen. It goes in the page and is not a secret: events are only taken from the site's own addresses.
  • An API key: Only for servers and data tools. See API keys.

Set it up in this order

  1. Add the script: One tag in the page's <head> counts page views, outbound links, downloads, forms, scroll depth and not-found pages. See The script. A website built with the CMS Orbit SDK uses CmsInsights instead: Connect Insights Orbit with the CMS Orbit SDK.
  2. Check the first visit: Open a page of the website. Waiting for the first visit on Install turns green within a few seconds.
  3. Serve it from your own domain: Do this if ad blockers matter to you, with a proxy token so visitors' places and unique counts stay right. See Serve Insights Orbit from your own domain.
  4. Send your own events: Count what matters, such as Trip booked or Brochure requested, with insights.track. See Send your own events. Events that happen on a server, such as a confirmed payment, go to the server API.
  5. Agree goals with your team: A goal is a page or an event that counts as success, such as the booking confirmation page. Editors set them up under Goals.

Read the data

Every raw event, page by page, for a data warehouse
Plan
Growth
The same events with a query
Plan
Growth
Trying requests from the browser
Plan
Growth
A file of every event each night in your own bucket
Plan
Enterprise
An AI assistant that answers questions with your numbers
Plan
Growth

Addresses

Script, events, server API and raw event API
Production
https://api.bifrostorbit.com/insights/v1/
Staging
https://api-stage.bifrostorbit.com/insights/v1/
GraphQL
Production
https://api.bifrostorbit.com/insights/graphql
Staging
https://api-stage.bifrostorbit.com/insights/graphql
The app and the MCP server
Production
https://app.bifrostorbit.com/insights
Staging
https://stage.bifrostorbit.com/insights

Under /insights/v1/:

script.js
Method
GET
What it is
The script
collect
Method
POST
What it is
Batches from the script
server/events
Method
POST
What it is
Events from your servers, with an API key
events
Method
GET
What it is
Raw events, with an API key
opt-out?site=SITE_KEY
Method
GET
What it is
The page where visitors choose not to be counted
labels, label.js, labelling
Method
GET, POST
What it is
Labelled events and labelling mode

Privacy

The script stores nothing in the browser unless a visitor asks not to be counted, and Insights Orbit keeps no IP addresses. Don't send names, email addresses or other personal data in event details. If your website asks for consent before counting, the script can wait for it. See How visits are counted without cookies.

Stuck? See Troubleshooting for developers.

Was this page helpful?

Read next

The scriptAdd Insights Orbit to a website with one script tag, its options, and serving it from your own domain.Serve Insights Orbit from your own domainPass the script and events through your own server so fewer ad blockers stop them, and use a proxy token so each visitor's address still counts for places and unique visitors.API keysMake a key that sends events from your servers, reads raw events for your own tools, or both, and remove it when it is no longer used.Connect Insights Orbit with the CMS Orbit SDKAdd the script, tag page views with CMS Orbit entries, track campaigns and serve it from your own domain, in a Next.js website or with the PHP, Swift and Kotlin SDKs.Add your first siteAdd a website to Insights Orbit, put the script on it and see the first visit arrive.