# Event Tracking Reports

## Lifetime Events Tracking Histogram

 - [POST /v3/reporting/eventTracking/lifetime/histogram/{product_id}](https://rui-api.redocly.app/v3_api_redocly/event-tracking-reports/paths/~1v3~1reporting~1eventtracking~1lifetime~1histogram~1%7Bproduct_id%7D/post.md): The aim of this report is to show how events occur throughout the clients' lifetime. The data is presented as a histogram showing only a subset of events as specified. The histogram shows how many clients performed an event throughout their lifetime or their average daily/weekly/monthly usage. 
    
This report returns data that is to be represented in chart format. The result consists of histogram-style data for each different event or event combination that has been requested. The results consist of 4 histograms based on different values: event counts, average event count per day, average event count per week, and average event count per month.

## Lifetime Event Tracking Data Table

 - [POST /v3/reporting/eventTracking/lifetime/dataTable/{product_id}](https://rui-api.redocly.app/v3_api_redocly/event-tracking-reports/paths/~1v3~1reporting~1eventtracking~1lifetime~1datatable~1%7Bproduct_id%7D/post.md): The aim of this reports is to show how events occur throughout the clients' lifetime. The data is presented as a paged table which shows a list of all events and how many times each occurred.  
    
This report returns data that is to be represented in tabular format. It contains data about each tracked event, how many times it occurred, how many times each user performed each event on average, etc. The events can be presented either as a flat view or categorized hierarchically based on event category and name. Data for each event can then be segmented by any property.

## Event Usage Basic Data Table

 - [POST /v3/reporting/eventTracking/basic/dataTable/{product_id}](https://rui-api.redocly.app/v3_api_redocly/event-tracking-reports/paths/~1v3~1reporting~1eventtracking~1basic~1datatable~1%7Bproduct_id%7D/post.md): This basic event tracking reports is presented in a data table format which is meant to show a list of all known events within a date range and how they occurred. This report contains data about each tracked event, how many times it occurred, how many times each user performed each event on average, etc.

## Event Usage Basic Timeline

 - [POST /v3/reporting/eventTracking/basic/timeline/{product_id}](https://rui-api.redocly.app/v3_api_redocly/event-tracking-reports/paths/~1v3~1reporting~1eventtracking~1basic~1timeline~1%7Bproduct_id%7D/post.md): This basic event tracking report is presented in a timeline format which is meant to show the daily usage of a small subset. Normally, the timeline chart is used to drill-down on a selection of events that can be seen on the data table. This report returns a daily/weekly/monthly timeline of how many times each of the requested events occurred. The event occurrence counts can optionally be divided by the number of users on each day/week/month, the number of user sessions, runtime hours, etc.

## Advanced Events

 - [POST /v3/reporting/eventTracking/advanced/fullReport/{product_id}](https://rui-api.redocly.app/v3_api_redocly/event-tracking-reports/paths/~1v3~1reporting~1eventtracking~1advanced~1fullreport~1%7Bproduct_id%7D/post.md): This report provides a detailed view into how users are using your tracked events. It is available only for events selected for "advanced tracking" on the Event Tracking Management tab of the Product page. This report contains data about how many users used each event, many times each event occurred in total, how many times each user performed each event on average, etc. It also returns a histogram for each event showing the distribution of how many times each user performed each event.