Server-side

Download PDF

Server-side and mobile app data submissions are supported, allowing for the transmission of standard data points along with metadata. Access and analyze this data through the Events Explorer or create goals for frequent event monitoring.

We created a video explaining how server side tracking works with Simple Analytics. Here you go

Data submission

Developers can submit data to https://queue.simpleanalyticscdn.com/events using JSON format.

User agent guidelines

To prevent misidentification as a robot, avoid using default user agents from request libraries. These often contain terms like bot, crawl, python-requests/..., curl/..., node-fetch/..., or axios/.... Instead, use the real user agent of the user, or use a custom user agent format, such as ServerSide/1.0 (+https://www.yourwebsite.com/).

Event data structure

For event tracking, structure your payload as follows:

{
  "type": "event",
  "hostname": "example.com",
  "event": "event-name",
  "ua": "User Agent"
}

Page view data structure

Page view data uses the same endpoint, structured like this:

{
  "type": "pageview",
  "hostname": "example.com",
  "event": "pageview",
  "path": "/page-name",
  "ua": "User Agent"
}

Testing with cURL

To send test data, use the following cURL command:

Data should appear on your dashboard within minutes. You can always export the raw latest data from our dashboard, or use the Events Explorer to find your events.

Testing events

curl -X POST -H "Content-Type: application/json" -d '{
  "type": "event",
  "hostname": "mobile-app.example.com",
  "event": "consent",
  "metadata": {
    "button": "yes"
  },
  "ua": "Your User Agent"
}' https://queue.simpleanalyticscdn.com/events

Testing page views

curl -X POST -H "Content-Type: application/json" -d '{
  "type": "pageview",
  "hostname": "mobile-app.example.com",
  "event": "pageview",
  "path": "/my-page-name", 
  "ua": "Your User Agent"
}' https://queue.simpleanalyticscdn.com/events

Additional data fields

Expand your data submission with additional fields:

{
  "type": "event",
  "hostname": "example.com",
  "event": "event-name",
  "path": "/",
  "unique": true,
  "https": true,
  "ua": "User Agent",
  "referrer": "https://www.anotherexample.com/page-1",

  "viewport_width": 1440,
  "viewport_height": 310,
  "screen_width": 1440,
  "screen_height": 900,

  "language": "en-US",
  "timezone": "Europe/Amsterdam",

  "source": "source",
  "campaign": "campaign",
  "medium": "medium",
  "content": "content",

  "metadata": {
    "button": "yes"
  }
}