(deprecated) HTTP tracking API source 1.0
You are looking to the old version of the API (version 1.0) Commanders Act will end support and maintenance for HTTP tracking API source 1.0 on August 31, 2023. This API will be fully deprecated on December 2023. After this date, the current format will no longer be supported and any requests using it may generates error.
We encourage you to begin using the new payload format as soon as possible to ensure a smooth transition. The new format is described here. Please refer to our documentation for more information on how to use the new format.
What changed in the payload format from the 1.0 to the 2.0 version :
- 1.All event data were inside the
propertiesobject. They are now at the root. The
propertiesobject doesn't exist any more.
- 2.All contextual meta-data were at the root, they are now inside a new
contextobject. For example these meta-data obects
event_timestampare now in the
The HTTP Tracking API 1.0 lets you record data from any website or application. Requests are routed to our servers, and your data is routed to any destination you desire.
Authenticate to the Tracking API by sending your project’s Source Key along with a request in the headers like so:
Authorization: Bearer NJtcKaoCYu...mGZDxRgMBMUw==
To send data to our HTTP API, a content-type header must be set to
We presently return a 200 response for all API requests, thus debugging should be done using the platform interface or our config API (event inspector or event delivery API). The sole exception is that if the request is too large or the JSON is invalid, it will return a 400.
There is a maximum of
32KBper API request.
There is no real rate limit above which the system will discard your data. But if you need to import at a rate faster than 500 requests per second, please contact us beforehand.
You may use the event API to capture the actions that your users perform. Every action results in what is known as an "event," which have associated properties.
You should keep track of activities that are indications of your app's performance, such as Signed Up, Item Purchased, and Article Bookmarked. To begin, we recommend tracking only a few key events. More may easily be added later!
"title": "Search page",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.86 Safari/537.36",
"cookie":"_fbp=123; _fbc=456; _ga=789"
If you want to use Http tracking API from you mobile APP instead of SDK, look at the Mobile event specificity
Timestamps supported are in milliseconds (ms).
Product API let's you import your product's catalog in the database. It is mostly used to enrich conversion events with product's properties. Find details in Product API spec.