Custom Insights

To plug your own data into a Dasheroo dashboard, all we need is a URL to retrieve it from.

Data URLs

The URL you provide while creating a custom insight is called the data URL. It must be a valid http or https URL.

Example Data URL

https://www.yourcompany.com/path/to/data.json

Data URL with Basic Auth

https://username:password@www.yourcompany.com/path/to/data.json

Response formats

The response format must correspond with the custom insight report type you selected.

Single Statistic with Histogram

{ my_statistic: { type: 'integer', value: 1, label: 'My Statistic' } }

Multiple Statistics with Histogram

{ my_statistic_1: { type: 'integer', value: 1, label: 'My Statistic 1', order: 0 } my_statistic_2: { type: 'percentage', value: 0.5, label: 'My Statistic 2', order: 1 } my_statistic_3: { type: 'percentage', value: 0.25, label: 'My Statistic 3', order: 2 } }

Data Strategies

A data strategy tells Dasheroo how to treat a statistic over time. There are two strategies:

  • continuous (default) - a rolling total (example: the size of a mailing list)
  • interval - resets to zero at the beginning of each day (example: new Facebook Fans)

If you don't provide a strategy, Dasheroo will assume it's continuous.

Setting a Data Strategy

{ my_statistic_1: { type: 'integer', value: 1, label: 'My Statistic 1', order: 0, strategy: 'continuous' } my_statistic_2: { type: 'integer', value: 0.5, label: 'My Statistic 2', order: 1, strategy: 'interval' } }

Supported value types

Statistics can be any of the following types:

  • integer
  • percentage
  • float