Server-side Tracker
postServer-side Tracking API
post
https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/track
This endpoint allows you to send tracking events from your servers to engage. Both historical events dating back the last 2 years, and new events can be sent through this endpoint.
Note. The
user_id is used to measure your tracked events against your monthly tracked visitor quota. Hence, adding a lot of events to the current or coming months may result in high charges. The datetime parameter can be used to ensure events end up in the month intended.Request
Response
Request
Headers
Authorization
required
string
"Bearer eyJhbGciOiJIUzI1NiIssdzNCw..."
Log in to retrieve your user token.
Query Parameters
user_id
required
string
A unique customer id.
This is used to measure the monthly tracked visitor quota.event_name
required
string
One of the events under
TRACKED EVENTS.event
required
object
One of the event objects in
TRACKED EVENTS.datetime
optional
string
Check the accepted date formats below
session_id
optional
string
An id to separate between different visits from the same user.
Response
200: OK
Order successfully retrieved.
Event successfully added
400: Bad Request
Event failed
cURL
Javascript - jQuery
Javascript - Fetch
Nodejs - Axios
PHP - cURL
Python
cURL
curl --location --request POST 'https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/track'--header 'Authorization: Bearer [ADD YOUR USER TOKEN HERE]' \--header 'Content-Type: application/json'--data-raw '{"user_id": "da123fg876sfed","event_name": "Added To Cart","event":{product_id: '',product_type: '',name: '',price: ,currency: '',quantity: 1,url: 'https://www.example.com/product/path',image_url: 'https://www.example.com/product/path.jpg'},"datetime": "2020-01-01 20:20:01+01:00""session_id": "123a"}'
Javascript - jQuery
var settings = {"url": "https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders","method": "POST","timeout": 0,"headers": {"Authorization": "Bearer [ADD YOUR USER TOKEN HERE]","Content-Type": "application/json"},"data": JSON.stringify({"user_id": "da123fg876sfed","event_name": "Added To Cart","event":{product_id: '',product_type: '',name: '',price: ,currency: '',quantity: 1,url: 'https://www.example.com/product/path',image_url: 'https://www.example.com/product/path.jpg'},"datetime": "2020-01-01 20:20:01+01:00""session_id": "123a"}),};​$.ajax(settings).done(function (response) {console.log(response);});
Javascript - Fetch
var myHeaders = new Headers();myHeaders.append("Authorization", "Bearer [ADD YOUR USER TOKEN HERE]");myHeaders.append("Content-Type", "application/json");​var raw = JSON.stringify({"user_id": "da123fg876sfed","event_name": "Added To Cart","event":{product_id: '',product_type: '',name: '',price: ,currency: '',quantity: 1,url: 'https://www.example.com/product/path',image_url: 'https://www.example.com/product/path.jpg'},"datetime": "2020-01-01 20:20:01+01:00""session_id": "123a"});​var requestOptions = {method: 'POST',headers: myHeaders,body: raw,redirect: 'follow'};​fetch("https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders", requestOptions).then(response => response.text()).then(result => console.log(result)).catch(error => console.log('error', error));
Nodejs - Axios
var axios = require('axios');var data = JSON.stringify({"user_id": "da123fg876sfed","event_name": "Added To Cart","event":{product_id: '',product_type: '',name: '',price: ,currency: '',quantity: 1,url: 'https://www.example.com/product/path',image_url: 'https://www.example.com/product/path.jpg'},"datetime": "2020-01-01 20:20:01+01:00""session_id": "123a"});​var config = {method: 'post',url: 'https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders',headers: {'Authorization': 'Bearer [ADD YOUR USER TOKEN HERE]','Content-Type': 'application/json'},data : data};​axios(config).then(function (response) {console.log(JSON.stringify(response.data));}).catch(function (error) {console.log(error);});
PHP - cURL
<?php​$curl = curl_init();​curl_setopt_array($curl, array(CURLOPT_URL => "https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders",CURLOPT_RETURNTRANSFER => true,CURLOPT_ENCODING => "",CURLOPT_MAXREDIRS => 10,CURLOPT_TIMEOUT => 0,CURLOPT_FOLLOWLOCATION => true,CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,CURLOPT_CUSTOMREQUEST => "POST",CURLOPT_POSTFIELDS =>"JSON_ENCODE(array("user_id" => "da123fg876sfed","event_name" => "Added To Cart","event" =>array(product_id => '',product_type => '',name => '',price => ,currency => '',quantity => 1,url => 'https://www.example.com/product/path',image_url => 'https://www.example.com/product/path.jpg'),"datetime" => "2020-01-01 20:20:01+01:00""session_id" => "123a"))",CURLOPT_HTTPHEADER => array("Authorization: Bearer [ADD YOUR USER TOKEN HERE]","Content-Type: application/json"),));​$response = curl_exec($curl);​curl_close($curl);echo $response;​
Python
import requestsimport json​url = "https://api-dot-solutionsone-211314.ew.r.appspot.com/v1/orders"​event = {"user_id": "da123fg876sfed","event_name": "Added To Cart","event":{product_id: '',product_type: '',name: '',price: ,currency: '',quantity: 1,url: 'https://www.example.com/product/path',image_url: 'https://www.example.com/product/path.jpg'},"datetime": "2020-01-01 20:20:01+01:00""session_id": "123a"}payload = json.dumps(event)headers = {'Authorization': 'Bearer [ADD YOUR USER TOKEN HERE]','Content-Type': 'application/json'}​response = requests.request("POST", url, headers=headers, data = payload)​print(response.text.encode('utf8'))​
Format | Example |
YYYY-MM-DD HH:MM:SS+HH:MM | 2020-01-01 04:23:01+04:00 |
YYYY-MM-DD HH:MM:SS.ffffff | 2020-01-01 04:23:01.000384 |
YYYY-MM-DD HH:MM:SS | 2020-01-01 04:23:01 |
YYYY-MM-DDTHH:MM:SS+HH:MM | 2020-01-01T04:23:01+04:00 |
YYYY-MM-DDTHH:MM:SS.ffffff | 2020-01-01T04:23:01.000384 |
YYYY-MM-DDTHH:MM:SS | 2020-01-01T04:23:01 |
YYYY-MM-DD[*HH[:MM[:SS[.fff[fff]]]][+HH:MM[:SS[.ffffff]]]]
​
Last updated 4 weeks ago