Walkthrough: Adding a bar chart to an Experience Analytics report


Instructions on how to add and configure a bar chart.

Sitecore Experience Analytics provides dashboards and reports for marketers and marketing analysts to identify patterns and trends in experience data. This data is collected from websites and other external data sources.

You can add bar, line, list, or area chart components to reports using Sitecore Rocks depending on your business needs. For example, you can add a Conversions by country bar chart to the Audience/Overview report to display how much engagement value is generated on your website by country.

This walkthrough describes all the steps to add a bar chart component to an experience analytics report:

  • Add a chart component to a report

  • Add a parameters item to the report

  • Bind the bar chart control to the parameters item

  • Change the chart title


To add any chart component to a report, you must use Microsoft Visual Studio, Sitecore Rocks, and access to a Sitecore website. In Sitecore Rocks, you must also configure a connection to your website.

Before you can add a chart component to a report, you first need a report page.

To add a chart component to a report page:

  1. In Sitecore Rocks, right-click a report page, click Tasks and then click Design Layout.

  2. In the Design Layout window, click AddRendering.

  3. In the Select Rendering dialog box, select a chart control to use in your report page.

    To find all available chart controls, enter a search term beginning with experienceanalytics. You can choose from an area chart, bar chart, list, or line chart. For example, to display a bar chart, select the ExperienceAnalyticsBarChart rendering.

  4. Choose a chart type and click OK to save your changes.

You need a parameters item to configure report metrics and other settings in your chart. A parameters item is a subitem of the PageSettings item.

To add a parameters item:

  1. On the report page, right-click the PageSettings item and click Add - New Item.

    To find all available chart parameter controls, enter a search term beginning with experienceanalytics. You can see parameters items for each type of chart control. For example, if you are using the bar chart control, select the ExperienceAnalyticsBarChartParameters item.

  2. You can enter a name for your parameters item or accept the default name, then click OK.

  3. To configure the parameters item, double click the item to open it.

  4. In the parameters item, select a metric and add a segment to your chart.

  5. For example, to show conversions from all visits by country, select the following:

    • Metric = Conversions

    • Segment = All visits byCountry

  6. Save your changes.

If you do not bind the bar chart control to the parameters item, your report will not display any data.

To bind the ExperienceAnalyticsBarChart control to the parameters item:

  1. Right-click the report, click Task, Design Layout, and then double-click the chart item that you have created. For example, double click the ExperienceAnalyticsBarChart control.

  2. In the Edit Rendering Properties dialog box, in the Behavior section, in Data Source, browse to the location of the ExperienceAnalyticsBarChartParameters item in the content tree.

  3. Select the parameters item and click OK.

  4. Save your changes.

Your new chart needs a heading to describe the content that it displays.

To change a title label on a chart:

  1. Double-click the parameters item for your chart.

  2. In the parameters item, expand the Appearance section.

  3. In the Title field, enter the relevant title, for example, Conversions by country.

  4. Save your changes and view the chart in Experience Analytics.