Brightspot Reports

The Brightspot Reporting plugin powers the Report widget, a dashboard widget that displays administrator-defined metrics at the site level. You can generate reports in a variety of graphical and tabular formats, some of which are shown below. Included in all formats is the capability to download a report’s metrics to a CSV (Comma-Separated Values) file for additional processing.

../../../_images/area-filled-graph.png ../../../_images/line-graph1.png
../../../_images/line-graph2.png ../../../_images/tabular-report.png

Configuring Brightspot Reports

Administrators perform these tasks.

  1. From the Navigation Menu, select Admin > Sites & Settings.

  2. Select a site on which you want to report analytics. Select the Global site if you want all sites to inherit the Global setting for reporting. For more information, see site hierarchy.

  3. On the Plugins tab, under the “Feature Plugins” section, enable the Brightspot:Reporting:Core plugin and the Brightspot:Reporting:NVD3 plugin.

    Note

    The Brightspot:Reporting:NVD3 plugin provides several graphical options for representing data. If you do not enable this plugin, then your report options are limited to a tabular view of data.

  4. Click Save.

    In the dashboard configuration, an option is added for the Report widget.

  5. Create a custom dashboard that includes the Report widget.

    The following screenshot shows default configuration options for the Report widget.

    ../../../_images/reports-config.png
  6. Using the following tables as a reference, enter settings for the Report widget.

  7. Click Save.

Report Widget Options — Top-level Fields
Field Description
Heading Name of the report.

Reporter

The graphical or tabular representation of data in the report. The Values report shows total or average values based on the metrics set on the Supplier field. If you set Values, additional fields are displayed:

Display Name – Enter description for the Values report.

Formatter – Select As Is to display a cumulative total. Select Duration to display totals for hours and minutes.

Supplier

The data source for the report. You can set the following suppliers:

Content Volume – The number of content assets published over the last number of days specified, optionally segmented by content type or field. See Content Volume Setting for additional field descriptions.

Numbers Over Time – A selection of metrics over a specified time, such as page views. See Numbers Over Time Setting for additional field descriptions.

Traffic Source – The channels by which users arrive to a site. See Traffic Source Setting for additional field descriptions.

Supplier — Content Volume Setting
Field Description
Content Types The content types to track for publication. If you set Some Content Types, specify one or more types.
Number of Days The last number of days to report on.
Segmentation The type of segmentation, either content, field, or none. For field segmentation, enter the internal name of the field. For example, an internal name of a byline field might be authorable.byline.
Supplier — Numbers Over Time Setting
Field Description

Series

The metric to track. For the Page Views or Average Time on Page setting, an Aggregate field displays. Use this field to categorize data:

By Content Types – Show by content type, like Article.

By Content – Show by content asset, like a published instance of the Article type.

All – Do not categorize data.

The Visits or the Unique Visits setting shows the total number of site visits over time. Whereas the Visits metric includes repeat visits by the same users, the Unique Visits metric counts only one visit per user.

Period

Unit of time. You can specify a time period as an amount of past hours, days, months, or years. For example, choosing Past Days and amount of 2 results in a report for the past two days.

Alternatively, you can set a day, hour, month, or year and an offset that indicates how far back from the present unit of time that you want to look. For example, choosing a period of Set Month and offset of 2 results in a report for the past two months.

Supplier — Traffic Source Setting
Field Description

Channels

Traffic sources, showing how users arrive to your site. You can set one or more of the following sources:

Direct – A user typed the URL in the browser.

Email – A user clicked a link from an email. Links from email channels are expected to use request parameter “ch” to be recognized, for example, http://www.perfectsensedigital.com/?ch=email.

Referral – A user arrived via a link from another site.

Search – A user arrived via a search engine. Brightspot tracks the Google, Bing, and Yahoo search engines by default.

Social – A user arrived from a social network. Brightspot tracks the Twitter, Facebook, LinkedIn, and YouTube social networks by default.

Note: With the Brightspot Analytics plugin, you can override the default social and search sites that are tracked. See Configuring Brightspot Analytics for more information.

Period

Unit of time. You can specify a time period as an amount of past hours, days, months, or years. For example, choosing Past Days and amount of 2 results in a report for the past two days.

Alternatively, you can set a day, hour, month, or year and an offset that indicates how far back from the present unit of time that you want to look. For example, choosing a period of Set Month and offset of 2 results in a report for the past two months.