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.

Copy your API Key from Settings > Install > I use Google Tag Manager

Track API

post
track

https://api.browsee.io/api/v1/track
An API to send custom events for some users
Request
Response
Request
Body Parameters
apiKey
required
string
Your Project's API Key
event
required
string
Name of the action that the user has performed like "CLICKED_CHECKOUT"
properties
optional
object
A JSON dictionary of the properties of the event like: { "price": 100, "category": "Apparel" }
userId
optional
string
A unique identifier of the user in your database. At least one of userId or anonymousId is required.
anonymousId
optional
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
optional
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".
Response
200: OK
When data is successfully received
{
"status": "success"
}
400: Bad Request
{
"status": "failure",
"message": <Problem in request parameters>
}

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.