Tracking Events
Capturing Tracking Events
You can use the Web SDK or Info Ident Track API directly to send any JSON formatted tracking information, for example from your data layer(s).
The Web SDK allows you to specify the data layer(s) with specific variables and their position in the data layer to only capture relevant information. This includes nested JSON objects.
Data is then send under the data field within the following request payload:
JSON
{
"data": [
{
"action": [
{}
]
},
{
"event": [
{}
]
},
{
"etc": [
{}
]
}
]
}Events Log
The events log provides an extensive view of tracking events.
This data is internally streamed into Elasticsearch database where it can be viewed for example via Kibana.
The events log can also be streamed to an external system, for example Kafka Consumer API.
The events log is also processed via our Flink processing framework for example to enable user-level trigger events, using events log aggregation with other profile data sources as required.
Data Layer Data
We use an array of objects to pass data. Here is a sample data from a data layer based on specified events and variables:
JSON
[
{
"action": [
{
"name": "ui_interaction",
"action": "view",
"category": "consent",
"label": "consent_window_show",
"timestamp": 1738065412241
},
{
"name": "ui_interaction",
"action": "click",
"category": "consent",
"label": "accepted",
"timestamp": 1738065416271
}
],
"notification": [
{
"name": "MAIN_CS",
"version": 1,
"permissions": [
"CS-OM",
"CS-OPT",
"CS-NBA"
],
"date": 1738065418765
}
],
"page": {
"name": "www.brand-demo.com",
"action": "navigation",
"url": "https://www.brand-demo.com/",
"timestamp": 1738065412058
},
"permission": {
"CS-OM": true,
"CS-NBA": true,
"CS-OPT": true
}
},
{
"pageInfo": {
"pageName": "ar:pdp:9399640:argoshomeheathdonsingleendliftottomanbed-grey:",
"siteSection": "ar:productdetails:",
"categoryID": [
"29351",
"29366",
"29865",
"29867"
]
}
},
{
"productInfo": {
"productID": "9399640",
"productName": "Argos Home Heathdon Single End Lift Ottoman Bed - Grey"
}
},
{
"items": {
"main": {
"id": "9399640",
"price": 220,
"name": "Argos Home Heathdon Single End Lift Ottoman Bed - Grey"
},
"additional": [
{
"id": "6513986",
"price": 200,
"name": "Argos Home Dalham Memory Mattress - Single"
}
]
}
}
]Sample events log
This is a simple sample events log:
JSON
{
"agent": {
"hostname": "backend-1a.test.teavaro.systems",
"name": "backend-1a.test.teavaro.systems",
"id": "8c3573eb-7ddc-47f3-a7b8-eba1e9db6d6a",
"type": "filebeat",
"ephemeral_id": "00df6057-eca2-4a59-a683-006e44be2d10",
"version": "7.17.1"
},
"log": {
"file": {
"path": "/logs/funnelconnect-test/events.log"
},
"offset": 35350
},
"origin": "http://brand-demo.com:8080",
"latency": 14,
"ua": {
"bType": "BR",
"os": "macOS",
"latency": 1,
"hdr": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36",
"bFamily": "Chrome",
"dName": "PC",
"bVer": "132.0.0.0"
},
"identMethod": 0,
"out": {
"resp": "{\"umid\":\"aee5284b-8ba3-49f1-862a-6e58f630e59d\",\"state\":0,\"identifiers\":[],\"permissions\":{\"CS-OPT\":true,\"CS-OM\":true,\"CS-NBA\":true},\"notificationHistory\":[{\"name\":\"MAIN_CS\",\"version\":1,\"permissions\":[\"CS-OM\",\"CS-OPT\",\"CS-NBA\"],\"date\":\"2025-02-18T14:54:24.335Z\"}],\"notificationStatus\":{\"CS-NBA\":true,\"CS-OM\":true,\"CS-OPT\":true,\"CS-UTIQ\":false},\"attributes\":{\"deviceName\":\"PC\",\"city\":\"Denia\",\"latitude\":\"38.840862\",\"isp\":\"Orange Espagne SA\",\"mnc\":\"03/09\",\"region\":\"Valenciana, Comunidad\",\"mobileBrand\":\"Orange\",\"cc\":\"ES\",\"browserVersion\":\"132.0.0.0\",\"domainName\":\"orange.es\",\"browserType\":\"BR\",\"longitude\":\"0.105725\",\"osFamily\":\"macOS\",\"browserFamily\":\"Chrome\",\"mcc\":\"214\",\"usageType\":\"MOB\"}}"
},
"geo": {
"cc": "ES",
"loc": {
"lon": 0.10572499781847,
"lat": 38.84086227416992
},
"mobileBrand": "Orange",
"mnc": "03/09",
"city": "Denia",
"reg": "Valenciana, Comunidad",
"latency": 1,
"domainName": "orange.es",
"isp": "Orange Espagne SA",
"mcc": "214",
"usageType": "MOB"
},
"ref": "http://brand-demo.com:8080/",
"ecs": {
"version": "1.12.0"
},
"nbaGiven": true,
"httpStatus": 200,
"host": {
"name": "backend-1a.test.teavaro.systems"
},
"tenant": "test",
"rType": "Info",
"method": "POST",
"in": {
"notification": "{\"name\":\"MAIN_CS\",\"version\":1,\"permissions\":[\"CS-OM\",\"CS-OPT\",\"CS-NBA\"]}",
"data": "[{\"pageInfo\":{\"pageName\":\"ar:pdp:9399640:argoshomeheathdonsingleendliftottomanbed-grey:\",\"siteSection\":\"ar:productdetails:\",\"categoryID\":[\"29351\",\"29366\",\"29865\",\"29867\"]}},{\"pageInfo\":{\"3\":\"level\"}},{\"productInfo\":{\"productID\":\"9399640\",\"productName\":\"Argos Home Heathdon Single End Lift Ottoman Bed - Grey\"}},{\"items\":{\"main\":{\"id\":\"9399640\",\"price\":220,\"name\":\"Argos Home Heathdon Single End Lift Ottoman Bed - Grey\"},\"additional\":[{\"id\":\"6513986\",\"price\":200,\"name\":\"Argos Home Dalham Memory Mattress - Single\"}]}}]",
"permissions": "",
"identifiers": "",
"attributes": "",
"permission": "{\"CS-OM\":true,\"CS-NBA\":true,\"CS-OPT\":true}",
"notifications": "",
"out": "json"
},
"pId": "test-brand-demo-info",
"td": {
"createdDate": "2025-02-18T14:54:24.335Z",
"umid": "aee5284b-8ba3-49f1-862a-6e58f630e59d",
"profileId": "67b49f2064c0dc4c752f9d9f",
"cat": "visitor",
"lookupIds": [
{
"src": "ck",
"name": "umdid",
"sel": true,
"value": "400e39f1-7d9f-4030-bbde-f77bf310954f"
}
]
},
"node": "backend-1a",
"input": {
"type": "filestream"
},
"@timestamp": "2025-02-20T15:51:56.021Z",
"ids": {
"umdid": "400e39f1-7d9f-4030-bbde-f77bf310954f",
"umid": "aee5284b-8ba3-49f1-862a-6e58f630e59d"
},
"status": [
300,
540,
552,
561
]
}