Server-side Tracker

post
Server-side Tracking API

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

Example call

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 requests
import 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'))

Dates & Time

Timestamp

Accepted timestamp formats

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

Generic format supported

YYYY-MM-DD[*HH[:MM[:SS[.fff[fff]]]][+HH:MM[:SS[.ffffff]]]]