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-graph1.png ../../../_images/line-graph1.png
../../../_images/line-graph2.png ../../../_images/tabular-report.png

Configuring Brightspot Reports

Administrators perform this task.

If your version of Brightspot is missing any of the following configuration options, contact your Brightspot developer.

  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 configuration settings. For more information, see Understanding Site Hierarchy.

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

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

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

  5. 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.

Note

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

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.