SessionsByDateChart

Description

This LineChart charts the number of sessions, and optionally pageviews and/or users, for each date, until today.

This is useful for seeing how a site's traffic changes and grows over time.

Refer to the Charts Overview for a list of all charts available.

Usage

import {
  AnalyticsDashboard,
  SessionsByDateChart,
} from "react-analytics-charts";

<AnalyticsDashboard
  authOptions={{ clientId }}
  renderCharts={(gapi, viewId) => {
    return (
      <SessionsByDateChart
        gapi={gapi}
        viewId={viewId}
        days={28}
        showPageViews
        showUsers
      />
    );
  }}
/>

Props

Prop	Type	Description
gapi	`GoogleAnalyticsEmbedAPI`	Required. The ready and authorized Google Analytics Embed API
viewId	`string`	Required. View ID for the view the chart pertains to. See ViewSelector for more information.
days	`number` \| `undefined`	Optional. Number of days the chart shows data for. Defaults to `28`.
container	`string` \| `undefined`	Optional. HTML element ID for the container to which the Google Analytics Embed API renders. One will be created if no value is provided.
showPageViews	`boolean` \| `undefined`	Optional. Set to `true` to show the page view count on the chart. Defaults to `false`.
showUsers	`boolean` \| `undefined`	Optional. Set to `true` to show the user count on the chart. Defaults to `false`.
options	LineChartOptions	Optional. The options for this chart have been preconfigured, but you can add or override any LineChartOptions you'd like here, such as the `width` or `title`.
query	`Query`	Optional. The query for this chart has been preconfigured, but you can override any query properties you'd like here.

This component also supports all div props, such as className, style, and onClick.

If you have more than one of this chart on the page, be sure to specify a unique container ID.

Data Queried

This query's date range spans from a start-date of NdaysAgo, where N is the days prop provided, until an end-date of today. See DataChart for more information on queries.

Metrics

ga:sessions
ga:pageviews (when showPageViews is enabled)
ga:users (when showUsers is enabled)

Dimensions

ga:date

Customizing

This chart has been preconfigured for ease of use, but you can customize it by providing a query or options prop.

The properties you specify in either prop object will override the ones used by this chart.

This means you can cherry-pick the properties you'd like to override, such as the metrics in the query, or the width in options, without having to create a completely custom chart.