Event Drill Down

About

The Drill Down API provides access to the same data which is available on the Engagement: Event Drill Down page of the justtrack dashboard.

Supported metrics

[
  "totalEventsCount"
]

Supported dimensions

[
  "app",
  "eventName",
  "country",
  "installAppVersionName",
  "network.id"
]

Supported event dimensions

[
    "jt_ad_placement",
    "jt_ad_network",
    "jt_ad_sdk_name",
    "jt_ad_unit",
    "jt_element_name",
    "jt_level_name",
    "jt_provider_name",
    "jt_item_id",
    "jt_item_name",
    "jt_item_type",
]

Table API

Use the Table API for feeding your own drill down tables. Send a POST request to:

curl -H X-API-Key: <API_KEY> https://api.justtrack.io/reporting/v1/drill-down/table

Request

{
    "cohort": {
        "enabled": false,
        "dx": [] 
    },
    "interval": {
        "from": "2023-01-01", 
        "until": "2023-01-05"
    }, 
    "dimensions": [
        "eventName",
        "eventDimension[DIMENSION NAME]" 
    ],
    "metrics": [ 
        "totalEventsCount"
    ], 
    "filters": {
        "app": [ 
            "APP NAME"
        ], 
        "eventName": [
            "EVENT NAME" 
        ],
        "eventDimension[DIMENSION NAME]": [ 
            "VALUE"
        ] 
    },
    "pagination": { 
        "page": 0, 
        "limit": 25
    }, 
    "orderBy": {
        "name": "eventName",
        "direction": "desc" 
    }
}

Name	Type	Description
cohort	Cohort object	Cohort or daily view.
interval	Interval object	An interval within which data should be aggregated.
metrics	[]string	A list of requested metrics.
dimensions	[]dimensions	A list of dimensions by which data should be split. You can request up to 3 dimensions. This can include named event dimensions in this form: eventDimension[DIMENSION NAME]
filters	Filters object	Filters to limit requested data. Optional.
pagination	Pagination object	Batch number and amount of data rows to return.
orderBy	OrderBy object	Descending or ascending order by selected metric or dimension.

Response

{
   "pagination": {
       "page": int,
       "limit": int,
       "total": int
   },
   "rows": [
       {
           "<dimension>": string,
           "<metric>": float
       }
   ],
   "sum": {
       "<metric>": float
   }
}

Name	Type	Description
pagination	Pagination object	Used pagination settings and total amount of data rows.
rows	[]Row	A list of data rows.
sum	Sum object	Sum for all table entries (not only for the requested page).

Graph API

The Graph API offers the same data as Table API with more flexible date grouping options.

curl -H X-API-Key: <API_KEY> https://api.justtrack.io/reporting/v1/drill-down/graph

Request

{
   "cohort": {
       "enabled": bool,
       "dx": [int]
   },
   "interval": {
       "from": "YYYY-mm-dd",
       "until": "YYYY-mm-dd"
   },
   "granularity": string,
   "metrics": [string],
   "filters": {
       "<dimension>": [string]
   }
}

Name	Type	Description
cohort	Cohort object	Cohort or daily view.
interval	Interval object	An interval within which data should be aggregated.
granularity	Granularity object	Scale of the data aggregation.
metrics	[]string	A list of requested metrics.
filters	Filters object	Filters to limit requested data. Optional.

Response

{
   "<date>": {
       "<metric>": float
   }
}

<date> stands for the date within which data was aggregated. Depends on the requested granularity.

<metric> stands for the requested metric name and contains float value.