Plugging your own data into a Dasheroo dashboard is simple with our Custom Insight Webhook. All we need is URL with a JSON formatted response to retrieve it from.
Here's how to get started.
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 Authentication
https://username:password@www.yourcompany.com/path/to/data.json
Data Strategies & Value Types
A data strategy tells Dasheroo how to treat a statistic over time. There are two strategies we support:
- 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.
A Value type tells Dasheroo what type of metric to expect. There are three value types support:
- integer
- percentage
- float
Setting a Data Strategy & Value Types
{ "my_statistic_1": { "type": "integer", "strategy": "continuous", "value": 1, "label": "My Statistic 1", "order": 0 }, "my_statistic_2": { "type": "float", "strategy": "interval", "value": 0.5, "label": "My Statistic 2", "order": 1, } }
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 } }