--- title: Analytics description: >- Build and visualize custom analytics queries using events, measures, filters, and breakdowns. breadcrumbs: Docs > Product Analytics > Charts > Analytics --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Analytics {% callout %} # Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com {% alert level="danger" %} This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}). {% /alert %} {% /callout %} Analytics charts start from a single query: an event, a measure, and any filters. Define these once, then choose how to visualize the result. Use analytics charts to: - See how many users triggered an event, and how feature adoption changes over time. - Measure how often users perform an action and how deeply they engage with your product. - Break down a metric by user or event properties, and visualize the composition of events. - Build custom metrics with formulas, combining any events or metrics into a rate, ratio, or score. - Clarify which users or segments are driving a spike, drop, or trend. {% image source="https://docs.dd-static.net/images/product_analytics/analytics/analytics_chart.c2fe3ab7cd68a7f94f9a1d51d6690c7f.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/product_analytics/analytics/analytics_chart.c2fe3ab7cd68a7f94f9a1d51d6690c7f.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An example Analytics chart." /%} ## Build a query{% #build-a-query %} A query defines what an analytics chart measures, independent of how you later choose to display it. {% image source="https://docs.dd-static.net/images/product_analytics/analytics/analytics_query_builder.f99a6b77498a9342ecf47f0f1bc9208a.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/product_analytics/analytics/analytics_query_builder.f99a6b77498a9342ecf47f0f1bc9208a.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An Analytics query builder with numbered callouts for the query display name, the event picker, the measure selector, and the filter, breakdown, function, and additional query controls." /%} 1. In Product Analytics, select Create New > Analytics. 1. (Optional) Enter a Query display name to label the query. 1. Click the event picker to select which events the query includes, such as a specific view or session. Use the tabs inside the picker to narrow the list by event category: Sessions, Views, Labeled actions, Actions, or Server actions. 1. Choose how the query measures selected events using Viewed as count of. Select All events to count every occurrence, or select a specific property, such as User Id, to count unique values instead. 1. (Optional) Scope the query by event, user, segment, or account properties, including custom attributes from third-party integrations, using Add filter. 1. (Optional) Compare results across the values of a property, such as country or view name, using Add breakdown. Important alert (level: info): Query Value charts remove breakdowns, and Geomap charts convert them to a location facet. 1. (Optional) Apply a function that transforms the query, such as calculating a rate of change or smoothing the data, using Σ. See [Functions](https://docs.datadoghq.com/dashboards/functions.md) for details. 1. (Optional) Run a second, independent query alongside the first using Add Query. Combine multiple queries into a single result, using Add Formula. ## Understand an analytics chart{% #understand-an-analytics-chart %} After you build a query, the chart displays your data using the event, measure, filters, and breakdown you defined. From here, you can change how that data is visualized and displayed without changing the underlying query. Not every option applies to every chart type. Rollup interval and display style, for example, apply only to Timeseries charts. {% image source="https://docs.dd-static.net/images/product_analytics/analytics/analytics_analysis.2ae4e0ff3de1939996fb097b8daad866.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/product_analytics/analytics/analytics_analysis.2ae4e0ff3de1939996fb097b8daad866.png?auto=format&fit=max&w=850&dpr=2 2x" alt="An Analytics chart with numbered callouts for the chart type selector, the rollup interval, the time range selector, the display selector, the datapoint options menu, and an in-progress interval." /%} 1. Use the chart type selector to switch between [chart types](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/visualize.md). 1. For Timeseries charts, use the rollup selector to set the time interval each datapoint represents. Choose Default to let the interval scale with the time range, or fix it to a specific value. 1. Use the time range selector to set the period of data the chart analyzes, from Past 1 Hour to Past 1 Year, or select a custom range from the calendar. 1. For Timeseries charts, use the display selector to switch between Bars, Lines, and Areas. 1. Hover over a datapoint to view details or click it to access options to zoom in, view underlying events, or search or exclude that value from the query. 1. Hatched segments indicate intervals that are still in progress. ## Next steps{% #next-steps %} Learn how to search, group, and visualize analytics events, and export or examine individual events. - [Search syntax](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/search_syntax.md) - [Events](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/events.md) - [Visualize](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/visualize.md) - [Group](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/group.md) - [Export](https://docs.datadoghq.com/product_analytics/charts/analytics_explorer/export.md) ## Further reading{% #further-reading %} Additional helpful documentation, links, and articles: - [Use geomaps to visualize your app data by location](https://www.datadoghq.com/blog/datadog-geomaps/)