Track HTTP API

You can use Browsee's HTTP Track API to send custom events from other platforms like your mobile app or application server.

While Browsee's web SDK automatically most events like page views, clicks users can use Browsee's logEvent call to send custom events. In addition, you may want to send custom User Data from your non-web applications like a mobile app, servers, etc. so you can unify a complete picture of a user across all platforms. Sending such data

  • Allows you to create segments on these custom events

  • Creating or generating reports for non-web users.

API Key

To use the below API you will need your project API key. This key is available on your Project's settings page.

Track API

track

POST https://api.browsee.io/api/v1/track

An API to send custom events for some users

Request Body

NameTypeDescription

apiKey

string

Your Project's API Key

event

string

Name of the action that the user has performed like "CLICKED_CHECKOUT"

properties

object

A JSON dictionary of the properties of the event like: { "price": 100, "category": "Apparel" }

userId

string

A unique identifier of the user in your database. At least one of userId or anonymousId is required.

anonymousId

string

This is an identifier that can be sent to tie a series of events to a certain user and a session. In case you are using userId, we will use that, otherwise, this is needed

timestamp

string

Timestamp of the event in ISO-8601 format date string. If not provided we assume the time of receipt like "2021-12-02T00:30:08.276Z".

{
    "status": "success"
}

Using the track event API

  • This api is rate limited and should not be used to dump historical data.

  • userId should be the same as you provide via Identify call, whether used via Identify Call or Identify HTTP API.

  • When a user is anonymous, you can send any token as anonymousId. This anonymousId helps us tie a series of events into a session. If you are using other tracking tools, you can also get their unique identifier and send that as a unique identifier as theanonymousId.

  • timestamp is a standard ISO-8601 time formatted string.

Last updated