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]]]]
​
Product Catalog API
Shopify Plugin
Last updated 4 months ago
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
Server-side Tracker

postServer-side Tracking API

Example call

Dates & Time

Timestamp

Accepted timestamp formats

Generic format supported

post
Server-side Tracking API
